Agents Trust

Agents Trust MCP

从 Claude Desktop、Cursor 或 Claude Code 中查找适合你任务的 API。推荐结果包含 URL、价格和调用详情。检查可返回某个确切端点 URL 的已存储证据。此 stdio 服务在你的电脑上运行。付费调用使用你自己的钱包；Agents Trust 不持有任何钱包密钥。

运行时需要 Node.js 20 或更高版本。通过 npm 安装；你的 MCP 宿主通过标准输入/输出启动它：

npx -y @agents-trust/mcp

仅在运行时启动器中提供钱包（参见配置）。如需改为从源代码构建，请参阅开发。

工具和费用

工具	输入	结果	费用
recommend	need；可选的 limit、live、max_price_usd、chain、view	适合你任务的 API 和调用详情	免费演示以外为 0.01 USDC
inspect	url；可选的 view	已存储的端点证据，不会调用提供方	端点最低报价的 1%，最低 0.001 USDC
receipt	payment_attempt_id	最终结算结果	免费
health	无	服务版本	免费

请宿主使用推荐结果中的确切端点 URL 调用 inspect。保留其固定查询参数。对于 inspect，view 接受 legacy、compact、evidence 或 debug；对于 recommend，它接受 legacy、compact 或 evidence。省略该参数时使用 API 的旧版响应。未知 URL 会返回无需付费的 404。API 会在付款前拒绝格式错误、包含凭据或指向私有网络的 URL。Inspect 绝不会调用或购买提供方的服务。

recommend 输入：need 长度为 2–300 个字符，且至少包含两个字母或数字；limit 为 1–5；live 可设为 1，以优先选择最近验证过的端点；chain 是 CAIP-2 网络，例如 eip155:8453；max_price_usd 是非负数值。receipt 接受付费回答中返回的 payment_attempt_id（UUID 版本 7）。

示例：请宿主使用 {"need":"weather","view":"compact"} 调用 recommend。免费演示内容可能会变更。max_price_usd 限制的是推荐的提供方价格，不限制推荐费用。调用推荐的 API 属于单独购买。

付费回答在可用时会包含 payment_attempt_id。使用 receipt 检查结算；收到回答并不代表结算已完成。待处理的回执可以免费再次查询。

配置

环境变量	默认值	用途
AGENTS_TRUST_ENABLE_PAYMENTS	未设置／已禁用	所有者主动授权：精确设为 true 后，每个服务进程最多可获得一次付款授权
AGENTS_TRUST_WALLET_PRIVATE_KEY	未设置	你的 EVM 私钥，须带 0x 前缀；付费调用必需
AGENTS_TRUST_MAX_CALL_USDC	0.01	单次 Recommend 或 Inspect 调用的最高费用，单位为 USDC
AGENTS_TRUST_SESSION_CAP_USDC	0.01	单个服务进程预留支出的上限

即使存在钱包密钥，付款仍处于禁用状态。钱包所有者可以在本地启动器中明确设置 AGENTS_TRUST_ENABLE_PAYMENTS=true，或选择启用该套件的付款选项。这会在金额上限内为进程授予一次授权；不会逐次调用请求人工确认。Agent 工具参数、服务响应或提供方指令都不能授予付款权限。请使用余额较低的专用钱包，并在 Base 主网上持有 USDC。服务会在本地签署 x402 授权，并且只将其发送到 https://api.agents-trust.com。它接受已公布的 Base USDC 资产和 Agents Trust 收款地址。地址变更需要更新服务。不支持其他付款网络。

限额接受最多六位小数的非负数字字符串。设为零会禁用付费调用。预留金额会计入签名尝试，包括失败或结果不确定的请求，并会一直保留到进程退出。进程会在签名前消耗其单次授权，即使签名或请求失败也不例外。提高金额上限不会授予第二次授权。免费调用和收据仍可用。重启服务会重置会话上限和授权。钱包所有者核对先前的尝试之前，请勿让主机自动重启已启用付款选项的服务。Recommend 和 Inspect 共用同一授权、预留上限和串行付款队列，包括并发调用。付费提交不会自动重试。如果结果不确定，请在再次付费调用前检查钱包和任何收据。

没有密钥时，免费工具和免费演示推荐仍可使用。付费 Recommend 或 Inspect 请求会返回一条说明应配置哪个变量的消息。请勿将密钥放入聊天、版本控制或 shell 历史记录。让本地密钥管理器或主机向子进程提供钱包变量。

Claude Desktop

将以下内容合并到 claude_desktop_config.json。免费配置无需密钥：

{
  "mcpServers": {
    "agents-trust": {
      "command": "npx",
      "args": ["-y", "@agents-trust/mcp"],
      "env": {
        "AGENTS_TRUST_MAX_CALL_USDC": "0.01",
        "AGENTS_TRUST_SESSION_CAP_USDC": "0.01"
      }
    }
  }
}

如需付费调用，请明确授予 AGENTS_TRUST_ENABLE_PAYMENTS=true，并通过安全的本地启动器向此进程提供 AGENTS_TRUST_WALLET_PRIVATE_KEY。GUI 应用需要 Node 可执行文件的完整路径，而且不一定会继承终端环境变量。

Cursor

在 ~/.cursor/mcp.json 或 .cursor/mcp.json 中使用相同的 mcpServers 块，并在服务条目中添加 "type": "stdio"（参见 Cursor 配置）。如需读取已注入 Cursor 环境的密钥，请将以下条目添加到服务的 env 对象中：

"AGENTS_TRUST_WALLET_PRIVATE_KEY": "${env:AGENTS_TRUST_WALLET_PRIVATE_KEY}"

请将钱包配置保存在本地；不要提交。

Claude Code

claude mcp add --transport stdio agents-trust -- npx -y @agents-trust/mcp

请参阅 Claude Code MCP 配置。启动 Claude Code 时，由钱包所有者选择是否启用付款，并由你的密钥管理器提供钱包变量。服务会从主机继承该变量。

开发

在不设置 AGENTS_TRUST_WALLET_PRIVATE_KEY 的情况下，在 shell 中从源码构建；即使该变量为空，构建和打包命令也会拒绝该变量。

git clone https://github.com/agents-trust/agents-trust-mcp.git
cd agents-trust-mcp
npm ci
npm run typecheck
npm run lint
npm test
npm run build

使用 node dist/index.js 运行本地服务。标准输出仅承载 MCP 消息。测试会在内存中生成一次性密钥，不会进行任何付款。开发测试需要 Node.js 22.13+ 或 24；CI 也会在 Node.js 20 上检查构建后的 stdio 服务。

npm run test:paid 是一项离线加密授权测试，使用生成的一次性密钥和模拟的 HTTP。没有测试会读取有资金的钱包或提交真实付款。.npmrc 禁用了依赖安装脚本；请使用 npm ci，以保留经过审查的锁文件。打包器也已在本地锁定。

采用 MIT 许可。请参阅 LICENSE。