eleeth-x402-mcp
eleeth-x402-mcp
An MCP server that wraps x402.eleeth.com — 34 pay-per-call APIs for AI agents, paid in USDC on Base mainnet via the x402 v2 payment protocol.
No signup. No API key. The payment is the credential. Each tool call automatically handles the 402 Payment Required handshake: the server reads the payment requirements, signs the USDC transfer with your wallet, and retries — all inside the tool call.
What you get
34 tools, one per paid endpoint:
Area | Tools |
Web & research |
|
AI generation |
|
Data |
|
Recon & audits |
|
Box-hosted tools |
|
Utilities |
|
Async jobs |
|
Prices: $0.01/call for most, $0.02 for chat/summarize/seo/render/ocr/metadata/pdftext, $0.05 for image/screenshot, $0.25 for text-to-speech, $0.50 for video/podcast — all in USDC on Base mainnet.
The async tools (x402_video, x402_tts, x402_podcast, x402_screenshot, x402_render, x402_ocr, x402_metadata, x402_pdftext) return a job ticket. Poll it free with x402_poll_job (job_type: "media" for video/tts/podcast, "box" for the rest) — it waits and returns the download URL when done.
Related MCP server: x402-bazaar-mcp
Install
git clone <this-repo> && cd x402-mcp
npm install
npm run buildRequires Node 18+. You also need a Base wallet private key holding a little USDC — any wallet works; a fresh throwaway is fine. Fund it with ~$1 to start; most calls cost a penny.
Use with Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"eleeth-x402": {
"command": "node",
"args": ["/path/to/x402-mcp/dist/index.js"],
"env": {
"ELEETH_X402_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
}
}
}
}Restart Claude Desktop. The 34 tools appear automatically — no signup, no API keys to paste anywhere.
Works the same way with any STDIO MCP client (Cursor, OpenClaw, etc.): command node, args […/dist/index.js], env ELEETH_X402_KEY.
First run
The very first paid call from a new key will do the visible 402 dance: request → 402 Payment Required → wallet signs $0.01 USDC → retry → result. If the wallet is empty, the tool tells you to fund it — nothing is charged until the chain settles.
Free helpers: x402_poll_job costs nothing (job status endpoints are free), and /health is free.
How it works
Transport: STDIO only (no network ports).
Payments:
@x402/fetch+@x402/evmwrap every call;ExactEvmSchemesigns an EIP-3009 USDC authorization per call oneip155:8453(Base mainnet), verified by the Coinbase CDP facilitator.Your private key never leaves your machine — signing happens locally inside this process.
Test
node test-list.mjs # spawns the server over STDIO, lists all tools, smoke-tests poll + key errorsAvailable Tools
35 toolsx402_arxivB
Research paper search on arXiv ($0.01 USDC/call).
Inputs: q (required), n.
x402_certsA
Discover subdomains from certificate-transparency logs ($0.01 USDC/call).
Inputs: domain (required).
x402_chatB
AI chat completion ($0.02 USDC/call).
Inputs: message (required).
x402_cryptoA
Live crypto price + 24h change in USD ($0.01 USDC/call).
Inputs: coin.
x402_dnsC
DNS records lookup ($0.01 USDC/call).
Inputs: domain (required), type.
x402_feargreedB
Crypto Fear & Greed index ($0.01 USDC/call).
Inputs: no named parameters.
x402_fxA
Currency conversion; omit 'to' for the full table ($0.01 USDC/call).
Inputs: to, from.
x402_githubC
GitHub repo stats ($0.01 USDC/call).
Inputs: repo (required).
x402_holidaysB
Public holidays by country and year ($0.01 USDC/call).
Inputs: year, country.
x402_imageB
AI image generation — returns a PNG image ($0.05 USDC/call).
Inputs: prompt (required).
x402_metadataA
Full EXIF/file metadata report as JSON ($0.02 USDC/call). ASYNC — returns a job ticket; poll with x402_poll_job (job_type 'box').
Inputs: url, file, filename.
x402_newsC
Latest news headlines ($0.01 USDC/call).
Inputs: q (required).
x402_ocrA
Image text extraction (OCR) ($0.02 USDC/call). ASYNC — returns a job ticket; poll with x402_poll_job (job_type 'box').
Inputs: url, file, filename.
x402_pdftextA
PDF text extraction ($0.02 USDC/call). ASYNC — returns a job ticket; poll with x402_poll_job (job_type 'box').
Inputs: url, file, filename.
x402_placesB
Find restaurants, shops, landmarks with coordinates ($0.01 USDC/call).
Inputs: query (required), lat, lon, limit.
x402_podcastA
AI podcast episode from a topic or a full script ($0.50 USDC/call). ASYNC — returns a job ticket; poll with x402_poll_job (job_type 'media').
Inputs: topic, script.
x402_poll_jobA
Poll an async x402.eleeth.com job until it finishes (FREE — no payment). Use after x402_video, x402_tts, x402_podcast (job_type 'media') or x402_screenshot, x402_render, x402_ocr, x402_metadata, x402_pdftext (job_type 'box'). Returns the download URL when done.
Inputs: job_id (required), job_type (required), max_wait_seconds, poll_interval_seconds.
x402_qrcodeA
QR code generator — returns a PNG image ($0.01 USDC/call).
Inputs: text (required), size.
x402_readA
Fetch any web page and return its clean article text ($0.01 USDC/call).
Inputs: url (required).
x402_renderA
Render a page in a real browser (JavaScript included), return clean text ($0.02 USDC/call). ASYNC — returns a job ticket; poll with x402_poll_job (job_type 'box').
Inputs: url (required).
x402_rssA
Fetch any RSS/Atom feed and return it as JSON ($0.01 USDC/call).
Inputs: url (required).
x402_screenshotA
Full-page website screenshot as PNG, rendered on dedicated hardware ($0.05 USDC/call). ASYNC — returns a job ticket; poll with x402_poll_job (job_type 'box').
Inputs: url (required).
x402_searchB
Web search for AI agents ($0.01 USDC/call). Returns titles, URLs, snippets.
Inputs: query (required), num_results.
x402_secB
SEC company financial facts ($0.01 USDC/call).
Inputs: ticker (required).
x402_sentimentB
Sentiment analysis: positive / negative / neutral ($0.01 USDC/call).
Inputs: text (required).
x402_seoB
Instant SEO audit of a URL with a score ($0.02 USDC/call).
Inputs: url (required).
x402_stockA
Stock quote ($0.01 USDC/call).
Inputs: ticker (required).
x402_summarizeB
AI summary of any article URL ($0.02 USDC/call).
Inputs: url (required).
x402_translateA
Translate text into any language ($0.01 USDC/call).
Inputs: text (required), target.
x402_ttsA
Text-to-speech: spoken-word mp3 ($0.25 USDC/call). ASYNC — returns a job ticket; poll with x402_poll_job (job_type 'media').
Inputs: text (required), voice.
x402_videoA
AI video generation: ~10s 720p clip from a prompt ($0.50 USDC/call). ASYNC — returns a job ticket; poll with x402_poll_job (job_type 'media').
Inputs: prompt (required).
x402_waybackC
Closest archived snapshot of a URL from archive.org ($0.01 USDC/call).
Inputs: url (required).
x402_weatherA
Current conditions + today's forecast ($0.01 USDC/call).
Inputs: city (required).
x402_whoisB
Domain WHOIS via RDAP ($0.01 USDC/call).
Inputs: domain (required).
x402_wikiB
Wikipedia summary ($0.01 USDC/call).
Inputs: topic (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 35 tools
Each tool targets a different service or output type, and the descriptions clearly specify what each returns. A few near-neighbor pairs exist (x402_read vs x402_render, x402_crypto vs x402_stock vs x402_feargreed), but they are distinguishable enough for an agent to select correctly.
All tools share the consistent x402_ prefix and snake_case format, which makes the set feel uniform at a glance. However, the suffix style is mixed: some are verbs (search, read, summarize, translate), some are nouns (weather, stock, wiki), and some are acronyms (dns, tts, ocr), so the pattern is predictable but not fully uniform.
35 tools is well above the 25+ threshold and represents a very large, sprawling surface for an agent to navigate. The server is essentially a multi-domain API bundle rather than a focused, well-scoped toolset, making selection difficult and the set feel heavy.
The async tools all have a matching x402_poll_job, so the main generation and processing workflows have no dead ends. The major categories are well covered, though minor gaps like job cancellation or output editing are missing, so agents can work around most limitations.
Maintenance
Related MCP Connectors
Pay-per-use MCP tools for AI agents. USDC on Base via x402. No API keys.
Pay-per-call x402 MCP for AI agents: 35 tools, USDC on Base, from $0.001/call, no API keys.
15 paid AI agent primitives via x402 (USDC on Base). Pay-per-call MCP server.
Pay-per-call x402 MCP: 22 agent APIs on Base USDC. Crypto, onchain reads, repo safety. From $0.001
Related MCP Servers
- AlicenseCqualityDmaintenancex402 Micropaid MCP Server — 120+ paid API endpoints for AI Agents. Pay per call with USDC on Base network. No signup, no API key needed.551MIT
- AlicenseBqualityBmaintenanceMCP server exposing x402 Bazaar's paid Base APIs (token risk/honeypot, prices, gas, wallet intel, tx decode + AI utilities) as agent tools. Your agent pays per call in USDC over x402 — no API keys, no signup.17166 npmMIT
- FlicenseAqualityCmaintenanceMCP server for a live x402 payment gateway on Base (USDC). Lets AI agents discover, preview for free, then pay per call — with prepaid gasless payments, signed receipts, and delta delivery.7-
- AlicenseNot gradedqualityDmaintenanceMCP server that provides AI agents with pay-per-call access to a suite of tools (honeypot check, token market, DeFi yields, etc.) via USDC on Base using the x402 protocol.11 npmMIT