X402 Tools Mcp

io.github.mizukaizen由 GitHub 账号 mizukaizen 发布v0.1.4更新于 Oct 24, 2026

melis x402 Tools — 22 pay-per-call APIs for AI agents. No accounts, no API keys. USDC on Base.

概览

AI 生成的概览

本地 MCP 服务器,提供 22 个按次付费的实用 API——抓取、转换、嵌入、记忆、审核与通知——通过 Base 上的 USDC 经 x402 支付。

可以做什么
抓取并提取网页内容,转换文档、渲染 PDF,并把页面整理成适合 LLM 的干净 markdown(cacheserve、scrapepay、structextract、markdownopt、docconvert_text、docconvert_pdf、pdf_render)。写入和检索带嵌入的智能体记忆,并在智能体之间转交上下文(memoryserve_write、memoryserve_query、embedpay、intentflow)。检测不可信输入和链接中的提示注入、钓鱼与不安全图片(promptguard、memscrub、linkrisk、linksafe、imageguard)。按 JSON Schema 校验响应、签发审计证书、查询钱包信任分(schemagate、xaudit、kyaoracle)。发送 webhook、Telegram 消息和事务邮件(notifyrelay_webhook、notifyrelay_telegram、notifyrelay_email)。签发并校验带预算和跳数上限的多智能体任务链(loopwall_issue、loopwall_hop),并列出全部服务与价格(list_services)。
适用场景
适合需要现成构建模块的智能体——抓取、嵌入、记忆、审核、通知——又不想为各家服务分别注册账号,并愿意为加密钱包充值、按次支付小额费用的场景。
运行要求
通过 npx 在本地运行,需要 Node.js,并在 Claude Desktop 等 MCP 客户端中配置。按次付费需要持有 Base 网络上 USDC 的钱包客户端;无需账号或 API 密钥。另有可选密钥 X402_INTERNAL_KEY 和 X402_PAYMENT_HEADER,用于跳过支付或手动处理支付。
安装前请注意
每次工具调用都会从钱包支出真实 USDC,价格约从每次 0.00005 美元到 0.49 美元;据称仅在成功时结算。X402_INTERNAL_KEY 绕过密钥和 X402_PAYMENT_HEADER 支付令牌属于机密。工具会把数据发给第三方:URL 送往抓取和 VirusTotal 检查,内容送往嵌入与审核服务,消息和邮件发给收件人。这 22 项服务为闭源。

安装

在 SourceWeft 中

  1. 打开 控制台中的 X402 Tools Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@melis-ai/x402-tools-mcp

[npm version] [License: MIT] [MCP compatible] [x402] [Catalogue]

Boring infrastructure for agent builders. 22 pay-per-call utility tools served as an MCP server — scrape, validate, embed, store, moderate, notify, convert, prevent loops. No accounts, no API keys, no subscriptions. Pay with USDC on Base via the x402 protocol.

bash
npx @melis-ai/x402-tools-mcp

→ Full catalogue with prices and live examples: agents.melis.ai → Canonical 5-step RAG pipeline: agents.melis.ai/pipelines/rag → 5-minute getting started: agents.melis.ai/docs/getting-started


Tool catalogue (22)

