Skip to main content
Glama

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

x402_search, x402_read, x402_render, x402_summarize, x402_news, x402_rss, x402_wayback, x402_arxiv, x402_wiki

AI generation

x402_chat, x402_image, x402_video, x402_tts, x402_podcast

Data

x402_crypto, x402_weather, x402_stock, x402_fx, x402_sec, x402_feargreed, x402_holidays, x402_places

Recon & audits

x402_dns, x402_whois, x402_certs, x402_seo, x402_github

Box-hosted tools

x402_screenshot, x402_ocr, x402_metadata, x402_pdftext

Utilities

x402_translate, x402_sentiment, x402_qrcode

Async jobs

x402_poll_job (free)

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 build

Requires 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/evm wrap every call; ExactEvmScheme signs an EIP-3009 USDC authorization per call on eip155: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 errors

Available Tools

35 tools
x402_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_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

    B3.2/5.0

    Scored across 35 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers