x402-mcp

Name: x402 crypto market structure
Author: tunedforai

AIエージェント向けのクロス取引所暗号資産市場構造。20の取引所、26のトークン、9つのツール（オーダーフロー、CVD、クジラの動き、資金調達率/OI、7年分のOHLCV、オンチェーンアドレスリスク）。MCP経由で無料。

npm version License: MIT

x402-mcp は、x402.tunedfor.ai（リアルタイム暗号資産市場構造API）を、MCP互換クライアント（Claude Desktop、Cursor、Cline、Windsurf、Claude Code）から呼び出せる9つのツールとして公開する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

ツール

9つのツールはすべてステートレスです。APIキー、認証、設定は不要です。そのまま呼び出してください。

ツール	返される内容	REST相当	MCP無料 / REST有料
`marketSnapshot`	ライブ価格、資金調達率、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
`history1h`	売買フロー分割付きの1時間足OHLCV。最大5,000本、7年分の履歴	`POST /data/history/1h`	無料 / $5.00
`history1d`	売買フロー分割付きの日足OHLCV。最大5,000本、7年分の履歴	`POST /data/history/1d`	無料 / $5.00
`history5m`	5分足OHLCV。高解像度イントラデイ	`POST /data/history/5m`	無料 / $1.00
`apiInfo`	料金、クイックスタート、移行の詳細	`GET /api_info`	無料

トークン対応状況

スナップショット階層 (17トークン): BTC, ETH, SOL, XRP, BNB, DOGE, ADA, AVAX, LINK, ATOM, DOT, ARB, SUI, OP, LTC, AMP, ZEC
オーダーフロー + 履歴階層 (26トークン): 上記すべて + NEAR, AAVE, BCH, HBAR, SHIB, TON, TRX, UNI, XLM

使用例

取引前のチェック

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.

バックテストデータ

You: history1d BTC limit=365
LLM: [returns 365 daily bars: open/high/low/close/volume/buy_volume/sell_volume]

無料MCP vs 有料REST

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

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

x402プロトコルを介して、BaseまたはSolana上のUSDCでコール単位の支払い
APIキー不要 — エージェントがローカルで支払いに署名するため、秘密鍵がマシンから出ることはありません
レート制限なし — 使用した分だけ支払い
サブスクリプションなし — 月額最低料金なし

MCPクライアントから apiInfo を呼び出すと、現在の料金体系、移行ガイド、SDKの例を確認できます。

x402の支払い仕組み（REST階層）

エージェントが有料RESTエンドポイントを呼び出すと：

最初の要求で、価格とともに HTTP 402 Payment Required が返されます
エージェントがローカルでUSDC支払いに署名します（秘密鍵はエージェントから離れません）
エージェントが支払いヘッダーを付加して再試行します
サーバーがオンチェーン決済を確認し、データを返します

アカウント、APIキー、クレジットカードは不要です。USDCとウォレットがあれば利用可能です。

データソース

価格 + ティッカー: OKX、Coinbase公開API
資金調達率 / OI / 清算: Coinalyze (商用ライセンス)
オンチェーン指標、取引所フロー、クジラ比率: Santiment (商用ライセンス)
クロス取引所オーダーフロー (CVD、クジラバー、清算集計): 20の取引所からInfluxDBへのWebSocketアグリゲーター、1分足に正規化
マクロコンテキスト (DXY, VIX, 国債利回り): FRED + Finviz
恐怖・強欲指数: 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プロトコル: x402.org

x402 crypto market structure