anchor-x402

anchor-x402-mcp

MCP 服务将 anchor-x402 的 14 项服务公开为工具，供任何 Claude Desktop / Cursor / Codex / Continue Agent 调用。通过 Base 主网上的 x402 使用 USDC 按次付费——无需 API 密钥或订阅。

两种传输方式——根据钱包密钥由谁持有来选择

**此软件包（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 标头按次付款，因此密钥始终不会离开你身边。

{
  "mcpServers": {
    "anchor-x402": { "url": "https://api.anchor-x402.com/mcp" }
  }
}

原生支持远程 MCP 的客户端可直接使用上面的 url 形式。若客户端只能启动 stdio 进程，则可通过桥接器连接：

{
  "mcpServers": {
    "anchor-x402": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.anchor-x402.com/mcp"]
    }
  }
}

支持的协议版本：2026-07-28、2025-11-25、2025-06-18、2025-03-26——同一端点同时支持无状态阶段和 initialize 握手阶段。server/discover 和 tools/list 免费；tools/call 需要付费。

支付采用常规的 x402 流程，只是通过 MCP 内部呈现，而非在 MCP 外部进行：未付款的 tools/call 会返回一个结果（而非 JSON-RPC 错误），其中 isError: true，并在 structuredContent.accepts 中包含付款挑战，同时附带标准的 payment-required 标头。为其中一个选项签名，然后使用 PAYMENT-SIGNATURE 重试完全相同的调用。挑战会以结果形式返回，这是有意为之——Agent 可以读取挑战并付款；如果返回 JSON-RPC 错误，客户端会将其吞掉，模型便无从得知。

服务器卡片：/.well-known/mcp/server-card.json。examples/agent/mcp-paid-call.mjs 中提供了一个完整的客户端示例，其中包括一个将标准 x402 fetch 封装器桥接到 MCP 结果格式的适配器。

本 README 的其余部分介绍 stdio 软件包。

Agent 可获得的功能

14 个工具，每次调用 $0.001–$0.05。

通用基础工具（9 个，$0.001–$0.01）：

工具	价格	功能
anchor_hash	$0.005	并行将任意 32 字节哈希锚定到 Base + Solana 主网；返回两个交易 URL
screen_wallet	$0.005	钱包风险预检——OFAC 制裁 + 地址信誉（盗币器／钓鱼／混币器）→ 允许／审核／拦截
attest_decision	$0.010	为决策出具证明——自行签名或由资金库签名——然后进行双链锚定；可在 /v1/attest/verify 免费重新验证
decode_tx	$0.001	对任意主网交易（Base / Ethereum / Solana）进行结构化解码
resolve_name	$0.001	跨链名称解析（ENS、Bonfida SNS）
token_price	$0.001	根据代币符号或链 + 合约查询任意代币的美元现货价格
decode_calldata	$0.001	对原始 EVM calldata 进行 4byte 选择器 + ABI 参数解码
parse_datetime	$0.001	将自由格式的日期时间字符串转换为结构化 ISO 8601 格式
intel_wallet	$0.005	打包的钱包情报：一次调用即可获取余额 + 活动 + 身份 + 制裁信息

通用大模型端点（5 个，$0.01–$0.05）——在 v0.2 中新增：

工具	价格	功能
roast	$0.05	对任意目标进行妙趣横生的 3–5 段吐槽——钱包、推文、代码、想法，或任何内容
oracle	$0.05	是／否预言机。返回 YES/NO/MAYBE + 原因 + 双链锚定的 (question | answer | timestamp) 哈希。为提问时间提供加密凭证。
tldr	$0.01	将 URL（最多获取 500KB）或粘贴的文本总结为 3–5 条简洁要点
aura	$0.01	返回颜色、等级（S/A/B/C/D/F）、0–9999 分数，以及简短有力的 2–3 句气场解读
grade	$0.01	学术字母等级（A+ 到 F），附带红笔边注和一段总结

调查工具（/v1/investigate，$1.77，异步）和托管式聊天机器人 chat.anchor-x402.com 不包含在 MCP 中——它们分别通过 HTTP API 和浏览器直接访问。

MCP 服务会自动回本——每次调用都会自动从你的钱包扣款。无需预存、无需 API 密钥，也无需账户。

安装

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "anchor-x402": {
      "command": "npx",
      "args": ["-y", "anchor-x402-mcp"],
      "env": {
        "ANCHOR_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
      }
    }
  }
}

重启 Claude Desktop。询问：“将哈希 7646dda1564bde0ef3f3971f4c002962df64246da4aa1d8c47247e7632494710 锚定到主网”——它会调用 anchor_hash，并从你的钱包支付 $0.005 USDC。

Claude Code

添加到项目的 .mcp.json：

{
  "anchor-x402": {
    "command": "npx",
    "args": ["-y", "anchor-x402-mcp"],
    "env": {
      "ANCHOR_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
    }
  }
}

Codex CLI (OpenAI)

编辑 ~/.codex/config.toml：

