English Français العربية

io.github.sanjana-pier39/negotiate-mcp

السجل الرسمي التجارة الإلكترونية

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو io.github.sanjana-pier39/negotiate-mcp؟

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

كيف أثبّت io.github.sanjana-pier39/negotiate-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add negotiate-mcp -- uvx negotiate-mcp==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.sanjana-pier39/negotiate-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.sanjana-pier39/negotiate-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.sanjana-pier39/negotiate-mcp؟

ينشره sanjana-pier39. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.