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 分

    請在儲存庫或註冊中心條目中宣告授權條款。