ToolPrice (USDC)Description
list_servicesfreeReturns the full catalogue with prices and endpoint URLs
cacheserve$0.001Fetch a URL with server-side caching — avoids redundant origin hits
docconvert_text$0.001Format conversion: md↔html, json↔csv, html→txt, etc.
intentflow$0.001Context handoff relay for multi-agent delegation (async, returns retrieve_url)
memoryserve_write$0.001Store text + embedding in Qdrant + SQLite, namespaced per agent_id
memoryserve_query$0.001Recall most-similar memories by semantic query
memscrub$0.001Scan retrieved RAG content for indirect prompt injection (10 patterns)
notifyrelay_webhook$0.001POST a JSON payload to a URL with optional HMAC-SHA256 signing
schemagate$0.001Validate a JSON response against a JSON Schema, return a hint on failure
loopwall_hop$0.0005Validate one hop of a signed multi-agent chain (loop / budget enforcement)
loopwall_issue$0.001Issue a signed Job Envelope at chain start with budget + hop cap
imageguard$0.002NSFW image classification (multi-class moderation on roadmap)
notifyrelay_telegram$0.002Send a Telegram message to a known chat ID
promptguard$0.002Score untrusted input for prompt injection risk (0–100)
structextract$0.002Extract structured JSON from HTML — tables, links, emails, phones
xaudit$0.002Validate API response content with a cryptographically signed certificate
docconvert_pdf$0.005Convert HTML or markdown to PDF (base64 output)
kyaoracle$0.005On-chain trust score (0–100) for an Ethereum/Base wallet address
linkrisk$0.005URL risk profile — heuristic phishing signals, redirect tracing
markdownopt$0.005Convert URL or HTML to clean LLM-ready markdown (~70% token reduction)
notifyrelay_email$0.005Send a transactional email via Resend (allowlisted, rate-limited)
embedpay$0.00005 / 1k tokensOpenAI text-embedding-3-small wrapper, batch tier available
linksafe$0.01Definitive URL safety check via Playwright sandbox + VirusTotal
scrapepay$0.01Web extraction via Playwright (robots.txt enforced, SSRF-safe)
pdf_render$0.49High-fidelity URL or HTML → PDF via Playwright

22 services. Live prices and live wallet on Basescan.


Why x402, why pay-per-call

  • No signup tax. Every tool here works the moment your wallet has USDC. No accounts to provision, no API keys to rotate, no subscription tiers to forecast.
  • Charge-on-success-only. Every service settles payment only on HTTP 2xx with non-empty content. Failed calls cost nothing — your retry budget is preserved.
  • Composes naturally. ScrapePay → MarkdownOpt → EmbedPay → MemoryServe → MEMSCRUB is the canonical RAG pipeline. Each step's payment is independent and verifiable on-chain.
  • MCP-native. One install, all 22 tools appear in Claude Desktop, Cursor, Cline, Continue, Claude Code, or any MCP-aware agent runtime.
  • No vendor lock-in. x402 is a Linux Foundation protocol (April 2026) co-signed by Google, AWS, Stripe, Visa, Mastercard. Other providers will offer x402 services; your wallet client works with all of them.

Installation — Claude Desktop

Add to your claude_desktop_config.json:

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

Restart Claude Desktop. All 22 tools appear in the tool picker.

Installation — Cursor, Cline, Continue, Claude Code

See agents.melis.ai/docs/install-mcp for per-client setup.


Example: canonical RAG pipeline

typescript
// All 22 tools registered as MCP tools — your agent calls them like any functionconst 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 injectionconst 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);}

Total cost per 5k-token page: ~$0.017 USDC. Detailed walkthrough: agents.melis.ai/pipelines/rag.


Funding the wallet

x402 settles in USDC on Base (Coinbase L2). Two paths:

  • Coinbase Wallet — buy USDC, switch to Base network, send to your agent's wallet.
  • Bridge from Ethereum mainnet — bridge.base.org.

$1.00 of USDC covers 100 ScrapePay calls, 200 PromptGuard calls, or one full RAG-pipeline ingestion run.


Discovery surfaces (for agent builders + AI consumers)

URLPurpose
agents.melis.ai/llms.txtConcise LLM-readable catalogue
agents.melis.ai/llms-full.txtFull schemas + composition recipes
agents.melis.ai/openapi.jsonOpenAPI 3.1 spec for all 22 endpoints
agents.melis.ai/ai-plugin.jsonChatGPT-plugin manifest
https://<service>.melis.ai/.well-known/mcp.jsonPer-service MCP discovery
agents.melis.ai/agents-faqAgent-builder FAQ (distinct from human FAQ)

Comparisons


Source & licensing

  • MCP wrapper source (this repo): MIT licensed.
  • Service code (the 22 services themselves): closed source for security.
  • Site content (agents.melis.ai docs): CC-BY-4.0 — attribute "melis x402 Tools" with a link to agents.melis.ai.

Security

Found a vulnerability? See SECURITY.md. Email [email protected]. Critical issues acknowledged within 24 hours.


Citing this work

If you use melis x402 Tools in research or downstream products, see CITATION.cff for the canonical citation.


Author

mizukaizen — agent operator and builder. Catalogue: agents.melis.ai · Email: [email protected]

来源:README.md,提交 8167a35

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.4最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。