x402-mcp

@carbon-cashmere/x402-mcp

AI エージェントに Carbon & Cashmere's の177種類の暗号資産市場インテリジェンスエンドポイントを公開する MCP サーバーです。ウォレットから x402 USDC マイクロペイメントを自動で実行します。

利用できる機能

この MCP をインストールすると、AI エージェントは次のようなツールを呼び出せます。

• get_v1_news — センチメントと市場への影響を分析した暗号資産ニュース
• get_v1_stablecoins — 時価総額合計、コインごとの供給量、チェーン別の分布
• get_v1_onchain_btc — Bitcoin のオンチェーン指標（ハッシュレート、メンプール、マイナーの資金フロー）
• get_v1_bittensor_leaderboard — 排出量による Bittensor マイナーの上位100件
• get_v1_mantis_realized_accuracy — MANTIS サブネット（UID 253）の実績精度記録
• get_v1_intel_snapshot — 市場インテリジェンスの集約スナップショット
• … さらに、サブスクリプション（$10/日、$50/週、$200/月）、スポンサー向けティア（$500～$50000）、1回あたり $0.003～$0.50 の170以上のリサーチエンドポイントを利用できます。

有料エンドポイントは合計177種類です。 デフォルトでは、収益と人気度を基準に厳選した上位100件を公開します。コインごとのバリエーションを含むすべてのエンドポイントを公開するには、X402_TOOL_LIMIT=177 を設定してください。

ツールを呼び出すたびに、設定済みのウォレットから USDC のマイクロペイメントが1回行われます。サブスクリプションも API キーも不要です。利用した分だけお支払いください。

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "carbon-cashmere": {
      "command": "npx",
      "args": ["-y", "@carbon-cashmere/x402-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x_your_evm_private_key_here",
        "SVM_PRIVATE_KEY": "your_base58_solana_private_key_here_optional"
      }
    }
  }
}

Claude Desktop を再起動します。収益と人気度を基準に厳選した Carbon & Cashmere の上位100種類のツールが、ツールパレットに表示されます。

Cursor / Cline / Continue

同じ JSON 設定を MCP 設定パネルに貼り付けます。

ウォレットの設定

セキュリティ：メインウォレットではなく、支払い専用ウォレットを使用してください。 EVM_PRIVATE_KEY は Claude Desktop の設定ファイルに平文で保存されます。 ホスト上でこのファイルを読み取れるプロセスは、キーを取得できます。失っても構わない ホットウォレットとして扱い、使う予定の少額（USDCで$10～$50）のみを入金してください。 メインの資産は絶対に入金しないでください。

• EVM_PRIVATE_KEY（Base / Polygon / Arbitrum / World / Avalanche での支払いに必須）
  • 0x で始まる16進文字列（例：0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80）
  • Base メインネットで USDC を入金します（最も安価で高速。呼び出し1回あたりのガス代は約$0.0001）
  • 初回の入金額：約$10 USDC で200回以上のツール呼び出しが可能です
  • 上限はウォレット残高です。 エージェントが制御不能なループに陥っても、入金額を超えて使うことはありません。署名額はチェーン上で利用可能な USDC の範囲内に制限されます。
• SVM_PRIVATE_KEY（任意。Solana での支払いに使用）
  • base58 でエンコードされた Solana キーペアのバイト列
  • Solana 専用の経路を使うツールにのみ必要です

ネットワークの許可リスト。 MCP サーバーは、API の 402 レスポンスに含まれる accepts[] 配列に記載されたネットワーク（現在は Base、Polygon、Arbitrum、World Chain、Solana、Algorand、Stellar）への支払いにのみ署名します。 それ以外のチェーンにルーティングされたリクエストは署名レイヤーで拒否されるため、任意のネットワークへの署名にキーを悪用されることはありません。

キーがマシンの外部に送信されることはありません。 キーは Claude Desktop の設定ファイルと、ローカルで実行される MCP プロセス内にのみ保存されます。支払いの署名はデバイス上で行われ、署名済みの EIP-712 / SIWS ペイロードのみが Carbon & Cashmere に送信されます。

