x402-list-mcp

x402-list-mcp

MCP を通じて、x402 決済 API の検出、稼働率と価格の確認、ファシリテーターごとのオンチェーンで検証された決済量の調査ができます。

x402-list とは

x402-list は、x402（HTTP 402 ステーブルコイン）決済を受け付けるサービスのディレクトリです。掲載されているサービスの稼働率、応答時間、ステータスを監視し、ファシリテーターの決済量をオンチェーンで測定します。

このパッケージは、公開されている x402-list HTTP JSON API の薄いラッパーです。キーを保持せず、データベースに触れず、ディレクトリへの書き込みも行いません。Model Context Protocol を通じてディレクトリを AI エージェントに公開する 7 つのツールを提供します。6 つは無料の読み取り専用ツールで、7 つ目の x402_assess_services だけが有料です。これはパススルーであり、クライアント側でご自身が署名する x402 決済チャレンジを中継します（このパッケージはキーを保持せず、署名もせず、決済も行いません）。

インストールとクイックスタート

Streamable HTTP を使用して https://mcp.x402-list.com/mcp のホスト型サーバーに接続するか、npm パッケージを stdio 経由でローカルに実行します。ローカルでの使用には Node.js 20 以降と npm が必要です。ホスト型への接続にはローカルへの Node.js のインストールは不要です。

Claude Code

ホスト型サーバーに接続します：

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

または、代わりにローカルパッケージを使用します：

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

トランスポートはどちらか一方を選択してください。設定スコープについては Claude Code MCP ドキュメントを参照してください。

Cursor

ホスト型サーバーを Cursor に追加し、Cursor でインストールを確認します。

インストールリンクは、.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）に手動で記述する次の設定と同じ内容をエンコードしています：

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

Cursor MCP ドキュメントとインストールリンクの形式を参照してください。

VS Code

プロジェクトの .vscode/mcp.json にこのエントリを追加し、エディターからサーバーを起動して、Copilot のエージェントモードで使用します：

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

その他の設定場所については VS Code MCP ドキュメントを参照してください。

Codex

Codex CLI でホスト型サーバーを追加します：

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

または、~/.codex/config.toml にこのエントリを追加します。CLI と IDE 拡張機能はこの設定を共有します：

[mcp_servers.x402-list]
url = "https://mcp.x402-list.com/mcp"

Codex MCP ドキュメントを参照してください。

Claude Desktop およびその他のローカル stdio クライアント

claude_desktop_config.json、またはお使いの stdio クライアントに相当する設定ファイルにこのエントリを追加し、クライアントを再起動します：

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

Claude Desktop の設定ファイルの場所については、ローカル MCP 接続ガイドを参照してください。

クライアントは、ターミナルで実行できるものと同じコマンドを起動します：

npx -y x402-list-mcp

Streamable HTTP のセルフホスト

POSIX シェルで独自の 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	https://x402-list.com	API のベース URL。/api/v1 プレフィックスが自動的に付加されます。
X402_LIST_TIMEOUT_MS	15000	リクエストごとのタイムアウト（ミリ秒）。
MCP_HTTP_PORT / PORT	3000	HTTP ポート。MCP_HTTP_PORT を設定すると HTTP トランスポートが選択されます。
MCP_ALLOWED_ORIGINS	（空、許可的）	HTTP モードで許可する CORS オリジンのカンマ区切りリスト。
MCP_ALLOWED_HOSTS	（空、無効）	HTTP モードで DNS リバインディング保護を有効にするカンマ区切りリスト。

ツール

