Trustbench

@trustbench/mcp

TrustBench 的原生 MCP 服务，面向 TrustBench——为 x402 Agent 支付提供非托管式路由与审计层。

为任何支持 MCP 的宿主添加三个只读工具：

工具	功能
get_rankings	按能力评分的 x402 服务商列表。无需 API 密钥。
get_receipt	按 ID 获取任意 TrustBench 收据（rcpt_… / rrcpt_…）。无需 API 密钥。
verify_receipt	确认 Ed25519 签名及链上状态。提供两种模式：按 ID 查询，或离线验证收据 JSON。无需 API 密钥。

适用于 Claude Desktop、Claude Cowork、Grok（xAI Connectors）、Kimi Code CLI、Cherry Studio、Cursor 及任何兼容 MCP 的宿主。

设置

将以下内容添加到宿主的 MCP 配置文件中（例如，Claude Desktop 使用 claude_desktop_config.json，Kimi 使用 ~/.kimi/mcp.json）：

{
  "mcpServers": {
    "trustbench": {
      "command": "npx",
      "args": ["-y", "@trustbench/mcp"]
    }
  }
}

重启宿主应用。上述三个工具会立即可用——无需 API 密钥或账户。

环境变量

变量	默认值	说明
TRUSTBENCH_BASE_URL	https://trustbench.io	覆盖 API 基础 URL（便于本地开发）。

工具返回内容

get_rankings — 返回符合所请求能力的评分服务商 JSON 数组。能力包括：search、inference、data、media、infra。评分基于 HEAD 探测存活性检查得出（来自同一主机的 3 次采样）。完整评分公式请参阅 trustbench.io/methodology。

get_receipt — 返回完整的签名收据信封。收据签发后不可更改。Phase 3 ID 以 rcpt_ 开头，Phase 4 路由收据以 rrcpt_ 开头。

verify_receipt — 提供两种模式（恰好提供一种输入）：

• 查询模式（receipt_id）— 从 trustbench.io 获取收据，并重新执行 Ed25519 和链上验证。适用于 Agent 只有 ID 的情况。
• 离线模式（receipt_json）— 使用已发布的公钥验证 Agent 从第三方收到的完整 {receipt, signature} 信封，无需信任数据库。适用于第三方验证场景。

两种模式都会返回 JSON 摘要，其中包含 signature_valid（布尔值）、on_chain_verified（适用时为布尔值）、signature_alg（ed25519）和 pubkey_url。如需零网络验证且无需与 TrustBench 往返通信，请改用 npm 包 @trustbench/verify-receipt。

路由工具（v1.5）

route_quote 和 route_settle（付费路由流程）需要 tb_live_… API 密钥，并将在下一版本中发布。请通过私信 X 上的 @TrustBench 申请访问权限。

技术细节

• 传输方式：stdio（JSON-RPC 2.0）——MCP 标准
• 除 Node.js 内置模块外，无外部依赖
• 要求 Node ≥ 18（使用原生 fetch 和 readline）
• 源码：github.com/lithvall/TrustBench

相关软件包

• @trustbench/verify-receipt — 独立的离线 Ed25519 收据验证工具