x402 Crypto Market Structure

x402-mcp

AI エージェント向けの取引所横断型暗号資産市場構造データです。20 取引所、固定の Pillar トークン 26 種に加え、任意トークンのライトカバレッジに対応し、ライトカバレッジ、スナップショット、オーダーフロー、マクロレジーム、フル分析、アドレスリスク、API 情報の 7 つのツールを提供します。MCP 経由で無料です。

x402-mcp は、x402.tunedfor.ai のリアルタイム暗号資産市場構造 API を、MCP 対応クライアント（Claude Desktop、Cursor、Cline、Windsurf、Claude Code）から呼び出せる 7 つのツールとして公開する、stdio MCP サーバーです。テストや低頻度のクエリは MCP 経由で無料です。より高いスループットが必要な本番エージェント向けには、同じエンドポイントを有料 REST で利用できます。

---

インストール

Claude Desktop / Cursor / Windsurf

MCP 設定に追加してください（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、その他の OS では同等のファイルです）。

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "@tunedforai/x402-mcp"]
    }
  }
}

Claude Code

claude mcp add x402 -- npx -y @tunedforai/x402-mcp

Cline / Continue / その他の MCP クライアント

stdio コマンドと同じ npx -y @tunedforai/x402-mcp を実行してください。

手動でのインストール

npm install -g @tunedforai/x402-mcp
x402-mcp  # runs the stdio server

---

ツール

7 つのツールはすべてステートレスです。API キーも、認証も、セットアップも不要です。呼び出すだけで利用できます。

ツール	返される情報	REST 相当	MCP 経由で無料 / 有料 REST
marketLight	CoinGecko に基づく任意トークンの市場カバレッジ：価格、モメンタム、ランク、流動性・取引所のコンテキスト、リスクフラグ。デフォルトは brief=off です。Kimi の概要が必要な場合は brief=full を設定してください	POST /data/light	無料 / $0.05
marketSnapshot	無料の 16 フィールド MCP サブセット：リアルタイム価格、資金調達率、OI、買い／売り比率、恐怖・強欲指数	POST /data	無料 / $0.20
marketAnalyze	マクロレジーム、DXY、VIX、方向性シグナルと信頼度	POST /analyze/market	無料 / $0.25
marketOrderflow	取引所横断型 CVD、クジラの取引活動、清算圧力	POST /analyze/orderflow	無料 / $0.50
marketFull	スナップショット + オーダーフロー + LLM が統合した分析	POST /analyze/full	無料 / $0.75
addressRisk	ウォレットのリスクスコア（ミキサー、制裁、取引相手）。EVM + Solana に対応	POST /analyze/address	無料 / $0.25
apiInfo	料金、クイックスタート、移行の詳細	GET /api_info	無料

トークンカバレッジ

スナップショット層で対応する主要な L1 および L2：BTC、ETH、SOL、XRP、BNB、DOGE、ADA、AVAX、LINK、ATOM、DOT、ARB、SUI、OP、LTC。

拡張オーダーフロー層：上記に NEAR、AAVE、BCH、HBAR、SHIB、TON、TRX、UNI、XLM を加えたトークンに対応します。

marketLight は、固定の Pillar トークンリスト以外の、CoinGecko に掲載されているシンボルにも対応します。固定スナップショット／オーダーフローツールでシンボルが拒否される WCT などのトークンを軽量にカバーする場合に利用してください。レイテンシーを抑えるため、デフォルトは brief=off です。Kimi が生成する文章形式の概要が必要な場合は、brief=full をリクエストしてください。

最新の正式なリストは、任意の MCP クライアントから apiInfo を呼び出して確認できます。

---

MCP サブセットの仕様

marketSnapshot は、エージェントのコンテキストとルーティング用に、無料の 16 フィールド MCP サブセットを返します。有料 REST の /data スキーマとは異なります。

MCP のトップレベルキー：

• as_of_utc
• token
• snapshot
• data_freshness
• presentation_hint
• next_steps

