Tensorfeed X402 Base Mcp

@tensorfeed/x402-base-mcp

用于验证 Base 主网 x402 USDC 结算的只读 MCP 服务。将其接入任何兼容 MCP 的 Agent（Claude Desktop、Claude Code、Cursor、ChatGPT），即可独立审计链上的 x402 付款收据、解析发布者的 .well-known/x402 清单，并检查 AFTA 联邦状态。无需私钥，无需签名，不会广播交易。

npm install -g @tensorfeed/x402-base-mcp

与 Coinbase Base MCP 的关系

Coinbase 推出了 Base MCP（官方的 mcp.base.org 服务，于 2026 年 5 月上线），作为交易端 MCP：它将 Agent 连接到 Base Account，并允许 Agent 提议兑换、转账和 x402 付款，由用户在钱包中批准。

本软件包 @tensorfeed/x402-base-mcp 是验证端 MCP。完成 x402 付款后（无论是通过 Base MCP、服务端 @coinbase/x402 中间件，还是其他 x402 客户端），此服务都能让调用它的 Agent 独立检查链上结算、解析发布者的 /.well-known/x402 清单并审计收据。只读链上信息，不需要钱包。

两者互为补充，并非竞争关系。使用 Base MCP 付款，使用本 MCP 验证。

为什么需要单独的验证 MCP

x402 是一种付款协议，Agent 可通过它在 Base 上使用 USDC 向商家付款，以获取付费 API 响应。Agent 收到付款收据后，有两种方式可以确认结算是否确实如收据所述发生：

1. 信任商家
2. 自行读取链上的 Transfer 事件

大多数现有的 EVM MCP 服务要么需要私钥（这样 Agent 也能发送交易，在操作上有风险，且验证并不需要此功能），要么是不了解 x402 的通用多链读取工具。本服务是只读且支持 x402 的选择。将其接入 Claude Desktop 或 Claude Code 会话，任何 Agent 都能在无需操作钱包的情况下验证 x402 付款。

TensorFeed 专用工具（verify_afta_federation、tf_payment_lookup）基于 TF 的规范接口组合使用相同的基础功能，并演示了这种模式。可按需使用，也可忽略；通用工具本身即可正常工作。

安装

Claude Desktop

添加到 claude_desktop_config.json：

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

Claude Code

claude mcp add tensorfeed-x402-base -- npx -y @tensorfeed/x402-base-mcp

可选：使用自己的 RPC

服务默认使用公共 Base RPC（https://mainnet.base.org），适用于一般用途。对于更繁重的工作负载，可通过 TENSORFEED_RPC_URL 设置 Alchemy 或 Infura URL。URL 必须符合 src/rpc/allowlist.ts 中的允许列表；否则会回退到公共端点，并向 stderr 记录警告。

export TENSORFEED_RPC_URL="https://base-mainnet.g.alchemy.com/v2/YOUR_KEY"

如果你还没有账户，可通过以下联盟链接注册：

• Alchemy：https://www.alchemy.com/
• Infura：https://www.infura.io/

工具

通用 Base 读取

工具	描述
balance	地址的原生 ETH 余额
usdc_balance	地址的 USDC（Circle 原生跨链桥接）余额
block_number	最新的 Base 区块号
get_tx_receipt	完整的交易收据，包含状态、gas 和日志摘要
call	只读合约调用（eth_call，不会广播交易）
recent_transfers	指定地址在最近 N 个区块内涉及的 USDC Transfer 事件

x402 原生验证

工具	描述
verify_x402_settlement	给定交易哈希、预期接收方和预期 USDC 数量，返回链上 Transfer 事件是否匹配的结构化判定。
parse_x402_manifest	获取 https://{domain}/.well-known/x402.json，并返回结构化清单。
usdc_recent_payments_to	指定地址在最近 N 个区块内收到的 USDC 转账；用于查看商家一侧的情况。
probe_x402_endpoint	探测任意 https URL，并报告其是否返回包含 accepts[] 的规范 x402 付费 402 响应。
decode_x402_payment_payload	离线解码 base64 编码的 X-PAYMENT 标头（Coinbase x402 V2）：返回 scheme、network、version、EIP-3009 授权和签名。

TensorFeed 版本

工具	描述
verify_afta_federation	调用 TensorFeed 的 AFTA 认证端点，检查某个域名并返回带评分的检查清单。
tf_payment_lookup	检查某个交易哈希是否为向 Base 上 TensorFeed 官方钱包支付的 USDC。
x402_publisher_health	返回由 TensorFeed 每小时 x402 状态探测监控的某个域名的当前结果、24 小时／7 天正常运行时间及近期数据序列。
afta_federation_members	返回经确认的 AFTA 联盟成员的官方精选列表（TF 源站及联盟成员）。

示例

验证 x402 结算（适用于 TensorFeed 首笔官方 V2 支付）：

verify_x402_settlement({
  tx_hash: "0xe20c57d8aa6df63f75ce7a4e4c0cab492eb7fa672a23cd8fd59967eb6b66bd67",
  expected_recipient: "0x549c82e6bFC54bdaE9A2073744CBC2AF5D1FC6D1",
  expected_amount_usdc: "0.02"
})
// returns { ok: true, verified: true, matches: [...] }

查看发布者的 x402 清单：

parse_x402_manifest({ domain: "tensorfeed.ai" })

检查 AFTA 认证：

verify_afta_federation({ domain: "tensorfeed.ai" })

威胁模型

只读的链上可见性 MCP。完整说明请参阅 SECURITY.md；简要说明如下：

• 没有私钥，不签名、不广播。此服务无法转移资金。
• 输入验证器会检查每个工具的输入，并拒绝格式错误的输入（校验和错误、哈希格式错误、URL 形式的域名、私有／环回主机名）。
• 输出清理会从返回给调用 Agent 的所有字符串中剔除 C0/C1 控制字符和零宽／方向覆盖标记。
• 外部字符串带有 _origin: "external" 标记，以便调用 Agent 知道该值来自第三方。
• 序列化后的工具输出设有 50 KB 响应上限；超出上限的响应会折叠为结构化存根。
• RPC 允许列表将自托管用户限制在已知端点；拒绝任意 URL，并回退到公共 Base RPC。
• 没有遥测，不回传数据、不做分析。
• 来源证明：npm 发布包通过 GitHub Actions OIDC 发布，并附有加密来源证明。使用 npm audit signatures 验证。

请将安全问题报告至 [email protected]。对于尚未修复的漏洞，请勿提交公开问题或 CVE。

许可证

MIT

相关链接

• Coinbase Base MCP - Base 官方交易端 MCP。搭配此软件包即可完成完整的支付与验证流程：Base MCP 对 x402 支付进行签名，此软件包独立确认链上的结算。
• @tensorfeed/mcp-server - 配套软件包，即 TensorFeed 数据 MCP（新闻、状态、模型、基准测试、高级端点）。两者职责互补：此服务在链上验证 x402 支付；mcp-server 则将 TF 数据 API 封装为 MCP 工具。
• TensorFeed - AI 生态系统数据层
• TensorFeed 开发者 - 面向 AI Agent 的免费及高级 API
• Agent 公平交易协议（AFTA） - 诚实 Agent 商务的开放标准
• x402 规范 - 此 MCP 用于验证的支付协议