a2a-x402-mcp-services

本番運用向け x402 v2 収益化 MCP ツール。実際のエージェント間（A2A）取引を実現する本物のツールです。

• 本物のオンチェーン決済（モックや、偽の支払いは一切なし）

• 現在の x402 v2 仕様に完全準拠（CAIP-2 ネットワーク、PAYMENT-REQUIRED / PAYMENT-SIGNATURE / PAYMENT-RESPONSE ヘッダー、x402Version: 2、exact スキーム）

• 公式の @x402/mcp + @x402/core + @x402/evm パッケージ

• Bazaar 対応（Bazaar 拡張を実装するファシリテーターを介してツールを検出可能）

• 現在のエコシステムのギャップに合わせて構築：エージェントが実際に再購入する運用ユーティリティ

現在の有料ツール

すべてのツールは exact な支払いスキームを使用し、実際のファシリテーターを通じて決済されます。

Related MCP server: Agent Commerce Suite

x402 v2 準拠チェックリスト

• x402Version: 2

• CAIP-2 ネットワーク識別子（eip155:84532（Base Sepolia デフォルト）、eip155:8453（mainnet 用））

• 公式ヘッダー（PAYMENT-REQUIRED、PAYMENT-SIGNATURE、PAYMENT-RESPONSE）

• @x402/evm/exact による exact スキーム

• ファシリテーターによる検証と決済（プロセス内での自己決済は行わない）

• MCP ツール発見のための Bazaar 拡張メタデータ

• 環境変数駆動の payTo アドレス（本番ウォレットのハードコードなし）

クイックスタート（テストネット）

git clone https://github.com/Disseveru/a2a-x402-mcp-services.git
cd a2a-x402-mcp-services
npm install

# Required: receiving wallet (Base Sepolia)
export X402_PAY_TO_EVM=0xYourTestnetAddress

# Optional overrides
# export X402_NETWORK=eip155:84532
# export X402_FACILITATOR_URL=https://x402.org/facilitator
# export PORT=4022

npm run dev

ヘルスチェック（無料）：

curl http://localhost:4022/health

ツールカタログ（無料）：

curl http://localhost:4022/tools

MCP エンドポイント（有料）：

POST http://localhost:4022/mcp

x402 v2 対応の MCP クライアント（@x402/mcp クライアントヘルパー、CDP 管理のウォレットなど）を使用してください。有料ツールへの最初の呼び出しでは 402 が返され、クライアントが署名して PAYMENT-SIGNATURE 付きで再試行し、ファシリテーターが決済し、ツールの結果が返されます。

メインネットへの移行

1. メインネットの受取アドレスを設定する：

   export X402_PAY_TO_EVM=0xYourMainnetAddress

2. ネットワークを切り替える：

   export X402_NETWORK=eip155:8453

3. 本番用ファシリテーターを使う（例 – CDP）：

   export X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402

   （選択したファシリテーターが要求する場合、CDP の認証情報を提供してくだう。）

4. サーバーを起動する。実際の USDC が移動します。

失っても構わない額を超える資金を保持したホットキーでメインネットを実行しないでください。

アーキテクチャ

src/
  config.ts          – env-driven CAIP-2 + facilitator + payTo
  server.ts          – McpServer + official createPaymentWrapper (@x402/mcp)
  tools/
    definitions.ts   – paid tool implementations (real logic)
  index.ts           – Express host + Streamable HTTP MCP transport

設計原則

1. モックなし – 有料パス・はすべて、実際のファシリテーターの決済で完了します。

2. v2 のみ – 従来の X-PAYMENT ヘッダーや v1 ネットワーク文字列は使いません。

3. 運用ユーティリティ – エージェントが繰り返し購入する問題（リスク評価、正規化、ファシリテーター選抜）を解決するツールです。

4. 発見可能 – エージェントが URL をハードコードせずにツールを見つけられるよう、Bazaar メタデータを提供します。

5. 運用者の安全性 – 受取アドレスとネットワークは環境変数のみから取得します。

ライセンス

--MIT