{
  "markdown": "# negotiate-mcp\n\n[![PyPI](https://img.shields.io/pypi/v/negotiate-mcp.svg)](https://pypi.org/project/negotiate-mcp/)\n\nModel Context Protocol (MCP) server for the **[negotiate.v1](https://github.com/sanjana-pier39/pier39-skills/blob/main/PROTOCOL.md)** 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.\n\n## What you get\n\n| Tool | Purpose |\n| --- | --- |\n| `discover_store(domain)` | Probe a domain to check if it's negotiable. Returns the protocol descriptor. |\n| `list_products(domain)` | Enumerate negotiable products at the store. |\n| `start_negotiation(domain, product_id)` | Open a chat session with the merchant agent. |\n| `send_message(next_url, message)` | Send one shopper turn. |\n| `read_history(history_url)` | Read the running history of a session. |\n\nThe 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.\n\nmcp-name: io.github.sanjana-pier39/negotiate-mcp\n\n## Install\n\nThe recommended path uses [uv](https://github.com/astral-sh/uv) — no virtualenv plumbing, picks the right Python automatically.\n\n```bash\n# install uv if you don't have it (macOS):\nbrew install uv\n\n# then point Claude Desktop / Cowork / Claude Code at it (see below).\n# uvx will install the package the first time it's invoked.\n```\n\nIf you'd rather use plain pip:\n\n```bash\npip install negotiate-mcp\n```\n\n## Wire it into Claude Desktop\n\n1. Open your Claude Desktop config:\n   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n2. Add this entry under `mcpServers` (creating the file if it doesn't exist):\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"negotiate-agent\": {\n         \"command\": \"uvx\",\n         \"args\": [\"negotiate-mcp\"]\n       }\n     }\n   }\n   ```\n\n   See [`claude_desktop_config.example.json`](./claude_desktop_config.example.json).\n\n3. Quit and re-open Claude Desktop. The five tools should appear in any new conversation.\n\nIf you installed with plain `pip` instead of `uv`, replace the command/args block with:\n\n```json\n\"command\": \"negotiate-mcp\",\n\"args\": []\n```\n\n## Wire it into Cowork or Claude Code\n\nSame `negotiate-mcp` command. Add it to the corresponding MCP config in those clients (consult their docs for exact paths). The tool surface is identical.\n\n## Try it\n\nOnce installed, in a fresh chat:\n\n> Negotiate for a Dyson HP07 at negotiate.pier39.ai. Try to get it under $500. Bonus points for the engraved gift box.\n\nClaude 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.\n\n## Test standalone (no Claude required)\n\n```bash\n# Run the server on stdio:\nuvx negotiate-mcp\n\n# Or, if you've used pip:\npython -m negotiate_mcp\n```\n\nMost useful when paired with the [`mcp` CLI](https://github.com/modelcontextprotocol/inspector) to inspect tool definitions and exercise them by hand.\n\n## Adding more stores\n\nThe 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.\n\nSee [PROTOCOL.md](https://github.com/sanjana-pier39/pier39-skills/blob/main/PROTOCOL.md) for the full spec.\n\n## Develop locally\n\n```bash\ngit clone https://github.com/sanjana-pier39/negotiate-mcp\ncd negotiate-mcp\npip install -e .\npython -m negotiate_mcp     # runs on stdio\n```\n\nTo publish a new version, see [`PUBLISH.md`](./PUBLISH.md).\n\n## License\n\nMIT.\n",
  "bytes": 3760,
  "sha": "3f68480eeb14fd46d965ff95159ac24096b8fef76d9b1eed679342e007cc5ec5",
  "repo_slug": "sanjana-pier39/negotiate-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sanjana_pier39_negotiate_mcp_42639461/readme"
}