[mcp_servers.anchor-x402]
command = "npx"
args = ["-y", "anchor-x402-mcp"]

[mcp_servers.anchor-x402.env]
ANCHOR_WALLET_PRIVATE_KEY = "0xYOUR_BASE_WALLET_PRIVATE_KEY"

重启 codex。输入 /mcp，确认已加载的服务列表中显示 anchor-x402。

ChatGPT Desktop

设置 → 集成 → MCP 服务 → 添加服务。粘贴：

{
  "command": "npx",
  "args": ["-y", "anchor-x402-mcp"],
  "env": {
    "ANCHOR_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
  }
}

保存并重启后，在任何启用了工具调用的聊天中都会出现这 14 个工具。

Cursor

编辑 ~/.cursor/mcp.json（全局）或 <project>/.cursor/mcp.json（项目范围）：

{
  "mcpServers": {
    "anchor-x402": {
      "command": "npx",
      "args": ["-y", "anchor-x402-mcp"],
      "env": {
        "ANCHOR_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
      }
    }
  }
}

OpenAI Agents SDK（编程方式）

from openai_agents import Agent, MCPServerStdio

mcp = MCPServerStdio(
    command="npx",
    args=["-y", "anchor-x402-mcp"],
    env={"ANCHOR_WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"},
)
agent = Agent(name="researcher", model="gpt-4o", mcp_servers=[mcp])

使用相同的包和环境变量，以编程方式接入，而不是通过配置驱动。

Continue / Smithery / 通用 MCP 客户端

配置格式相同——command: npx、args: [-y, anchor-x402-mcp]，环境变量中包含你的钱包密钥。传输由 MCP SDK 处理。

也可通过 Smithery 一行命令安装：

npx -y @smithery/cli install anchor-x402-mcp --client claude

（将 --client claude 替换为 cursor、codex、windsurf 等。）

独立运行

ANCHOR_WALLET_PRIVATE_KEY=0xYOUR_KEY npx anchor-x402-mcp

通过标准输入／输出使用 MCP 协议。可将其管道连接到任何兼容 MCP 的客户端。

为钱包充值

你在 ANCHOR_WALLET_PRIVATE_KEY 中设置的钱包需要有 Base 主网上的 USDC。任意金额均可——即使只有 1 美元，也能支付 100 次 anchor 调用或 1000 次商品级调用。向钱包的 Base 地址发送 USDC：

• Base 上的 USDC 合约：0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• 通过 bridge.base.org 从 Ethereum 主网桥接
• 直接在 Coinbase 上购买并提现到 Base

MCP 服务通过 x402 签署付款——这是 Coinbase 推出的开放式 HTTP 原生微支付协议。每次请求：

1. 访问 anchor-x402 端点
2. 收到包含付款要求的 402 响应
3. 服务使用你的私钥签署 USDC 转账授权
4. 使用签名后的付款重试请求——API 通过 Coinbase 的清算服务完成结算

你会看到响应，同时钱包中的 USDC 余额会按调用价格扣减。整个过程不到一秒，无需账本或账户。

环境变量

变量	必填？	用途
ANCHOR_WALLET_PRIVATE_KEY	付费调用必填	EVM 私钥。钱包用于支付 x402 调用费用。
ANCHOR_API_URL	否	覆盖 API 基础 URL。默认值：https://api.anchor-x402.com。适用于针对可自托管分支进行开发。

如果未设置 ANCHOR_WALLET_PRIVATE_KEY，付费工具调用会返回友好的 402 消息，说明如何设置该变量。/health 和 /openapi.json（不会作为工具公开，但可通过直接运行 curl 访问）无需付款即可使用。

安全须知

• 私钥存放在 MCP 客户端的配置文件中。请将其视为热钱包——只存入你愿意让其自主支出的金额。
• 建议：专门为 Agent 使用生成一个新钱包。定期充值；不要重复使用存有大量资金的钱包。
• MCP 服务只会向 anchor-x402 已知的财库地址签署 USDC 付款授权（可在 402 响应中查看）。它无法将你的钱包资金转到任意地址。
• 源代码完全开源，位于 github.com/hypeprinter007-stack/anchor-x402-mcp。安装前请先审查。

验证 anchor 收据

每次 anchor_hash 和 attest_decision 调用都会返回 Base 和 Solana 交易 URL。你可以在公开区块浏览器上独立验证——Agent 无需再次付费即可确认 anchor 存在：

• Base：https://basescan.org/tx/<base.tx>——输入数据字段包含 merkle 根
• 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...”
钱包余额不足。向日志中显示的钱包地址发送 Base 上的 USDC（服务启动日志会将 payer=0x… 输出到 stderr）。

“anchor-x402 request failed: ...”
网络或 DNS 问题。检查 https://api.anchor-x402.com/health 是否返回 200；如果没有，请查看状态页面。

链接

• 在线 API： https://api.anchor-x402.com
• 通过 HTTP 使用 MCP： 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

许可证

MIT