mcpField
X
x402 Tools

x402 Tools

远程服务
github.com/foxxx009开发工具05 周前更新
代码仓库

关于 x402 Tools

为 AI Agent 提供研究与数据工具的 MCP 服务,通过 x402 按次使用 USDC 付费。包含免费的 URL 检查,以及付费的网页、域名、GitHub、代币和研究工具。

主要功能

  1. 01获取 URL 内容并提取文本
  2. 02查询域名与 DNS 信息
  3. 03读取 GitHub 仓库信息
  4. 04读取 Base 代币数据
  5. 05生成仓库尽调报告
  6. 06汇总多 URL 研究简报

适用场景

  1. 01从受限沙盒获取网页内容
  2. 02核查域名或仓库信息
  3. 03采用仓库前评估其状况
  4. 04汇总带来源的多网址研究

MCP 相关

可通过本地运行或远程 Streamable HTTP 端点向 MCP 客户端提供工具。付费工具返回 x402 付款要求,兼容客户端重试并付款后继续;`free_url_check` 免费。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://fitze-x402-seller.app.workbuddy.host/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

13
参数类型必填说明
urlstring是目标 URL;可省略协议(缺失时会添加 https://)
maxCharsnumber否清理后文本的最大字符数(默认值 4000)

详细介绍

x402-tools-mcp

一个为任何 AI Agent 提供六种研究和数据工具的 MCP 服务,通过 x402 按次使用 USDC 在 Base 上付费。

无需 API 密钥。无需订阅。没有月度最低消费。只有在 Agent 实际调用工具时,你才需支付一两美分。

工具价格功能
web_fetch$0.01获取 URL 信息——状态、最终 URL、标题、清理后的文本和前 20 个链接。适用于沙盒无法访问开放网络的 Agent。
domain_intel$0.02RDAP 注册商信息及创建/到期日期、DNS 记录(A/MX/NS/TXT),以及通过 crt.sh 查询证书透明度历史记录。
github_repo$0.02仓库信息:星标数、复刻数、开放问题数、语言、许可证、最近推送时间和 README 摘录。
token_intel$0.02从 Base 主网读取 ERC-20 信息:名称、符号、精度、总供应量、USDC 余额。
repo_diligence$2.50深度仓库报告——发布频率、贡献者分布、问题/PR 健康状况、风险摘要。
web_brief$3.00整合多个 URL 的简报,并注明各来源。

为什么要做这个项目

Agent 沙盒经常被防火墙隔绝,无法访问开放网络。常见的变通办法——使用受 API 密钥保护的抓取服务——意味着你需要订阅、注册账户,还要承担月度最低消费,不管是否使用都得付费。x402 一举免去这三项:服务端返回 402 Payment Required,客户端签署 USDC 转账授权,然后调用继续执行。整个握手流程就是这样。

设置

1. 为钱包充值。 使用任何持有几美元 USDC 的 Base 钱包即可。无需 ETH——Gas 由结算协调方支付。

2. 导出密钥。

export X402_PRIVATE_KEY=0x<private key of that wallet>

3. 在 MCP 客户端中注册服务:

{
  "mcpServers": {
    "x402-tools": {
      "command": "npx",
      "args": ["-y", "x402-tools-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0x..."
      }
    }
  }
}

或者在本地运行:

git clone https://github.com/foxxx009/x402-tools-mcp
cd x402-tools-mcp && npm install
X402_PRIVATE_KEY=0x... node index.js

环境变量

变量必需默认值
X402_PRIVATE_KEY是—
X402_BASE_URL否https://fitze-x402-seller.app.workbuddy.host

X402_BASE_URL 可让你将同一服务指向自己的 x402 卖方。

哪些内容会离开你的机器

只有两项:工具参数,以及授权按报价金额转账 USDC 的 EIP-3009 签名。私钥不会离开进程。签名在本地完成;结算在 Base 上进行。

注意事项

  • 付款使用 Base 主网上的 USDC。测试网钱包无法使用。
  • 使用 X-PAYMENT 重试时,每次调用都会收费;402 响应始终会在你付款前说明确切金额。
  • repo_diligence 和 web_brief 价格较高,因为它们会执行实际的多次请求。请谨慎调用。

远程 MCP(零安装)

不想在本地运行任何东西?同一服务也提供远程 Streamable HTTP MCP 端点:

https://fitze-x402-seller.app.workbuddy.host/mcp

将其作为远程服务 URL 添加到任何 MCP 客户端(Claude Desktop、Cursor 等)。free_url_check 无需付费即可运行;付费工具会返回 HTTP 402 和 x402 付款要求,并在支持 x402 的客户端重试时通过 Base 上的 USDC 完成结算。该服务已列入官方 MCP Registry,名称为 io.github.foxxx009/x402-tools-mcp。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。