Macaroon Network

macaroonnetwork-mcp

Macaroon Network の MCP 検索ルーターです。エージェントがエビデンスに基づく製品を見つけ、クエリの成功ごとに料金を支払うマーケットプレイスです。

このリリースで提供される決済レールは、Base メインネット上の USDC を使用する x402 です。このパッケージがウォレットを保持したり、決済に署名したりすることはありません。呼び出し元が自身のウォレットインフラストラクチャで署名できるよう、正確な x402 チャレンジを返し、再試行時に署名済みの証明を受け付けます。

ツール

• macaroons_search — 自然言語の意図で販売可能な製品を検索します。無料です。
• macaroons_metadata — フィードの対象に関する鮮度とコンテンツハッシュのメタデータを無料で取得します。
• macaroons_categories — 正規のカテゴリー一覧と、正確にマッピングされた製品数を取得します。無料です。
• macaroons_discover_mcp — エビデンスが確認された稼働中の Macaroon MCP サーバーとそのトランスポートを取得します。無料です。
• macaroons_sources — 審査済みのソースと権利に関する記録を取得します。対象範囲が一部に限られる場合は明示します。無料です。
• macaroons_execute — x402 による USDC 決済で製品を実行し、述語検証済みの結果とレシートを受け取ります。

x402 での支払い

製品の利用に支払いが必要な場合、macaroons_execute はチャレンジを隠さず、x402_payment_required の結果を返します。

{
  "x402_payment_required": true,
  "resource_url": "https://api.macaroonnetwork.com/execute/...",
  "amount_atomic": "3000",
  "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "network": "eip155:8453",
  "pay_to": "0x33cc...",
  "extra_name": "USD Coin",
  "extra_version": "2",
  "max_timeout_seconds": 60,
  "x402_version": 2
}

チャレンジに記載された正確な決済内容に、自身のウォレットまたは Coinbase CDP インフラストラクチャで署名してください。その後、同一の引数に payment_signature を追加して、もう一度 macaroons_execute を呼び出します。x402 の正確な決済には署名済みの再試行を 1 回行います。請求書のポーリングによるフローはありません。

インストール

pip install macaroonnetwork-mcp

MCP クライアントでの使用

{
  "mcpServers": {
    "macaroonnetwork": {
      "command": "macaroonnetwork-mcp"
    }
  }
}

デフォルトのレジストリは https://api.macaroonnetwork.com です。ローカル開発では、MACAROONS_REGISTRY_URL で上書きできます。

ライセンス

MIT