x402 Trust

x402-trust-mcp

x402 エンドポイントを見つけ、支払いの前に信頼性を確認するためのMCPサーバーです。監視対象のカタログ全体を対象にした意味検索とキーワード検索に加え、任意のエンドポイントの信頼スコア、履歴、一括スコアリング、監視機能を提供します。

x402-trust.comを基盤としており、Base と Solana 上の x402 エコシステムを24時間365日監視しています。稼働状況のプローブ、402 エンベロープ仕様への準拠、価格履歴、エンドポイントごとの実際のオンチェーン USDC 決済量を確認します。各スコアは LLM を使わず、すべて決定論的に算出されるため、内訳を完全に監査できます。

ツール

ツール	費用	説明
x402_ecosystem_stats	無料	x402 エコシステム全体のスナップショットです。エンドポイント数、到達可能性、過去30日間の実際の USDC 決済量を確認できます。
x402_trust_leaderboard	無料	x402 の信頼性が最も高いホスト上位100件のランキングです。測定対象全体に基づいてスコアを算出します。offset でページを指定します。
x402_verified_providers	無料	ドメインの管理権限を証明し、連絡先メールアドレスを確認したホストです。参考情報のみを提供し、認証によってスコアが変わることはありません。
x402_search	無料	カタログ内のホスト、URL、サービス名を対象にした部分一致検索です。
x402_semantic_search	無料	意味に基づく検索です。必要な機能を普段の言葉で説明してください。検出のみを目的とし、判定は行いません。
x402_trust_preview	無料	x402_trust_score と同じ形式で返される、完全な信頼レポート3件（最高値、中央値、最低値）です。
x402_trust_score	有料	1つのエンドポイントの完全な信頼判定です。スコア（0～100）、グレード、推奨事項、価格、フラグが含まれます。不明なエンドポイントはその場でライブプローブを実行します。
x402_endpoint_history	有料	1つのエンドポイントについて、過去1～90日間の生のプローブ履歴とイベント履歴を取得します。
x402_find_alternatives	有料	指定したエンドポイントと意味的に類似し、より高いスコアを持つエンドポイントを検索します。結果が空の場合、これを上回るものはありません。
x402_trust_bulk	有料	1回の呼び出しで最大500件のエンドポイントをスコアリングします。条件に合う最も安価なティア（10／50／100／200／500）を自動で選択します。
x402_watch_create	有料	1つのエンドポイントを30日間監視します。ポーリングまたは Webhook を通じて、payTo や価格の変更、リストからの削除、仕様への準拠状況の低下、ダウンタイムを通知します。1回限りのシークレットを返します。
x402_watch_events	無料	監視 ID とシークレットを使って監視イベントログをポーリングします。返されたカーソルでページを指定します。
x402_watch_edit	無料	監視対象の Webhook URL、感度、または購読するイベントを変更します。
x402_watch_cancel	無料	監視をただちに停止します。ログは有効期限まで引き続き閲覧できます。
x402_watch_renew	有料	有効な監視にさらに30日を追加します。シークレットは変わりません。

有料ツールの料金は、1回の検索で**$0.005から、500件の一括検索で約$0.50**までです。x402（Base 上の USDC）を通じて請求されます。X402_PRIVATE_KEY を設定すると、サーバーが設定した上限内で自動的に支払います。未設定の場合は、ホストが支払えるように料金見積もりを返します。リスト形式のツールは limit（最大25）と offset でページ指定でき、total を返します。

各フィールドのドキュメント、判定の意味、監視カーソルのルール、Webhook 署名の詳細はx402-trust.com/llms.txtに記載されています。すべてのレスポンスは、x402-trust.com/schemasのスキーマを通じて自己記述されています。

インストール

MCP クライアントの設定に追加します（例：Claude Desktop の claude_desktop_config.json）。

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

有料ツールの自動支払いを有効にするには、Base 上の USDC ウォレットに資金を用意して追加します。

{
  "mcpServers": {
    "x402-trust": {
      "command": "npx",
      "args": ["-y", "x402-trust-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0xYOUR_BASE_WALLET_KEY",
        "X402_MAX_USD": "0.05"
      }
    }
  }
}

設定（環境変数）

変数	デフォルト	説明
X402_TRUST_API_BASE	https://x402-trust.com	API のベース URL です。
X402_PRIVATE_KEY	(未設定)	ベースウォレットの秘密鍵です。有料ツールの自動支払いを有効にします。設定されていても形式が不正な場合は警告がログに記録され、自動支払いは無効のままです。
X402_MAX_USD	0.05	1 回の呼び出しにおける自動支払いの上限です。0 にすると自動支払いは無効になります。
X402_MAX_TOTAL_USD	1.00	プロセスごとの自動支払い累計上限です。0 は無制限です。
X402_MAX_CALLS	1000	プロセスごとの有料呼び出しの最大数です。0 は無制限です。
X402_TIMEOUT_MS	20000	リクエストのタイムアウトです。
X402_BASE_RPC_URL	Base のパブリック RPC	署名処理前の USDC 残高確認に使うエンドポイントです（無料の eth_call。デフォルトでは Base メインネット／Sepolia のパブリック RPC を使用します）。

無料ツールは、設定なしですべて利用できます。

セキュリティ

X402_PRIVATE_KEY はホットウォレットです。トラストの照会に使う分だけを入金してください。鍵がマシンの外に出ることはありません。ポリシーチェック（チェーンの許可リスト。デフォルトは Base メインネット、正規の USDC コントラクトの検証、上記の支出上限と呼び出し回数上限）の後、EIP-3009 の支払い承認にローカルで署名します。支払いのたびに、クライアントはウォレットの USDC 残高を再取得します。見積額を賄えないウォレットは、何も署名される前にローカルで拒否されるため、残高が空のウォレットから決済失敗が発生することはありません。また、入金は次の呼び出しから反映されます。

レスポンス署名

署名付きのツール結果には、レスポンスを JCS で正規化したもの（RFC 8785）に対する Ed25519 署名を含むトップレベルの signature ブロックがあります。この署名により、コンテンツが x402-trust によって組み立てられ、その後改変されていないことを証明できます。

検証時に重要なルールが 1 つあります。トラストアンカーはピン留めし、レスポンスからたどらないでください。 signature.publicKeys は検出用のヒントです。偽造されたレスポンスが攻撃者自身の鍵ドキュメントを指していても、検証は成功してしまいます。公開鍵自体をピン留めするか、起動時に https://x402-trust.com/.well-known/x402-trust-keys.json を一度取得してキャッシュしてください。動作するテストベクトルと 20 行のリファレンス検証コードは、x402-trust.com/schemas にあります。Watch の管理レスポンスは、機能の秘密情報を含み、それを証拠として転送してはならないため、意図的に署名されていません。

ライセンス

MIT