x402 Triage MCP

x402-triage-mcp

無償で利用できる x402 サーフェスのトリアージ、402 Index のヘルスチェック、有償レビューへの引き継ぎを行う MCP サーバーです。

次の 3 つの MCP ツールを提供します。

• triage_x402_surface は、Tate Programs の公開トリアージ API を通じて、公開されている x402、MPP、Pay.sh、OpenAPI、マニフェスト、または HTTP 402 エンドポイントを 1 つ確認します。
• watch_402_index は、公開されている 402 Index のメタデータを検索し、プロバイダーのヘルス、支払いの有効性、ドメイン検証の兆候を確認します。
• x402_paid_paths は、有償の x402 API エンドポイント、サービスカタログ、AgentCard、範囲が固定されたレビューへのリンクを返します。

このツールは、X-PAYMENT、ウォレット署名、API キー、非公開の認証情報、有償の API 呼び出しを送信しません。

ツールページ：https://tateprograms.com/x402-surface-check.html

有償 x402 API カタログ：https://tateprograms.com/services.json

AgentCard：https://the402.tateprograms.com/.well-known/agent-card.json

インストール

npx で直接実行します。

npx --yes x402-triage-mcp

MCP 設定

stdio サーバーに対応した MCP クライアントに、このサーバーを追加します。

{
  "mcpServers": {
    "x402-triage": {
      "command": "npx",
      "args": ["--yes", "--package", "x402-triage-mcp", "x402-triage-mcp"]
    }
  }
}

STDIO MCP クライアントの設定では、ローカルコマンドが起動します。生成された設定を実行する前に、command、args、および env の値を確認し、再現性が重要な場合はバージョンを固定してください。

ツール

triage_x402_surface

{
  "url": "https://api.example.com/.well-known/x402",
  "method": "GET",
  "origin": "https://app.example.com"
}

ステータス、支払いヘッダー、解析されたチャレンジの概要、攻撃クラスのチェック項目、検出結果、有償の引き継ぎ先を返します。

watch_402_index

{
  "q": "example.com",
  "protocol": "x402",
  "limit": 10
}

一致する公開 402 Index レコード、ヘルスの概要、確認可能なローンチの阻害要因、有償の引き継ぎ先を返します。

x402_paid_paths

次の項目を返します。

• https://the402.tateprograms.com/api/x402/triage
• https://the402.tateprograms.com/api/x402/index-watch
• https://tateprograms.com/services.json
• https://tateprograms.com/x402-five-attack-review.html
• https://tateprograms.com/x402-fix-sprint.html

支払いと安全性の境界

このサーバーは、自分が所有するか、調査の許可を得ている公開ローンチサーフェスにのみ使用してください。非公開 URL、トークンを含む URL、顧客データ、ウォレットのシードフレーズ、本番環境のシークレットを送信しないでください。

この MCP サーバーは読み取り専用です。支払いを開始したり、X-PAYMENT ヘッダーを送信したり、ウォレットメッセージに署名したり、有償エンドポイントを呼び出したり、請求書を作成したり、残高を決済したり、購入権限を付与したりすることはありません。返される有償の引き継ぎ先は、別途レビューを購入するチーム向けの Tate Programs の静的な URL のみです。

エージェントコマースのレビューでは、実際の支出を有効にする前に購入者が求める安全対策が対象のサーフェスに備わっているかどうかを報告します。

• 支出上限：エージェントが支払いを行う前に、1 回あたりの上限と総予算の上限を明示してください。
• 承認チェックポイント：支払いの設定と高リスクの支出には、ユーザーまたはポリシーによる承認ステップを明示的に設けてください。
• 受取人の検証：有償リクエストの送信先は、想定されるドメイン、加盟店、ウォレットアドレス、または署名済みレジストリエントリに限定してください。
• リプレイ保護：チャレンジと決済コールバックでは、ノンス、有効期限、冪等性キー、署名済みリソース、または同等の制御を使用してください。
• メタデータの最小化：支払いのメタデータには、非公開のユーザーコンテキスト、シークレット、不要なリソースの詳細を含めないでください。
• 領収書と監査証跡：支払いが成功したら、トランザクション ID、受取人、金額、理由、ポリシーの根拠を記録してください。

開発

npm install
npm run check