SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI编程工具anchor-x402-mcp

anchor-x402-mcp

anchor-x402-mcp 是一个 MCP 服务器，把 anchor-x402 的多项服务封装成可供 AI 智能体调用的工具，涵盖 OFAC 筛查、钱包情报、哈希锚定、签名证言、交易解码以及 ENS/SNS 解析等功能。它通过 x402 协议在 Base 主网上按调用次数以 USDC 付费，无需 API 密钥或订阅。提供两种传输方式：stdio 方式需在本地进程中配置已充值的 EVM 私钥（ANCHOR_WALLET_PRIVATE_KEY）并代为支付；Streamable HTTP 方式通过 https://api.anchor-x402.com/mcp 接入，无需安装或交出密钥，使用 PAYMENT-SIGNATURE 头按次支付，并额外暴露 roll_random、investigate_wallet、ledger_summary、ledger_report 四项服务（共 18 项）。stdio 版本暴露 14 项工具，单次调用费用 0.001 至 0.05 美元，兼容 Claude Desktop、Claude Code、Cursor、Codex、Continue 等任意 MCP 客户端。

访问官网

工具介绍

用途

anchor-x402-mcp 是一个 MCP 服务器，将 anchor-x402 的服务暴露为智能体可直接调用的工具，常用于在 Base 主网和 Solana 上进行哈希锚定、OFAC 筛查、钱包情报查询、签名证言、交易解码以及 ENS/SNS 名称解析等操作。它面向 Claude Desktop、Claude Code、Cursor、Codex、Continue 等支持 MCP 的客户端。

两种传输方式

  • stdio（本包）：需要本地进程持有已充值的 EVM 私钥（环境变量 ANCHOR_WALLET_PRIVATE_KEY），由该进程代用户为每次调用付费。使用方便，但相当于把热钱包密钥交给进程。
  • Streamable HTTP：POST https://api.anchor-x402.com/mcp，无需安装、无需交出密钥。它暴露全部 18 项服务（比本包多四项：roll_random、investigate_wallet、ledger_summary、ledger_report），通过 PAYMENT-SIGNATURE 请求头按次付费，密钥始终留在用户一侧。 对原生支持远程 MCP 的客户端可直接使用该 URL；仅支持启动 stdio 进程的客户端可用桥接方式接入。

协议与支付方式

支持的协议版本：2026-07-28、2025-11-25、2025-06-18、2025-03-26，同一端点同时覆盖无状态时代和 initialize 握手时代。server/discover 与 tools/list 免费，tools/call 收费。 支付在 MCP 内部呈现为普通 x402 流程：未付费的 tools/call 返回的是结果（而非 JSON-RPC 错误），其中 isError: true，挑战信息位于 structuredContent.accepts，并带有规范的 payment-required 头。签署其中一个选项后，用 PAYMENT-SIGNATURE 重试完全相同的调用即可。把挑战作为结果返回是有意为之——智能体可以读取并支付，而 JSON-RPC 错误会在模型看到之前就被客户端吞掉。

工具与费用（stdio 版本）

共 14 项工具，单次调用 $0.001–$0.05：

  • 商品化基础能力（9 项，$0.001–$0.02）
  • 通用 LLM 端点（5 项，$0.01–$0.05），于 v0.2 加入

调查器（/v1/investigate，$1.77，异步）和位于 chat.anchor-x402.com 的托管聊天机器人不在 MCP 内，分别通过 HTTP API 和浏览器直接访问。

使用方式（配置示例）

