x402station-mcp
x402station-mcp
x402stationフライト前オラクル用のMCPアダプターです。Model Context Protocolに対応したあらゆるエージェントにpreflight、forensics、catalog_decoysツールを提供し、x402エンドポイントへの支払い前にデコイ、ゾンビサービス、価格トラップをチェックできるようにします。
x402stationは、agentic.marketにリストされているすべてのエンドポイント(2万件以上、10分ごと)を独自にプローブします。これには、スクレイピング防止用ハニーポットとして機能する1,000 USDC以上の価格設定がされた約161件のエンドポイントなど、ファシリテーターベースの監視では見えないものも含まれます。
インストール
# Claude Code / Cursor / Windsurf / Continue — works anywhere with MCP
npm install -g x402station-mcp
# or use npx in the config, no global install needed:Related MCP server: automaton-onchain-tools
設定
このアダプターは呼び出しごとに実際のUSDCを課金します(x402自体を使用しており、当社のオラクルは自社サービスで検証済みです)。Base Sepolia USDC(将来的にBaseメインネットへ移行予定)を保有するウォレットの秘密鍵が必要です。
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ドキュメントを参照してください。
環境変数
変数 | 必須 | デフォルト | 目的 |
| ツール呼び出しに必須 | — | 0xで始まる64桁の16進数秘密鍵。アカウントはBase Sepolia USDCを保有している必要があります。 |
| いいえ |
| 開発/テスト用の上書き設定。 |
ウォレット用のテストネットUSDC:faucet.circle.com(Base Sepoliaを選択してください)。
ツール
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、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一括検出を行う場合は、1日1回catalog_decoys()を実行し、その結果をアクセスしようとしているURLとの差分集合として扱ってください。
リンク
オラクル: https://x402station.io
x402仕様: https://x402.org
お問い合わせ
一般・商用: hello@x402station.io
セキュリティ開示 (RFC 9116): https://x402station.io/.well-known/security.txt
ライセンス
MIT
Available Tools
10 toolsalternativesRouting fallback — siblings to a flagged endpointA
Given a URL flagged by preflight (or a taskClass hint), returns up to 5 healthy sibling endpoints in the same provider/domain/category/price-band. Filters out 7-day-dead and 1-hour-erroring candidates; ranks by uptime + latency. Costs $0.005 USDC. Use this immediately after preflight returns ok=false — it answers 'where do I go instead?'. Pass {url} when you have a specific URL the agent was about to pay; pass {taskClass} (e.g. 'llm-completions', 'Inference') when discovering by service category; or both for a richer match.
Inputs: url, taskClass, limit.
buy_creditsBuy 1000 prepaid /api/v1/preflight calls ($0.50 = 50% off)A
Bulk-prepaid preflight bundle. Pay $0.50 USDC once for 1000 prepaid /api/v1/preflight calls. Effective rate $0.0005/call (50% off the per-call $0.001 tier). Returns { creditId, balance: 1000, expiresAt }. STORE THE creditId — it's the bearer token and is not retrievable later. Pass it via X-Credit-Id header on subsequent /api/v1/preflight calls; on exhaustion (balance=0) or expiry (90 days) the middleware falls through to per-call x402 automatically. Use this once you've decided to do high-volume preflight work.
Inputs: no named parameters.
catalog_decoysFull decoy / zombie blacklistA
Returns every active x402 endpoint currently flagged decoy_price_extreme / zombie / dead_7d / mostly_dead in one JSON payload, plus per-reason counts. Costs $0.005 USDC. Pull periodically (hourly/daily) and cache locally as a blacklist — cheaper than preflighting every URL.
Inputs: no named parameters.
credits_statusRead a credit's current balance + expiryA
Free, no payment required. Returns { creditId, balance, initialBalance, used, paidAmount, createdAt, expiresAt, expired, paymentTx, paymentNetwork }. UUID-only access — anyone holding the creditId can read state, same as decrement. 404 covers both 'malformed UUID' and 'no such credit' (same body so an attacker scraping random UUIDs can't tell them apart).
Inputs: creditId (required).
forensics7-day forensics reportA
Deep history for one x402 endpoint: hourly uptime over 7 days, latency p50/p90/p99, status-code distribution, concentration-group stats (how crowded this provider's namespace is), and a decoy probability score [0, 1]. Costs $0.001 USDC. Superset of preflight — if you're running forensics you don't need preflight too.
Inputs: url (required).
preflightPre-flight safety checkA
Ask x402station whether a given x402 URL is safe to pay. Returns {ok, warnings[], metadata}. Costs $0.001 USDC (auto-signed with AGENT_PRIVATE_KEY). Call this BEFORE any other paid x402 request to avoid decoys (price ≥ $1k), zombie services, and dead endpoints. ok:true only when no critical warning fires.
Inputs: url (required).
watch_statusCheck watch subscription status + recent alertsA
Returns the current state of a watch: active/expired, alerts remaining (out of 100 prepaid), last 10 alert deliveries with their delivery_status, and the last computed signal snapshot. Free — no payment required, secret-gated. The secret is the one returned by watch_subscribe.
Inputs: watchId (required), secret (required).
watch_subscribeSubscribe to webhook alerts on x402 endpoint state changesA
Pay $0.01 USDC for a 30-day watch + 100 prepaid alerts on one x402 endpoint. When subscribed signals fire or clear (e.g. endpoint goes zombie, price flips to decoy_price_extreme), x402station POSTs a JSON payload signed with HMAC-SHA256 to your webhookUrl. Returns watchId + secret — STORE THE SECRET, it's the HMAC seed for verifying delivery payloads and is not retrievable later. signals defaults to the critical preflight subset {dead, zombie, decoy_price_extreme}; pass other names to subscribe to non-critical signals too.
Inputs: url (required), webhookUrl (required), signals.
watch_unsubscribeUnsubscribe from a watch (deactivate)A
Deactivates the watch — no further alerts will be queued or delivered. The subscription is set is_active=false but the row + alert history is retained for audit. Free — no payment required, secret-gated. There is no refund for unused prepaid alerts.
Inputs: watchId (required), secret (required).
whats_newCatalog diff polling — added / removed endpoints since `since`A
Polling-friendly catalog diff. Body { since?, limit? } (default since=now-24h, limit=200, max 500). Returns added_endpoints[] (first_seen_at >= since AND is_active=true), removed_endpoints[] (flipped to is_active=false since), service-level counts, polls_in_window, and current active totals. Cheap ($0.001 USDC) so hourly polling stays under $1/month — perfect for aggregator agents that need a fresh delta without re-pulling the whole catalog. Internal ingest cron runs every 5 min, so polling more often than that returns identical data.
Inputs: since, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool serves a distinct function: preflight checks, alternative endpoints, credit management, forensics, catalog blacklists, watch subscriptions, and catalog diffs. Descriptions are detailed, leaving no ambiguity about tool purposes.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., buy_credits, watch_subscribe, whats_new), making predictions and selection straightforward for an agent.
With 10 tools, the server covers its domain of endpoint safety monitoring, credit management, and subscription alerts without being overly bloated or sparse.
The tool surface covers the main workflow: preflight checks, alternatives, credit buying, status, forensics, blacklisting, watching, and polling. A minor gap is the lack of a free endpoint status query for a single URL, but the paid preflight covers it.
Maintenance
Related MCP Connectors
Preflight before paying any x402 tool (ok|caution|avoid + history). 1 free/wallet; then $0.01 Base.
Parallel Solana token risk and transaction safety for AI agents. Paid MCP tools inspect tokens and unsigned transactions; the HTTP risk panel queries compatible advisors in parallel and returns an indicative consensus. x402-compatible clients pay USDC automatically, with no signup or API key.
Pay-per-call ($0.005-$0.03 USDC) market, on-chain, and prediction-market data API for AI agents and trading bots via x402 — no signup, no API key. Remote MCP server, 28 tools: token security (honeypot/liquidity/counterfeit checks), Hyperliquid oracle-gap risk, kimchi premium, funding APR, DEX slippage, Polymarket arbitrage/liquidity audits, Hyperliquid HIP-4 odds.
Free token-safety scans + paid x402 verdicts, signals, radar & EVM swap quotes for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceExposes typed crypto-security tools — token risk scoring, wallet forensics, deployer reputation, sentiment, and report generation — to MCP-capable agents over streamable HTTP or stdio. Gates premium calls behind per-request x402 crypto micropayments, delegating verification and settlement to a self-hosted facilitator and failing closed when payment cannot be confirmed.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access pay-per-call onchain and URL safety APIs over MCP, covering transaction explanations, token approval checks, address inspection, contract risk heuristics, URL safety, gas snapshots, ENS resolution, calldata decoding, and wallet portfolio data. Payments are handled per call in USDC on Base via x402, with no signup or API key required.1MIT
- AlicenseAqualityBmaintenanceEnables AI agents to run a free fail-closed preflight gate on x402 payment challenges and transactions before signing, plus five USDC-paid on-chain truth checks covering arbitrage profitability, token safety, swap routing, quote validation, and trade sizing. Each check returns a verdict with pinned-block evidence and a verifiable receipt.9Apache 2.0
- AlicenseAqualityBmaintenanceLets AI clients call paid x402ai endpoints — embeddings, summaries, and short answers — paying per call in USDC on Base via the x402 protocol, with per-payment and per-session spend caps plus a free inspector for decoding any x402 endpoint's payment challenge. Runs locally over stdio, needs no hosted account, and can operate in quote-only dry-run mode.5139 npmMIT