RouteVerdict

route-verdict-mcp

独立仓库： 此服务从 QuincyGB/token-verdict-tools 中拆分出来，让每个 MCP 服务都拥有自己的 GitHub 仓库，便于目录收录和维护。PyPI 包名称（route-verdict-mcp）、版本和安装命令均保持不变。

一个通过 stdio 传输的 MCP 服务，可将 RouteVerdict 作为原生工具提供给任何 MCP 宿主——Claude Desktop、Cursor 或你自己的 Agent 运行时。

RouteVerdict 是一项按次付费的信任度和可用性检查服务，适用于 x402 端点：发送任意付费资源 URL，即可获取判定结果（TRUSTED / CAUTION / AVOID）、0–100 的信任评分、逐项扣分列表、对目标的实时 402 探测、已发布条款、发现模式质量、CDP Bazaar 和 PayAI 索引中的目录收录情况，以及与同一 URL 上次检查结果的差异。每次检查需支付 $0.05 USDC（在 Base 上），通过 x402 协议完成——无需账户或 API 密钥；付款即为身份验证。只会探测目标端点，不会向其付款。

工具

route_check——一个工具，即该服务的实际接口：

输入	类型	说明
resource_url	string（必填）	要审核的 x402 资源完整 URL

输出是服务的检查 JSON：resource_url、checked_at、verdict、score、reasons（逐项扣分）、liveness、terms、schema_quality、catalog 和 diff。

安装

pip install route-verdict-mcp

# Or from a checkout of this repository:
pip install .

需要 Python ≥ 3.10。服务固定使用 MCP v1 SDK API（mcp>=1.2,<2）。

配置

所有配置均来自操作者自己的环境——运行此服务的人需要提供自己的钱包。本包不包含任何密钥材料，包作者也不会看到你的密钥。

环境变量	必需	用途
AGENT_PRIVATE_KEY	付费调用时必需	持有 Base 上 USDC 的钱包 EVM 私钥（0x...）。在本地用于签署 x402 EIP-3009 授权。
AGENT_KEY_FILE	替代选项	包含该密钥的文件路径。
ROUTE_VERDICT_URL	否	覆盖服务基础 URL（默认为生产环境）。
ROUTE_VERDICT_MAX_AMOUNT_UNITS	否	每次调用的 USDC 微单位支出上限（默认值为 50000 = $0.05，即已知价格）。客户端拒绝签署价格超过此上限的请求。

未配置签名器时，工具绝不会付款。 收到 402 时，工具会将解析后的质询作为结构化错误返回——error: "payment_required"，并附上完整的 accepts 数组（scheme、network、asset、amount、payTo）——这样调用方 Agent 就能查看价格并决定如何处理，或使用自己的 x402 客户端结算质询。

MCP 宿主配置

Claude Desktop（claude_desktop_config.json）——其他通过 stdio 运行的 MCP 宿主配置方式相同：

{
  "mcpServers": {
    "route-verdict": {
      "command": "route-verdict-mcp",
      "env": {
        "AGENT_PRIVATE_KEY": "0xYOUR_OWN_WALLET_KEY"
      }
    }
  }
}

从检出代码而非安装包运行：

{
  "mcpServers": {
    "route-verdict": {
      "command": "python",
      "args": ["-m", "route_verdict_mcp"],
      "env": {
        "PYTHONPATH": "/path/to/route-verdict-mcp/src",
        "AGENT_KEY_FILE": "/path/to/your/agent.key"
      }
    }
  }
}

如果宿主配置允许，优先使用 AGENT_KEY_FILE，不要将密钥直接写入配置文件。

付款流程

客户端遵循标准 x402 v2 流程（与该服务用于实时目录收录付款的流程相同）：

1. 对 /v1/check 发送未付款的 POST 请求 → 返回 HTTP 402，质询以 base64 编码后放在 payment-required 标头中。
2. 从 accepts 中选取 exact / eip155:8453 条目。
3. 构造 EIP-3009 TransferWithAuthorization（validAfter: 0、validBefore: now + maxTimeoutSeconds、随机 32 字节 nonce），并根据质询所声明的 USDC 域（extra.name / extra.version）将其签名为 EIP-712 类型化数据。
4. 在 PAYMENT-SIGNATURE 标头中携带该载荷，重试完全相同的 POST 请求。服务端会通过其 facilitator（PayAI）验证并完成结算；结算收据会通过 payment-response 标头返回。

测试

pip install -e ".[dev]"
pytest

所有付款均为模拟（使用 httpx MockTransport，并在测试时生成一次性签名器）。402 测试样例来自生产环境中捕获的真实质询；付费流程测试会验证 EIP-712 签名确实可恢复出签名者地址。

安全说明

• 运行时会从环境中读取你的私钥，并且仅在本地用于签署付款授权。私钥绝不会被传输——x402 负载中包含的是签名，而不是密钥。
• 支出保护机制会将单次调用的金额限制在已配置的金额以内（默认值：正好为 $0.05）。
• 请使用专用的 Agent 钱包运行此工具，且钱包中只存放用于工作的资金，和为任何 Agent 提供资金的方式相同。