kerdos-x402-mcp

kerdos-x402-mcp

AI トレーディングエージェント向けに、Kerdos Market Intelligence API をツールとして公開する MCP サーバーです。x402 プロトコルを介し、Base メインネット上で USDC による従量課金が行われます。API キーやサブスクリプション、登録は不要です。

機能

暗号資産市場のインテリジェンスを提供する 11 個のツールです。

ツール	価格	返される情報
get_market_overview	$0.01	1 回の呼び出しで取得できるスナップショット：BTC／ETH／SOL／GOLD の価格＋RSI＋レジーム＋資金調達率＋Fear & Greed
get_sentiment	$0.05	複数アナリストによる複合センチメント、短期＋長期の方向性、逆張りフラグ
get_regime	$0.02	BTC／ETH の強気／弱気レジーム（EMA50 1h）と複合信頼度
get_funding	$0.01	Hyperliquid の無期限先物の資金調達率＋BTC／ETH の OI
get_gold_signal	$0.03	XAU の方向性、信頼度、RSI、4h フィボナッチ（HIP-3 の金無期限先物）
get_whale_alerts	$0.01	クジラウォレットのポジション傾向＋オンチェーンの資金フロー
get_liquidations	$0.02	OI の変化速度＋連鎖清算リスク＋大口取引（$50K 以上）の追跡
get_cvd	$0.02	累積出来高デルタ — BTC／ETH のテイカーによる買い／売りの乖離
get_cascade_risk	$0.02	コインごとの意思決定向け連鎖清算リスク分類器（NONE／LOW／MODERATE／ELEVATED／HIGH）
get_funding_chaos	$0.03	BTC／ETH／SOL の 12 時間未満における資金調達率の符号反転レジーム指数
get_composite_signal	$0.06	割引価格で提供するバンドル型の市場状態（レジーム＋連鎖清算リスク＋センチメント）

セットアップ

npm install -g kerdos-x402-mcp

または、npx 経由で実行できます（インストール不要）。

npx kerdos-x402-mcp

必須の環境変数

EVM_PRIVATE_KEY=0x...   # YOUR private key (used to sign payment authorizations)

MCP サーバーは、Base 上の Kerdos 受取ウォレットへの USDC 送金を承認するためだけにキーを使用します。ツールの呼び出しごとに $0.01～$0.06 がかかります。

任意の環境変数

KERDOS_X402_BASE_URL=https://nonvisceral-eloisa-mousily.ngrok-free.dev

Claude Desktop の設定

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "kerdos": {
      "command": "npx",
      "args": ["kerdos-x402-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

支払いの仕組み

1. MCP クライアントがツール（例：get_market_overview）を呼び出します。
2. MCP サーバーが https://...kerdos.../api/market-overview にリクエストします。
3. Kerdos サーバーが支払いチャレンジとともに 402 Payment Required を返します。
4. @x402/fetch がキーを使用して USDC の transferWithAuthorization に署名します。
5. サーバーが署名を検証し、Base 上の CDP ファシリテーター経由で決済して、JSON レスポンスを返します。

エンドツーエンドのレイテンシー：約 1～2 秒／回。対話型の承認は不要で、支払いは透過的に行われます。

プロバイダー

Kerdos Market Intelligence — Hyperliquid ＋ Base 上で稼働する自律型トレーディングエージェント群です。同じシグナルが、Kerdos 自身のボットのエントリー判断にも使われます。

• ディスカバリー：https://nonvisceral-eloisa-mousily.ngrok-free.dev/.well-known/x402
• CDP Bazaar の掲載数：11 エンドポイント
• 402Index：12 件
• ドメイン検証済み（402Index）

ライセンス

MIT — 自由にフォークしてください。

問題の報告

MCP 側のバグについては、このリポジトリで GitHub issue を作成してください。エンドポイントの停止状況については、https://nonvisceral-eloisa-mousily.ngrok-free.dev/health を確認してください。