x402-tools-mcp

@melis-ai/x402-tools-mcp

为 Agent 构建者提供简洁可靠的基础设施。22 个按调用付费的实用工具，通过 MCP 服务提供——抓取、验证、嵌入、存储、审核、通知、转换、防止循环调用。**无需账户、API 密钥或订阅。**通过 x402 协议使用 Base 上的 USDC 付款。

npx @melis-ai/x402-tools-mcp

→ 查看包含价格和实时示例的完整目录：agents.melis.ai → 标准的 5 步 RAG 工作流：agents.melis.ai/pipelines/rag → 5 分钟快速入门：agents.melis.ai/docs/getting-started

---

工具目录（22）

工具	价格（USDC）	描述
list_services	免费	返回包含价格和端点 URL 的完整目录
cacheserve	$0.001	使用服务端缓存获取 URL，避免重复请求源站
docconvert_text	$0.001	格式转换：md↔html、json↔csv、html→txt 等
intentflow	$0.001	用于多 Agent 委派的上下文移交中继（异步，返回 retrieve_url）
memoryserve_write	$0.001	将文本和嵌入存储到 Qdrant + SQLite 中，并按 agent_id 命名空间隔离
memoryserve_query	$0.001	通过语义查询检索最相似的记忆
memscrub	$0.001	扫描检索到的 RAG 内容，检测间接提示词注入（10 种模式）
notifyrelay_webhook	$0.001	向 URL POST JSON 负载，并可选择使用 HMAC-SHA256 签名
schemagate	$0.001	根据 JSON Schema 验证 JSON 响应，失败时返回提示
loopwall_hop	$0.0005	验证已签名多 Agent 链中的一跳（循环／预算控制）
loopwall_issue	$0.001	在链起始处签发带预算和跳数上限的已签名 Job Envelope
imageguard	$0.002	NSFW 图像分类（多类别审核已列入路线图）
notifyrelay_telegram	$0.002	向已知 chat ID 发送 Telegram 消息
promptguard	$0.002	对不可信输入进行提示词注入风险评分（0–100）
structextract	$0.002	从 HTML 中提取结构化 JSON——表格、链接、电子邮件、电话号码
xaudit	$0.002	使用经过加密签名的证书验证 API 响应内容
docconvert_pdf	$0.005	将 HTML 或 markdown 转换为 PDF（输出为 base64）
kyaoracle	$0.005	查询 Ethereum/Base 钱包地址的链上信任分数（0–100）
linkrisk	$0.005	URL 风险档案——启发式钓鱼信号、重定向追踪
markdownopt	$0.005	将 URL 或 HTML 转换为适用于大模型的整洁 markdown（减少约 70% 的 token）
notifyrelay_email	$0.005	通过 Resend 发送事务性电子邮件（允许列表控制、速率限制）
embedpay	$0.00005 / 1k tokens	OpenAI text-embedding-3-small 封装工具，提供批量套餐
linksafe	$0.01	通过 Playwright 沙箱 + VirusTotal 进行确定性 URL 安全检查
scrapepay	$0.01	通过 Playwright 提取网页内容（强制执行 robots.txt，防护 SSRF）
pdf_render	$0.49	通过 Playwright 将 URL 或 HTML 转换为高保真 PDF

22 项服务。实时价格和实时钱包 可在 Basescan 上查看。

---

为什么选择 x402，为什么按次付费

• 无需注册成本。 钱包中有 USDC 后，这里的每个工具都可立即使用。无需创建账户，无需轮换 API 密钥，也无需预测订阅等级。
• 仅在成功时收费。 每项服务仅在 HTTP 2xx 且内容非空时结算付款。调用失败不产生费用——保留你的重试额度。
• 自然组合。 ScrapePay → MarkdownOpt → EmbedPay → MemoryServe → MEMSCRUB 是标准的 RAG 工作流。每个步骤的付款相互独立，且可在链上验证。
• 原生支持 MCP。 安装一次，全部 22 个工具即可在 Claude Desktop、Cursor、Cline、Continue、Claude Code 或任何支持 MCP 的 Agent 运行时中使用。
• 不受供应商锁定。 x402 是 Linux Foundation 协议（2026 年 4 月），由 Google、AWS、Stripe、Visa、Mastercard 联合签署。其他提供商也会推出 x402 服务；你的钱包客户端可与所有这些服务配合使用。

---

安装 — Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "x402-tools": {
      "command": "npx",
      "args": ["@melis-ai/x402-tools-mcp"]
    }
  }
}

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

重启 Claude Desktop。全部 22 个工具都会出现在工具选择器中。

安装 — Cursor、Cline、Continue、Claude Code

请参阅 agents.melis.ai/docs/install-mcp，了解各客户端的设置方法。

---

示例：标准 RAG 工作流

// All 22 tools registered as MCP tools — your agent calls them like any function
const page    = await callTool('scrapepay',   { url: 'https://example.com/article' });
const md      = await callTool('markdownopt', { html: page.content });
const vec     = await callTool('embedpay',    { input: md.markdown });
const stored  = await callTool('memoryserve_write', {
  agent_id: 'agent-1', content: md.markdown, vector: vec.embedding,
});

// Later — recall and guard against indirect injection
const hits    = await callTool('memoryserve_query', {
  agent_id: 'agent-1', query: 'what did we learn about X?',
});
for (const chunk of hits.matches) {
  const scrub = await callTool('memscrub', { content: chunk.content });
  if (scrub.risk_level === 'safe') useChunk(chunk);
}

每个 5k token 页面总成本：约 0.017 USDC。详细演练：agents.melis.ai/pipelines/rag。

---

为钱包充值

x402 使用 Base（Coinbase L2）上的 USDC 结算。有两种方式：

• Coinbase Wallet — 购买 USDC，切换到 Base 网络，然后将其发送到 Agent 的钱包。
• 从 Ethereum 主网跨链桥接 — bridge.base.org。

1.00 美元的 USDC 可支付 100 次 ScrapePay 调用、200 次 PromptGuard 调用，或一次完整的 RAG 工作流数据导入。

---

发现入口（面向 Agent 构建者和 AI 用户）

URL	用途
agents.melis.ai/llms.txt	精简、适合大模型阅读的目录
agents.melis.ai/llms-full.txt	完整架构及组合方案
agents.melis.ai/openapi.json	全部 22 个端点的 OpenAPI 3.1 规范
agents.melis.ai/ai-plugin.json	ChatGPT 插件清单
https://<service>.melis.ai/.well-known/mcp.json	各服务的 MCP 发现信息
agents.melis.ai/agents-faq	Agent 构建者常见问题（不同于面向用户的常见问题）

---

对比

• ScrapePay 与 Firecrawl 对比
• EmbedPay 与 OpenAI Embeddings（直接调用）对比
• MemoryServe 与 Pinecone 对比
• 完整的替代方案文档

---

源码与许可

• MCP 封装器源码（本仓库）：采用 MIT 许可。
• 服务代码（22 项服务本身）：出于安全考虑，不公开源代码。
• 网站内容（agents.melis.ai 文档）：采用 CC-BY-4.0 许可——注明来源为“melis x402 Tools”，并附上 agents.melis.ai 链接。

---

安全

发现漏洞？请参阅 SECURITY.md。请发送邮件至 [email protected]。我们会在 24 小时内确认收到严重问题的报告。

---

引用本文

如果你在研究或下游产品中使用 melis x402 Tools，请参阅 CITATION.cff 获取标准引用格式。

---

作者

mizukaizen — Agent 运营者与构建者。 目录：agents.melis.ai · 邮箱：[email protected]