RouteVerdict

route-verdict-mcp

単独リポジトリ: このサーバーは、ディレクトリへの取り込みとメンテナンスのため、各 MCP サーバーに独自の GitHub リポジトリを用意できるよう、QuincyGB/token-verdict-tools から分割されました。PyPI パッケージ名（route-verdict-mcp）、バージョン、インストールコマンドに変更はありません。

MCP サーバー（stdio トランスポート）です。Claude Desktop、Cursor、独自のエージェントランタイムなど、あらゆる MCP ホストで RouteVerdict をネイティブツールとして利用できます。

RouteVerdict は、x402 エンドポイントの信頼性と稼働状況を呼び出しごとに確認するサービスです。任意の有料リソース URL を送ると、判定結果（TRUSTED / CAUTION / AVOID）、0～100 の信頼スコア、項目ごとの減点リスト、対象への ライブ 402 プローブ、公開されている利用規約、ディスカバリースキーマの 品質、CDP Bazaar と PayAI のインデックスにおけるカタログ掲載状況、同じ URL の 前回チェックとの差分が返されます。料金は x402 プロトコル 経由で Base 上、1 回のチェックにつき 0.05 USDCです。アカウントや API キーは不要で、支払いが認証となります。対象のエンドポイントにプローブを実行しますが、支払いは行いません。

ツール

route_check — サービスの実際の契約に基づく単一のツールです。

入力	型	備考
resource_url	string（必須）	監査する x402 リソースの完全な URL

出力はサービスのチェック JSON です。resource_url、checked_at、 verdict、score、reasons（項目ごとの減点）、liveness、 terms、schema_quality、catalog、diff が含まれます。

インストール

pip install route-verdict-mcp

# Or from a checkout of this repository:
pip install .

Python ≥ 3.10 が必要です。サーバーでは MCP v1 SDK API （mcp>=1.2,<2）を固定しています。

設定

設定はすべて運用者自身の環境で行います。このサーバーを実行する人が 自身のウォレットを用意します。このパッケージにキー情報は含まれておらず、 パッケージの作者がキーを参照することもありません。

環境変数	必須	用途
AGENT_PRIVATE_KEY	有料呼び出しの場合	Base 上で USDC を保有するウォレットの EVM 秘密鍵（0x...）。x402 EIP-3009 認証への署名にローカルで使用します。
AGENT_KEY_FILE	代替	その鍵を含むファイルへのパスです。
ROUTE_VERDICT_URL	いいえ	サービスのベース URL の上書き（デフォルト：本番環境）。
ROUTE_VERDICT_MAX_AMOUNT_UNITS	いいえ	1 回の呼び出しで使う USDC マイクロ単位の上限（デフォルトは 50000 = $0.05、既知の料金）。クライアントは、これを超える料金への署名を拒否します。

署名者を設定しない限り、ツールが支払いを行うことはありません。 402 が返された場合、 チャレンジを解析し、構造化エラーとして返します。エラーは error: "payment_required" で、完全な accepts 配列（scheme、network、 asset、amount、payTo）が含まれます。これにより、呼び出し元のエージェントは料金を確認して 対応を判断するか、自身の x402 クライアントでチャレンジを決済できます。

MCP ホストの設定

Claude Desktop（claude_desktop_config.json）— stdio を使用する他の MCP ホストでも 同じ形式です。

{
  "mcpServers": {
    "route-verdict": {
      "command": "route-verdict-mcp",
      "env": {
        "AGENT_PRIVATE_KEY": "0xYOUR_OWN_WALLET_KEY"
      }
    }
  }
}

インストールではなく、チェックアウトから実行する場合：

{
  "mcpServers": {
    "route-verdict": {
      "command": "python",
      "args": ["-m", "route_verdict_mcp"],
      "env": {
        "PYTHONPATH": "/path/to/route-verdict-mcp/src",
        "AGENT_KEY_FILE": "/path/to/your/agent.key"
      }
    }
  }
}

ホストの設定で可能な場合は、設定ファイルに鍵を直接記述するのではなく、 AGENT_KEY_FILE を使用してください。

支払いの仕組み

クライアントは標準的な x402 v2 フロー（このサービスのライブカタログ登録で 使用しているものと同じフロー）に準拠しています。

1. 未払いの状態で POST /v1/check を送信すると、HTTP 402 が返され、チャレンジは payment-required ヘッダー内で base64 エンコードされます。
2. accepts から exact / eip155:8453 のエントリーを選択します。
3. EIP-3009 の TransferWithAuthorization（validAfter: 0、 validBefore: now + maxTimeoutSeconds、ランダムな 32 バイトの nonce）を作成し、 チャレンジで通知される USDC ドメイン（extra.name / extra.version）に対して EIP-712 の型付きデータとして署名します。
4. ペイロードを PAYMENT-SIGNATURE ヘッダーに含め、同一の POST を再試行します。 サービスはサーバー側でファシリテーター（PayAI）を通じて検証と決済を行い、 決済レシートは payment-response ヘッダーで返されます。

テスト

pip install -e ".[dev]"
pytest

支払いはすべてモックです（httpx の MockTransport と、テスト時に生成する 使い捨ての署名者を使用）。402 のフィクスチャは本番環境から取得した実際の チャレンジです。有料フローのテストでは、EIP-712 署名から実際に署名者の アドレスを復元できることを検証します。

セキュリティに関する注意事項

• 秘密鍵は実行時に環境から読み込まれ、支払い承認への署名にのみローカルで使用されます。送信されることはありません。x402 ペイロードに含まれるのは署名であり、鍵ではありません。
• 支出ガードにより、1 回の呼び出しあたりの金額は設定された金額（デフォルトでは、ちょうど $0.05 の価格）に制限されます。
• エージェントに資金を用意するときと同じように、運用資金のみを保有する専用のエージェントウォレットで実行してください。