x402station-mcp

x402station-mcp

x402station.io の MCP アダプターです。x402 のエージェント型コマース向けに、独立したリスクシグナルを提供します。x402station.io の Preflight に加え、Forensics、Catalog Decoys、Alternatives、Credits、Watch、Whats New を公開します。Model Context Protocol を利用するあらゆるエージェントが、PAYMENT-SIGNATURE に署名する前、つまり支払いの前にエンドポイントの証拠を取得できます。おとり、ゾンビ、価格トラップ、支払い実績なし、レイテンシ、署名／決済のチェックを行います。

x402station.io は、agentic.market に掲載されたすべてのエンドポイントを 10 分ごとに独自にプローブし、プローブ履歴と CDP の決済データを統合します。ポリシーエンジンが判断と適用を行い、x402station.io は測定と報告を行います。ルーティングや資金の保管は行わず、推奨も行いません。

インストール

# Claude Code / Cursor / Windsurf / Continue — works anywhere with MCP
npm install -g x402station-mcp
# or use npx in the config, no global install needed:

設定

このアダプターは、x402 自体を通じて、有料呼び出しごとに実際の USDC を請求します。Base メインネットの USDC を保有するウォレットの秘密鍵が必要です。

Claude Code

~/.claude/claude_desktop_config.json（または MCP サーバーの設定ファイル）に追加します。

{
  "mcpServers": {
    "x402station": {
      "command": "npx",
      "args": ["-y", "x402station-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

Cursor / Windsurf / Continue

同じ形式です。すべての MCP ホストが command / args / env を理解します。お使いのツールの MCP ドキュメントを参照してください。

環境変数

変数	必須	デフォルト	用途
AGENT_PRIVATE_KEY	有料ツール呼び出しには必須	—	0x で始まる 64 桁の 16 進数の秘密鍵です。アカウントは Base メインネットの USDC を保有している必要があります。
X402STATION_BASE_URL	いいえ	https://x402station.io	開発／テスト用のオーバーライドです。

ツール

preflight(url) — $0.001 USDC

この x402 URL への支払いが安全かどうかを確認します。次の情報を返します。

{
  "ok": true,
  "warnings": [],
  "metadata": {
    "service": "...",
    "price_usdc": "0.01",
    "uptime_1h_pct": 100,
    "avg_latency_ms": 412
  }
}

ok が true になるのは、重大な警告がない場合のみです。警告には unknown_endpoint、no_history、dead、zombie、decoy_price_extreme、never_paid_zombie、proxy_markup、wildcard_402、spa_fallback、suspicious_high_price、slow、new_provider が含まれます。

forensics(url) — $0.001 USDC

過去 7 日間の詳細レポートです。preflight の情報をすべて含みます。時間単位の稼働率、レイテンシの p50／p90／p99、ステータスコードの分布、集中度グループの統計、おとりである確率を返します。追加の警告は dead_7d、mostly_dead、slow_p99、price_outlier_high、high_concentration です。

catalog_decoys() — $0.005 USDC

完全なブラックリストです。現在、重大な問題があると判定されたすべてのアクティブなエンドポイントと、理由ごとの件数を返します。定期的に取得してローカルにキャッシュしてください。すべての URL を preflight するより低コストです。

エージェントの一般的なフロー

agent wants data from some_endpoint.com
    │
    ├─ preflight("https://some_endpoint.com/data")  ← $0.001
    │     ok: false, warnings: ["decoy_price_extreme"]
    │
    └─ skip; try the next candidate

一括で検出する場合は、catalog_decoys() を 1 日 1 回実行し、これからアクセスする URL 群との差分として結果を扱います。

組み合わせて使う

x402station は、エージェントが支払う前に エンドポイントが安全かどうか（おとり／ゾンビ／価格トラップ／支払い実績なし）をチェックします。支払いメタデータに含まれる PII を署名前にスクリーニングするなど、ペイロードの安全性チェックと自然に組み合わせられます。

agent intent: pay some_endpoint.com
    ├─ x402station    preflight(url)              ← is the ENDPOINT safe?
    ├─ presidio-x402  screen_payment_metadata()   ← is the PAYLOAD safe?
    └─ pay()

presidio-hardened-x402-mcp は署名前に支払いメタデータの PII をスクリーニングします。2 つのサーバーは意図的に独立して開発されています。シグナル間の相関をなくすことが目的です。これは組み合わせ方の紹介であり、推奨ではありません。スクリーニングツールの動作と制限については、先方のリポジトリを参照してください。

リンク

• サービス：https://x402station.io
• マニフェスト：https://x402station.io/.well-known/x402
• OpenAPI：https://x402station.io/api/openapi.json
• データセット：https://huggingface.co/datasets/x402station/preflight-dataset-v0_1
• GitHub：https://github.com/sF1nX/x402station-mcp
• x402 仕様：https://x402.org

お問い合わせ

• 一般・商用のお問い合わせ：[email protected]
• バグ報告：https://github.com/sF1nX/x402station-mcp/issues
• セキュリティに関する報告（RFC 9116）：https://x402station.io/.well-known/security.txt

ライセンス

MIT