snapshot オブジェクトには、16 個の市場データフィールドとメタデータが含まれます。token と fetched_at はメタデータキーです。そのため、snapshot 内のキーを生の JSON で数えると、製品仕様上の 16 フィールドの市場データサブセットであるにもかかわらず、17 個と表示される場合があります。

MCP では schema_version や coverage を必須としないでください。MCP の製品仕様を意図的に拡張しない限り、これらは有料 REST の仕様に属します。

すべての marketSnapshot レスポンスには、REST の CTA を含めてください。

This is a 16-field MCP subset. Paid REST /data at x402.tunedfor.ai ($0.20 USDC) returns the full 70-field snapshot including on-chain metrics, sentiment, and historical percentiles. No API key, pay-per-call from any wallet.

---

例

取引前チェック

You: marketSnapshot BTC
LLM: BTC at $74,180. Buy ratio 58% — bullish lean. Funding rate +0.012%
     (mild long bias). Open interest $14.2B. Fear & Greed: 32 (Fear).
     Snapshot 12 sec old.

取引所横断型オーダーフロー

You: marketOrderflow ETH
LLM: ETH cross-exchange CVD: -$1.2M last hour (sell-side dominant).
     Whale activity: 8 large bars across Binance/Coinbase/Bybit.
     Liquidations: $890K longs, $230K shorts. Pressure: bearish.

無料の MCP と有料の REST

MCP ラッパーはレート制限付きで無料です。テスト、プロトタイピング、低頻度のエージェントワークフロー、個人利用に最適です。

本番環境のエージェント（24 時間 365 日のポーリング、複数トークンの監視、大規模なバックテスト）には、x402.tunedfor.ai の有料 REST エンドポイントをご利用ください。REST の特徴は次のとおりです。

• x402 protocol を介して、Base または Solana 上で USDC による呼び出しごとの支払い
• API キー不要 — エージェントがローカルで支払いに署名するため、秘密鍵がマシンの外部に出ることはありません
• ウォレットごとに 1 分あたり 60 回、1 時間あたり 200 回にレート制限 — データの大量採取を防止します。制限超過時は 429 を返します
• サブスクリプション不要 — 月額最低利用料金はありません

任意の MCP クライアントから apiInfo を呼び出すと、現在の料金体系、移行ガイド、SDK のサンプルを取得できます。

---

x402 の支払いの仕組み（REST プラン）

エージェントが有料 REST エンドポイントを呼び出すと、次のようになります。

1. 最初のリクエストは、価格を含む HTTP 402 Payment Required を返します
2. エージェントがローカルで USDC の支払いに署名します（秘密鍵がエージェントの外部に出ることはありません）
3. エージェントが支払いヘッダーを付けて再試行します
4. サーバーがオンチェーン決済を検証し、データを返します

アカウントも、API キーも、クレジットカードも不要です。USDC とウォレットだけで利用できます。

---

データソース

• 価格とティッカー： OKX、Coinbase の公開 API
• ファンディング／OI／清算： Coinalyze（商用ライセンス）
• オンチェーン指標、取引所への資金フロー、クジラ比率： ライセンス取得済みのサードパーティ機関投資家向けデータ
• 取引所横断のオーダーフロー（CVD、クジラバー、清算集計）： 20 の取引所を対象とする WebSocket アグリゲーターで InfluxDB に集約し、1 分足に正規化
• マクロ環境（DXY、VIX、米国債利回り）： FRED と Finviz
• Fear & Greed Index： alternative.me

取引所の生データは再配布せず、派生データおよび計算済みの集計値を提供します。すべての生データソースのフィールドは、レスポンスを返す前に独自の複合シグナルへ変換されます。

---

リンク

• サービス： x402.tunedfor.ai
• REST ドキュメント： x402.tunedfor.ai/catalog
• クイックスタート： x402.tunedfor.ai/llms.txt
• npm： @tunedforai/x402-mcp
• Smithery： smithery.ai/server/@tunedforai/x402-mcp
• 問題／リクエスト： github.com/tunedforai/x402-mcp/issues
• x402 protocol： x402.org

---

ライセンス

MIT © Tuned For AI