x402score-mcp

x402score-mcp

x402Scoreの評判データをエージェント向けツールとして公開する MCP サーバーです。MCP 対応クライアント（Claude Desktop、Claude Code など）から、x402 で支払いが発生する API エンドポイントの信頼スコアを、支払い前に確認できます。

npm には公開済みですが、MCP レジストリにはまだ申請していません。 パッケージ自体（x402score-mcp）は今すぐインストールできます。保留しているのは、オンチェーン修正値の較正ゲートが終了するまでのレジストリへの掲載（Claude、Smithery など）です（終了予定：約2026-10-19）。理由については、メインプロジェクトの README をご覧ください。ゲート終了後すぐにコピーして提出できるよう、レジストリ掲載内容は REGISTRY_SUBMISSION.md に事前に用意しています。実際の stdio MCP クライアントを使い、本番環境に対してエンドツーエンドで再検証した最終日：2026-10-10（5つすべてのツールとメソドロジーリソースについて、構造化出力、エラー処理、ツールのアノテーションがすべて正常に動作することを確認済みです）。

ツール

• check_endpoint_score — 1つのエンドポイントのスコア、評価、信頼区間を取得します。url を直接渡す方法（推奨。endpointId はローカルで導出されるため、別途検索する必要はありません）と、すでに分かっている場合に endpointId を渡す方法があります。
• search_leaderboard — 名前、ドメイン、URL、ID、および／または業種で追跡対象のエンドポイントを検索・閲覧できます。score（既定値）、price、uptime、latency で並べ替えられます。
• get_calibration_report — スコアリングの計算式は実際に予測に役立つのでしょうか？
• submit_endpoint — 新しい x402 エンドポイントを監視キューに追加します。
• ping — 接続確認に最初に呼び出す用途にも便利な、軽量な到達性／レイテンシ確認です。

すべてのツールで readOnlyHint／destructiveHint／idempotentHint／openWorldHint アノテーションと対応する outputSchema を宣言しています。また、ネットワーク障害やバックエンドのタイムアウトで接続を終了させるのではなく、明確なメッセージを含む構造化エラーを返します（利用可能な場合はバックエンド独自のエラーテキストも含みます。たとえば、HTTP ステータスだけでなくレート制限のメッセージも含まれます）。x402score://methodology リソースでは、スコア、評価、信頼区間、オンチェーン修正値の実際の意味を説明しています。ツールの説明だけから推測するのではなく、セッションごとに一度お読みください。リクエストはクライアント側で10秒後にタイムアウトするため、バックエンドの応答が遅い、または劣化している場合に呼び出し元を待たせず、速やかに明確な形で失敗します。バージョン履歴については CHANGELOG.md をご覧ください。

インストールと実行

npm install -g x402score-mcp
x402score-mcp

または、ソースから実行します。

cd mcp && npm install && npm run build
npm start

Claude Desktop／Claude Code からの利用

MCP クライアントの設定に追加します。

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

または、これまでと同様に、ローカルの node／dist/server.js ビルドを command／args に指定することもできます。

必要に応じて、サーバーの env に X402SCORE_BASE_URL を設定すると、本番環境の代わりにローカルの wrangler dev またはステージング環境を指定できます。これを設定すると、サーバーのすべての通信が指定した URL に転送されるため、自分が管理し、信頼しているバックエンドのみを指定してください。

開発

ツールのロジック（src/tools.ts）は、実際の MCP トランスポートなしでテストできるよう、MCP プロトコルとの接続処理（src/server.ts）から分離されています。テストはメインプロジェクトの vitest で実行します（リポジトリのルートから npm test を実行してください）。src/server.ts は、これらの関数を stdio 経由で接続する @modelcontextprotocol/sdk の McpServer に組み込みます。