ツール	機能
x402_search_services	クエリ、カテゴリ、ネットワーク、ステータス、および signable（最後に観測された 402 エンベロープに、標準的な x402 クライアントが署名するために必要とする EIP-712 ドメインパラメータが含まれているかどうか）でディレクトリを検索・絞り込みします。並び替えは newest/uptime/cheapest/endpoints に対応しています。
x402_get_service	slug で指定した 1 つのサービスの詳細情報: エンドポイント、エンドポイントごとの USD 価格、稼働時間のウィンドウ、ネットワーク、決済資産。
x402_find_best_service	ニーズに対するランク付きの推奨を、サーバー側で計算して返します（GET /api/v1/best）。ランクは主に信頼性、x402 準拠、価格（ステータス、検証済み、稼働時間、応答時間、USD 価格）で決まり、サービスごとのオンチェーンでの traction には小さな（約 10%）重みが付きますが、それが上記 3 要素を上回ることはありません。回答の ranking_version を読んでスコアリングの世代（下記参照）を特定し、units マップでスコアリングの注意事項を確認してください。
x402_check_health	ディレクトリ全体またはサービスごとのライブステータス（稼働時間のスナップショット、連続失敗数）。
x402_facilitator_volumes	ファシリテーターごとのオンチェーン検証済み決済量（本日 UTC/7d/30d/all）を USD で、トランザクション数、およびオンチェーンかリスト掲載かを示すフラグとともに返します。*_24h フィールドは本日（UTC）のここまでの分を対象としており、直近 24 時間のウィンドウではありません。
x402_change_events	モニターが掲載サービス上で観測した変更を、無料・読み取り専用のフィードとして、新しい順にちょうど 3 種類のイベントタイプ（payto_changed、price_changed、schema_changed）で返します。service（掲載の slug: パラメータ名は slug ではなく service です）、type、days（1〜365、デフォルト 90）で絞り込めます。ページングには page / per_page（1 ページあたり最大 100）を使用します。各イベントには観測タイムスタンプ、差分の要約、変更前後の 402 スナップショットが含まれます。イベント内の価格はアトミックなトークン量であり、ドルではありません。また、すべての payout アドレスは API によってマスクされて返されます。このフィードが報告するのは payTo が変更されたという事実のみで、アドレスそのものは報告されません。
x402_assess_services	有料（Base 上の $0.25 USDC、x402）。提示されたニーズに対して、掲載サービスの候補リストをオンデマンドの AI で新たに比較します。パススルー方式であり、鍵を保持せず、署名もせず、決済も行いません。payment_signature_b64 を付けずに呼び出すと x402 チャレンジがそのまま返るので、クライアント側で署名し、その署名を付けて再試行するとレポートが得られます。オプションで probe ターゲット { slug, endpoint_path? } を追加すると、掲載サービスの 1 つを実際にライブテストできます。この場合、価格は $0.25 にそのエンドポイントの価格 X を加えたものになり（返金不可）、レポートには判定と切り詰められた抜粋を含む probe_report ブロックが追加されますが、サードパーティの本文がそのまま含まれることはありません。

ランキングの世代

x402_find_best_service はスコアリングの世代を ranking_version で返します。スコアは同じ世代内でのみ比較してください。以下の変更は、世代をまたぐとスコアが異なる理由を説明するものです。

• 世代 2 では、サービスの EVM ルートの少なくとも 1 つが、標準的な x402 クライアントが支払いに署名するために必要とする EIP-712 ドメインパラメータ（extra.name、extra.version）を欠いていると観測された場合に、コンプライアンス項を C バンドの下限である 0.6 で上限設定しました。これはワイヤー上のエンベロープに関する事実であり、サービスの価値に対する判断ではありません。
• 世代 3 では、traction 項に不正防止ルールを追加しました。30d の決済量に $10 の絶対的な下限を設け、それを下回る場合はこの項を 0 とします。下限未満の量はダストと区別がつかず、ランクを動かしてはならないためです。また、payout が 1 人の買い手に集中している場合は割引を適用し、単一の買い手がそのすべてを占める場合は traction 項の最大半分とします。1 人の買い手は 1 つの関係にすぎず、この項が報いるべき幅広い需要ではないためです。さらに、マッピング可能な payTo を公開していないサービスは、重みを再正規化して消すのではなく、この項で 0 と評価されるようになりました。これにより、payout アドレスを隠しても、測定されたアドレスを持つ場合を上回ることはなくなりました。

単位に関する注意

すべての金額は10進数の米ドルであり、そのままの形で受け渡されます。セントへの変換はどこでも行われません。エンドポイントごとの pricing[].price フィールドは、生のアトミックなオンチェーントークン量（uint256 文字列）であり、ドルではありません。ドルの数値であるのは price_usd のみです。

正直さに関する注意

オンチェーンの出来高シグナルは2種類あり、これらを混同しないでください。Facilitator 出来高（x402_facilitator_volumes）はエコシステム全体の代表値であり、facilitator ごとに集計されます。サービスごとのトラクション（各サービスの traction ブロック。x402_find_best_service 内で約10%の重みで評価されます）は、認識された settler を通じて、そのサービス自身の payTo 上で測定された決済です。これは意図的な保守的な過小カウントであり、推定値ではありません。帰属先が不明な決済は除外され、決して水増しされません。payTo が複数のサービスで共有されている場合（shared_payout: true）、帰属されるのは決済の出来高のみが pro-quota（按分）で、そのアドレスにおけるオペレーターレベルの出来高を、それを共有するサービス間に分割したものです。これは宣言された慣例であり、個別に観測された指標ではありません。一方、トランザクション数とユニーク購入者数はオペレーターレベル全体の整数のままです。まだ測定されていないネットワーク上のサービス、またはプローブが失敗し続けている shared-payout のメンバーは、トラクション項をまったく持たず、残りの重みはそれを除いて再正規化されます。共有された、pro-quota の、または未測定の出来高を、単一サービスの収益として読まないでください。「どの facilitator が実際のオンチェーン出来高を持つか」を知りたい場合は、x402_facilitator_volumes を使用し、verification フラグを確認してください。

ソース

ソースコード: mcccsm/x402-list-mcp。このリポジトリは、MCP パッケージが公開されたときにそれをミラーリングします。公開 REST API は x402-list.com/api でドキュメント化されています。

ライセンス

MIT