x402station-mcp

x402station-mcp

适用于 x402station.io 的 MCP 适配器。x402station.io 是 x402 Agent 商务的独立风险信号层。提供 x402station.io 的 Preflight，以及 Forensics、Catalog Decoys、Alternatives、Credits、Watch 和 Whats New。任何使用模型上下文协议的 Agent，都能在签署 PAYMENT-SIGNATURE 前获取端点证据，包括 诱饵、僵尸端点、价格陷阱、从未获得付款、延迟、签名／结算检查，然后再付款。

x402station.io 每 10 分钟独立探测一次 agentic.market 上列出的所有端点，并将探测历史与 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 位十六进制私钥。账户必须持有 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 工作流

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()，并将结果与即将访问的 URL 集合做差集比较。

可组合使用

x402station 会在 Agent 付款前检查 端点 是否安全（是否为诱饵／僵尸端点／价格陷阱／从未获得付款）。它也适合搭配 负载 安全检查，在签署前筛查付款元数据中的 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。这两个服务由不同团队独立开发，这是有意为之——保持信号彼此独立正是关键所在。这只是组合使用的参考，并非背书；筛查工具的行为和限制请参阅其代码库。

链接

• 服务：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]
• Bug 报告：https://github.com/sF1nX/x402station-mcp/issues
• 安全问题披露（RFC 9116）：https://x402station.io/.well-known/security.txt

许可证

MIT