x402 Triage MCP

x402-triage-mcp

用于无支付 x402 表面排查、402 Index 健康检查和付费审核交接的 MCP 服务。

它提供三个 MCP 工具：

• triage_x402_surface 通过 Tate Programs 公共排查 API 检查一个公开的 x402、MPP、Pay.sh、OpenAPI、manifest 或 HTTP 402 端点。
• watch_402_index 搜索公开的 402 Index 元数据，查找服务提供方健康状况、支付有效性和域名验证信号。
• x402_paid_paths 返回付费 x402 API 端点、服务目录、AgentCard 和固定范围的审核链接。

这些工具不会发送 X-PAYMENT、钱包签名、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，供选择购买单独审核的团队使用。

对于 Agent 商务审核，此服务会报告目标表面是否提供了买家在启用实际支出前所期望的安全控制：

• 支出限额：应在 Agent 付款前明确每次调用和总预算上限。
• 审批检查点：支付设置和高风险支出应要求用户或策略执行可见的审批步骤。
• 收款方验证：付费请求应限制为预期的域名、商户、钱包地址或已签名的注册表条目。
• 重放保护：质询和结算回调应使用 nonce、过期时间、幂等键、已签名资源或等效控制措施。
• 元数据最小化：支付元数据应避免包含私有用户上下文、机密和不必要的资源详情。
• 收据和审计跟踪：成功支付应生成交易 ID、收款方、金额、原因和策略证据。

开发

npm install
npm run check