X402 List MCP Server認証済み注目

x402-list MCP Server とは？

x402-list MCP Server は、x402（HTTP 402 ステーブルコイン）決済に対応したサービスのディレクトリである x402-list.com の MCP サーバーです。AI エージェントが x402 サービスを見つけ、稼働状況や価格を確認し、ファシリテーターごとのオンチェーン検証済み決済量を調べられます。

npm で x402-list-mcp として公開されているこのパッケージは、公開 x402-list HTTP JSON API の薄いラッパーです。キーを保持せず、データベースにも触れず、ディレクトリへの書き込みも行いません。7 つのツールのうち 6 つは無料の読み取り専用です。7 つ目の x402_assess_services は有料のパススルーで、クライアント側で自分で署名する x402 支払いチャレンジを中継します。パッケージがキーを保持したり、署名や決済を行ったりすることはありません。ソースは MIT ライセンスで github.com/mcccsm/x402-list-mcp にあります。

x402-list MCP Server の使い方

npm パッケージをローカルで stdio 実行するか、ホスト型サーバー https://mcp.x402-list.com/mcp（Streamable HTTP）に接続します。ローカル利用には Node.js 20 以上と npm が必要です。どちらの方法でも API キーは不要です。

Claude Code

ローカルパッケージ：

claude mcp add --transport stdio x402-list -- npx -y x402-list-mcp

またはホスト型サーバー：

claude mcp add --transport http x402-list https://mcp.x402-list.com/mcp

どちらか一方を選んでください。

Claude Desktop

claude_desktop_config.json に次のエントリを追加し、クライアントを再起動します。

{
  "mcpServers": {
    "x402-list": {
      "command": "npx",
      "args": ["-y", "x402-list-mcp"]
    }
  }
}

Cursor

ホスト型サーバーを .cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）に追加するか、README のインストールリンクを使います。

{
  "mcpServers": {
    "x402-list": {
      "url": "https://mcp.x402-list.com/mcp"
    }
  }
}

VS Code

.vscode/mcp.json に追加し、サーバーを起動して Copilot のエージェントモードで使います。

{
  "servers": {
    "x402-list": {
      "type": "http",
      "url": "https://mcp.x402-list.com/mcp"
    }
  }
}

Codex

codex mcp add x402-list --url https://mcp.x402-list.com/mcp

セルフホスト HTTP

MCP_HTTP_PORT=3000 npx -y x402-list-mcp --http

クライアントは http://localhost:3000/mcp に接続し、http://localhost:3000/healthz は {"status":"ok"} を返します。任意の環境変数として X402_LIST_BASE_URL、X402_LIST_TIMEOUT_MS（デフォルト 15000）、MCP_ALLOWED_ORIGINS、MCP_ALLOWED_HOSTS があります。

x402-list MCP Server の主な機能

• キーワード、カテゴリ、ネットワーク、稼働状態、そしてサービスの 402 レスポンスが標準的な x402 クライアントで署名可能かどうかで、x402-list ディレクトリを検索・絞り込み。
• サービスの詳細情報：エンドポイント、エンドポイントごとの米ドル価格、24 時間・7 日・30 日・90 日の稼働率、ネットワーク、決済アセット。
• 信頼性、x402 準拠、価格を重視し、オンチェーンの利用実績にも小さな重みを置いたサーバー側ランキング。
• ファシリテーターごとのオンチェーン検証済み決済量と取引件数。
• 掲載サービスの payTo、価格、402 スキーマの変更履歴。
• キーの保持、署名、書き込みは一切なし。支払先アドレスは API によりマスクされて返されます。

x402-list MCP Server のツール

• 探索： x402_search_services はディレクトリを候補に絞り込み、x402_get_service は slug を指定して完全なレコードを返し、x402_find_best_service は言葉で表したニーズに対して最大 20 件のランク付き推奨を返します。結果には ranking_version が付き、スコアは同じ評価世代の中でのみ比較します。
• 監視： x402_check_health はディレクトリ全体または 1 サービスのリアルタイム状態を報告し、x402_change_events は観測された payto_changed、price_changed、schema_changed イベントを一覧にします。service、type、days で絞り込めます。
• 市場データ： x402_facilitator_volumes はファシリテーターごとの本日（UTC）、7 日、30 日、累計の決済量を、オンチェーン検証フラグ付きで返します。
• 有料評価： x402_assess_services は Base 上の 0.25 USDC で、2〜8 件の候補を AI で新たに比較します。まず payment_signature_b64 なしで呼び出してチャレンジを受け取り、クライアント側で署名して再試行します。

x402-list MCP Server のユースケース

• タスク向けの有料 API を探す：「Base 上で稼働中、かつ署名可能な画像生成の x402 サービスを探して」
• 支払い前にサービスを確認する：「このサービスは今動いている？30 日の稼働率は？」
• 支払い失敗を調べる：「このサービスの payTo や価格は最近変わった？」
• エコシステムを調査する：「今月、実際にオンチェーンの決済量がある x402 ファシリテーターは？」
• 拮抗する候補から選ぶ：「この 3 つの候補を私のユースケースで評価して」

x402-list MCP Server のトラブルシューティング

• ローカルサーバーが起動しない： ローカル利用には Node.js 20 以上と npm が必要です。ホスト型 URL を使えばローカルの Node.js は不要です。
• x402_change_events で絞り込みが効かない： パラメータ名は slug ではなく service（掲載 slug）です。
• 価格が極端に大きく見える： pricing[].price はオンチェーントークンの最小単位による生の数量で、ドル表記は price_usd だけです。
• スコアが揃わない： x402_find_best_service のスコアは同じ ranking_version の中でのみ比較してください。
• リクエストがタイムアウトする： X402_LIST_TIMEOUT_MS（デフォルト 15000 ミリ秒）を増やしてください。