Claude Desktop：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），重启后即可让智能体调用。示例提问：“Anchor the hash 7646dda1564bde0ef3f3971f4c002962df64246da4aa1d8c47247e7632494710 on mainnet”——它会调用 anchor_hash 并从钱包支付 $0.005 USDC。 项目级：添加到项目的 .mcp.json。 Codex CLI（OpenAI）：编辑 ~/.codex/config.toml，重启 codex，输入 /mcp 确认 anchor-x402 出现在已加载服务器列表中。 ChatGPT Desktop：Settings → Integrations → MCP servers → Add server，粘贴配置并重启，14 项工具会出现在启用工具使用的任意对话中。 Cursor：编辑 ~/.cursor/mcp.json（全局）或 <project>/.cursor/mcp.json（项目范围）。 OpenAI Agents SDK（编程方式）：同样的包与环境变量，以编程方式而非配置驱动。 Continue / Smithery / 通用 MCP 客户端：command: npx，args: [-y, anchor-x402-mcp]，env 中携带钱包密钥；MCP SDK 负责传输。也可通过 Smithery 一行命令安装（将 --client claude 替换为 cursor、codex、windsurf 等）。 该服务器通过 stdio 讲 MCP 协议，可管道接入任何兼容 MCP 的客户端。

钱包充值

需要为 ANCHOR_WALLET_PRIVATE_KEY 对应的钱包在 Base 主网上准备 USDC。任意金额均可——即使 $1 也能购买 100 次 anchor 调用或 1000 次商品层调用。 Base 上的 USDC 合约：0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913。可从以太坊主网经 bridge.base.org 跨链，或在 Coinbase 直接购买并提现到 Base。

支付机制

MCP 服务器通过 x402（Coinbase 的开放 HTTP 原生微支付协议）签署支付。每次请求：命中 anchor-x402 端点 → 收到带支付要求的 402 → 服务器用你的私钥签署 USDC 转账授权 → 带签名支付重试请求，API 通过 Coinbase 的 facilitator 结算。亚秒级完成，无账本、无账号。

环境变量与安全建议

若未设置 ANCHOR_WALLET_PRIVATE_KEY，付费工具调用会返回友好的 402 消息说明如何设置。/health 和 /openapi.json（未暴露为工具，但可通过直接 curl 访问）无需付费即可工作。 私钥存放在 MCP 客户端的配置文件中。应视作热钱包——只放你愿意让其自主花费的金额。建议：专门为智能体使用生成一个新钱包；定期充值；不要复用持有大量资金的钱包。该 MCP 服务器只向 anchor-x402 已知的金库地址（可在 402 响应中看到）签署 USDC 支付授权，无法把钱包资金转往任意地址。源代码完全开源，安装前建议审计。

验证锚定回执

每次 anchor_hash 和 attest_decision 调用都会返回 Base + Solana 的交易 URL，可在公开区块浏览器上独立验证，无需重新付费：

  • Base：https://basescan.org/tx/<base.tx> —— Input Data 字段包含 merkle root
  • Solana：https://solscan.io/tx/<solana.tx> —— Memo 程序数据包含相同的十六进制 链上字节即为回执，API 响应只是围绕它的便捷封装。

故障排查

  • “Payment required (402). Set ANCHOR_WALLET_PRIVATE_KEY...”：未配置钱包，请把环境变量加入 MCP 配置并重启 Claude Desktop。
  • “Payment failed (402). The wallet may be out of USDC...”：钱包余额不足。向服务器启动日志中显示的地址（会以 payer=0x… 写到 stderr）发送 Base 上的 USDC。
  • “anchor-x402 request failed: ...”：网络或 DNS 问题。检查 https://api.anchor-x402.com/health 是否返回 200；否则查看状态页。

相关链接

  • 实时 API：https://api.anchor-x402.com
  • MCP over HTTP：https://api.anchor-x402.com/mcp（全部 18 项工具，无需交出密钥）
  • MCP 服务器卡片：https://anchor-x402.com/.well-known/mcp/server-card.json
  • 站点/信任门户：https://anchor-x402.com
  • 状态页：https://anchor-x402.betteruptime.com
  • 服务端源码：https://github.com/hypeprinter007-stack/anchor-x402
  • MCP 服务器源码（本仓库）：https://github.com/hypeprinter007-stack/anchor-x402-mcp
  • x402 协议：https://github.com/coinbase/x402
  • MCP 规范：https://modelcontextprotocol.io

同类工具

查看分类