用途
true402 的 MCP 服务器用于把 true402 机器原生市场接入 AI 智能体,让智能体以按次付费方式使用 AI 推理、Web 工具与链上工具。支付走 x402 协议(HTTP 402 微支付,USDC,Base 链)。官方强调无需账号、无需 API 密钥:智能体的钱包就是它的身份。
主要能力
根据官方资料,该服务器提供 11 个工具,覆盖代币 rug/honeypot 安全检查、新交易对与鲸鱼 swap 信号、SEO/GEO 审计、网页提取、链接预览以及 LLM 推理。工具从实时目录自动发现,市场上新出现的工具会自动出现。
官方提供一个可复制参考示例 examples/token-safety/:一个与框架无关的 x402 客户端,以及一个可直接接入的 LangChain 工具,可对任意 Base 代币做 rug/honeypot 检查,示例价格为 $0.005/次。
使用方式
要求 Node.js ≥ 20,服务器通过 stdio 运行,可将任意 MCP 客户端指向它。
接入 Claude Desktop / Claude Code,可加入 MCP 配置(claude_desktop_config.json,Claude Code 使用 .mcp.json)。
接入 Cursor / Cline / 其他 MCP 客户端:command 为 npx,args 为 ["-y", "@true402.dev/mcp-server"],并配置 WALLET_PRIVATE_KEY 环境变量。
官方还列出可用的集成方式(同一套链上检查,各有安装命令):MCP(Claude Code / Desktop、Cursor、Hermes)、Hermes Agent、OpenClaw、ElizaOS、LangChain、CrewAI、Vercel AI SDK、Coinbase AgentKit、Virtuals GAME、CLI。
安全方面,官方说明密钥只从环境变量读取,绝不会被记录、回显或返回;建议使用专用的低余额钱包,只充入打算花费的金额。
支付流程
- 工具在无支付的情况下调用 true402 端点。
- 服务器返回 402,并附上可接受的支付选项(Base 上的 USDC)。
- 该 MCP 服务器用你的钱包签署 EIP-3009 transferWithAuthorization。
- 用 PAYMENT-SIGNATURE 头带上已签名支付重试(x402 v2),服务端验证并响应。
- 结算在链上完成。你的钱包只支付 USDC,gas 由 facilitator 赞助。
付费规则(官方说明)
以下规则属于该服务而非本包,任何客户端都适用:
- 必须支付 402 报价中的精确金额。少付会被拒绝;多付会被以 403 拒绝且永不计入——结算提交的是已签署的金额,没有退款路径,多出的部分会被直接收走。金额相等也是授权与其报价资源绑定的条件。
- 一次授权只购买一次响应。重放会被拒绝,而非重复扣费。
- 仅在成功时收费。只有当端点返回 2xx 时才提交结算;若出错或超时,已签署的授权不会被提交,因此不存在需要退款的情况。
- 部分端点按客户端 IP 每天提供若干次免费调用,无需钱包。具体哪些见 OpenAPI 规范中各操作的描述。
其他信息
当本服务器有新版本发布时,会话的第一个工具结果会附带一行提示和新版本安装命令,不阻塞任何操作,每个进程只显示一次。
价格在官方说明中为示意性质,以实时 402 挑战为准。
相关链接:市场 https://true402.dev ;免费 Telegram rug 检查机器人(无需钱包)https://t.me/True402bot ;实时工具目录 https://true402.dev/api/v1/services ;x402 协议 https://x402.org ;完整规则 true402.dev/terms ;日志与保留说明 true402.dev/privacy 。