English Français العربية

io.github.sanjana-pier39/negotiate-mcp

Official registry E-commerce

Negotiate prices at any negotiate.v1 store. AI shopper tools for Claude.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package negotiate-mcp
Claude Code 
claude mcp add negotiate-mcp -- uvx negotiate-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "negotiate-mcp": {
            "command": "uvx",
            "args": [
                "negotiate-mcp==0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. negotiate-mcp
  2. What you get
  3. Install
  4. Wire it into Claude Desktop
  5. Wire it into Cowork or Claude Code
  6. Try it
  7. Test standalone (no Claude required)
  8. Adding more stores
  9. Develop locally
  10. License

negotiate-mcp

Model Context Protocol (MCP) server for the negotiate.v1 protocol. Once installed in Claude Desktop, Cowork, Claude Code, or any other MCP-aware client, your Claude gains five native tools for negotiating with any negotiate.v1-compliant store.

What you get

ToolPurpose
discover_store(domain)Probe a domain to check if it's negotiable. Returns the protocol descriptor.
list_products(domain)Enumerate negotiable products at the store.
start_negotiation(domain, product_id)Open a chat session with the merchant agent.
send_message(next_url, message)Send one shopper turn.
read_history(history_url)Read the running history of a session.

The agent uses these like a human would use a browser: discover the store, pick a product, start a chat, send turns until the deal closes.

mcp-name: io.github.sanjana-pier39/negotiate-mcp

Install

The recommended path uses uv — no virtualenv plumbing, picks the right Python automatically.

# install uv if you don't have it (macOS):
brew install uv

# then point Claude Desktop / Cowork / Claude Code at it (see below).
# uvx will install the package the first time it's invoked.

If you'd rather use plain pip:

pip install negotiate-mcp

Wire it into Claude Desktop

  1. Open your Claude Desktop config:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add this entry under mcpServers (creating the file if it doesn't exist):

     {
   "mcpServers": {
     "negotiate-agent": {
       "command": "uvx",
       "args": ["negotiate-mcp"]
     }
   }
 }

    See claude_desktop_config.example.json.

  3. Quit and re-open Claude Desktop. The five tools should appear in any new conversation.

If you installed with plain pip instead of uv, replace the command/args block with:

"command": "negotiate-mcp",
"args": []

Wire it into Cowork or Claude Code

Same negotiate-mcp command. Add it to the corresponding MCP config in those clients (consult their docs for exact paths). The tool surface is identical.

Try it

Once installed, in a fresh chat:

Negotiate for a Dyson HP07 at negotiate.pier39.ai. Try to get it under $500. Bonus points for the engraved gift box.

Claude will call discover_store("negotiate.pier39.ai"), find the HP07 in the product list, call start_negotiation, then drive the conversation through send_message until closed: true. No prompt acrobatics needed.

Test standalone (no Claude required)

# Run the server on stdio:
uvx negotiate-mcp

# Or, if you've used pip:
python -m negotiate_mcp

Most useful when paired with the mcp CLI to inspect tool definitions and exercise them by hand.

Adding more stores

The connector works against any negotiate.v1-compliant store, not just the Atlas reference (negotiate.pier39.ai). As stores adopt the protocol, just point your shopper agent at their domain — the same five tools work everywhere.

See PROTOCOL.md for the full spec.

Develop locally

git clone https://github.com/sanjana-pier39/negotiate-mcp
cd negotiate-mcp
pip install -e .
python -m negotiate_mcp     # runs on stdio

To publish a new version, see PUBLISH.md.

License

MIT.

Frequently asked questions

What is io.github.sanjana-pier39/negotiate-mcp?

Negotiate prices at any negotiate.v1 store. AI shopper tools for Claude.

How do I install io.github.sanjana-pier39/negotiate-mcp?

It runs on your machine. In Claude Code: claude mcp add negotiate-mcp -- uvx negotiate-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.sanjana-pier39/negotiate-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.sanjana-pier39/negotiate-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.sanjana-pier39/negotiate-mcp?

It is published by sanjana-pier39. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.