negotiate-mcp

negotiate-mcp

negotiate.v1 プロトコル用の Model Context Protocol（MCP）サーバーです。Claude Desktop、Cowork、Claude Code、またはその他の MCP 対応クライアントにインストールすると、Claude は negotiate.v1 準拠のあらゆる店舗と交渉するためのネイティブツールを5つ使えるようになります。

利用できる機能

ツール	目的
discover_store(domain)	ドメインを調べ、交渉可能かどうかを確認します。プロトコル記述子を返します。
list_products(domain)	店舗で交渉可能な商品を列挙します。
start_negotiation(domain, product_id)	販売者エージェントとのチャットセッションを開始します。
send_message(next_url, message)	購入者のターンを1回送信します。
read_history(history_url)	セッションの進行中の履歴を読み取ります。

エージェントはブラウザーを使う人間と同じようにこれらを使います。店舗を見つけ、商品を選び、チャットを始め、取引が成立するまでメッセージを送ります。

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

インストール

推奨する方法は uv を使うことです。仮想環境の設定は不要で、適切な Python が自動的に選ばれます。

# 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.

通常の pip を使う場合は、次のようにします。

pip install negotiate-mcp

Claude Desktop に接続する

1. Claude Desktop の設定ファイルを開きます。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. mcpServers の下に次の項目を追加します（ファイルがない場合は作成してください）。

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

   claude_desktop_config.example.json も参照してください。

3. Claude Desktop を終了して、再度開きます。新しい会話で5つのツールが表示されます。

uv ではなく通常の pip でインストールした場合は、command/args ブロックを次の内容に置き換えてください。

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

Cowork または Claude Code に接続する

同じ negotiate-mcp コマンドを使います。各クライアントの対応する MCP 設定に追加してください（正確なパスは各クライアントのドキュメントを参照してください）。利用できるツールは同じです。

試してみる

インストール後、新しいチャットで次のように入力します。

negotiate.pier39.ai で Dyson HP07 の交渉をしてください。500ドル未満を目指してください。刻印入りのギフトボックスも付けてもらえれば、なおよいです。

Claude は discover_store("negotiate.pier39.ai") を呼び出して商品一覧から HP07 を見つけ、start_negotiation を呼び出します。その後、closed: true になるまで send_message で会話を進めます。特別なプロンプトの工夫は必要ありません。

単独でテストする（Claude 不要）

# Run the server on stdio:
uvx negotiate-mcp

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

ツールの定義を確認し、手動で試すには、mcp CLI と組み合わせるのが特に便利です。

対応店舗を追加する

このコネクターは Atlas のリファレンス実装（negotiate.pier39.ai）だけでなく、negotiate.v1 に準拠するあらゆる店舗で動作します。店舗がプロトコルを採用したら、購入者エージェントの接続先としてそのドメインを指定するだけです。同じ5つのツールがどこでも使えます。

仕様の全文は PROTOCOL.md を参照してください。

ローカルで開発する

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

新しいバージョンの公開方法については、PUBLISH.md を参照してください。

ライセンス

MIT。