検出専用モード（キー未設定）

EVM_PRIVATE_KEY と SVM_PRIVATE_KEY のどちらも設定せずに MCP サーバーを起動すると、検出専用モードで実行されます。ツールの登録と無料エンドポイントは利用できますが、有料ツールを呼び出すとエージェントに 402 エラーが返されます。ツールカタログの評価、MCP マーケットプレイスのイントロスペクション（Glama、npm スクレイパー）、ウォレットに入金せず CI／テスト環境で実行する場合に便利です。

仕組み

Claude Desktop          @carbon-cashmere/x402-mcp        api.carbon-cashmere.de
     |                          (your machine)                 (our server)
     |  call get_v1_news        |                                 |
     |------------------------->|  GET /v1/news                   |
     |                          |-------------------------------->|
     |                          |  402 + PAYMENT-REQUIRED         |
     |                          |<--------------------------------|
     |                          |  sign with EVM_PRIVATE_KEY      |
     |                          |  GET /v1/news + PAYMENT-SIG     |
     |                          |-------------------------------->|
     |                          |  200 OK + data                  |
     |                          |<--------------------------------|
     |  formatted data          |                                 |
     |<-------------------------|                                 |

公式の Coinbase x402 v2 プロトコルを基盤としています。決済は Base 上の USDC（または選択したチェーン）で行われます。通常のレイテンシは呼び出し1回あたり約2～3秒です（1回の支払いとデータ取得を含む）。

ツール数

デフォルトでは、上位 100 件のツールが公開されます。実際の決済量、USD 収益、探索の重み付け、説明の品質を組み合わせたスコアに基づき、サーバー側で厳選されています（npm の再公開を行わなくても、カタログのランキングは更新されます）。

X402_TOOL_LIMIT	公開される内容
50	最小限の構成 — 上位の無料ツールとバンドルに加え、収益性の高いエンドポイントをいくつか
100（デフォルト）	高収益層 — $10～$50 のサブスクリプション、スポンサー層、週次／日次レポート、オンチェーンバンドルを追加
177	すべて — コイン別の専用ルート（vol-regime/{coin}、hurst/{coin}、trend/{coin}、…）を追加します。エージェントが照会するコインを把握している場合にのみ推奨します。

上書きするには：

"env": {
  "X402_TOOL_LIMIT": "177"
}

デフォルトで上限を設ける理由：MCP ツールが多すぎると、エージェントのツール選択精度が低下する場合があります。Claude 3.5 Sonnet 以降では、実測上 100 が最適な数です。

環境設定

変数	必須	デフォルト	説明
EVM_PRIVATE_KEY	いずれか 1 つ	—	Base／Polygon／Arbitrum 用の 0x で始まる EVM キー
SVM_PRIVATE_KEY	いずれか 1 つ	—	base58 形式の Solana キーペア
X402_API_BASE	いいえ	https://api.carbon-cashmere.de	API のベース URL
X402_TOOL_LIMIT	いいえ	100	公開するツールの最大数（1～177）
X402_LOG_LEVEL	いいえ	info	debug | info | warn | error

セキュリティ

• キーがマシンの外に出ることはありません。 MCP サーバーは Claude Desktop の子プロセスとしてローカルで実行されます。
• 従量課金の上限があります。 1 回の呼び出しにつき $0.003～$0.50 です。ループが暴走しても、ウォレットの残高によって上限が決まります。
• オフチェーンの認証情報は不要です。 API キーも OAuth も不要です。純粋なオンチェーン決済です。
• オープンソースです。 コードを自分で監査できます：github.com/CarbonCashmere/x402-mcp

ライセンス

MIT — LICENSE をご覧ください。

リンク

• Carbon & Cashmere API：https://api.carbon-cashmere.de
• x402 プロトコル：https://github.com/coinbase/x402
• MCP プロトコル：https://modelcontextprotocol.io