x402-mcp-server_by_milza
This server exposes a catalog of x402-paywalled HTTP tools on Base Mainnet as MCP tools, where each call automatically pays in USDC from your BASE_PRIVATE_KEY.
markdown-extractor: Fetches a public URL and converts it into clean, token-efficient Markdown (0.01 USDC per call).
spa-dom-to-md: Renders JavaScript-heavy SPA pages in headless Chromium and serializes the fully-rendered DOM into LLM-ready Markdown (0.03 USDC per call).
burn-once-secret-vault: Stores a secret encrypted with AES-256-GCM and shares a URL that reveals the secret exactly once, with an Ed25519-signed attestation (0.01 USDC per call to create; free claim reads).
svg-bar-chart-renderer: Generates deterministic, schema-valid SVG bar charts from labeled scalar data and layout options (0.015 USDC per call).
Payment is handled automatically: the server signs EIP-3009 TransferWithAuthorization locally, pays per call, and requires no API keys or signup.
Runtime request schemas are discoverable tool-specific via each tool's
/openapi.jsonendpoint.
x402-mcp-server
A small, growing catalog of x402-paywalled HTTP tools on Base Mainnet via x402 micro-payments — no API keys, no signup, pay per call in USDC.
This MCP server exposes that catalog as native MCP tools. Every tool call pays for itself automatically: the server POSTs the request, catches the real x402 v2 402 PAYMENT-REQUIRED challenge, signs an EIP-3009 TransferWithAuthorization with viem using a local wallet, and resubmits with the PAYMENT-SIGNATURE header. No human signature prompt at call time — the agent just calls the tool.
Tools
Tool | Cost (USDC) | Description | Key input parameters |
| 0.01 | Fetches a public URL and returns clean, token-efficient markdown, paywalled with the x402 v2 protocol on Base Mainnet. Designed for autonomous AI agents to call directly: no API key, no signup — pay per call in USDC. |
|
| 0.03 | Renders JavaScript-heavy SPA pages in real headless Chromium via Cloudflare Browser Rendering, waits for network-idle / selector-ready, strips nav/footer/script chrome, and serializes the fully-rendered DOM into clean, LLM-ready Markdown. |
|
| 0.01 | Store a secret (API key, webhook payload, signed URL) encrypted with WebCrypto AES-256-GCM and share a claim URL that yields the secret exactly once. A Durable Object serializes reads so single-use delivery is race-free, and every burn returns an Ed25519-signed attestation. Creating a vault requires x402 payment; the recipient's claim read (GET /v/:vault_id) is free. |
|
| 0.015 | Deterministic, paid-per-render SVG bar chart generator for LLM agents. Accepts labeled scalar data and layout options, performs exact geometry math (min/max normalization, nice-interval y-axis ticks, label spacing, bar-width distribution), and returns schema-valid, escape-correct SVG with identical input always yielding byte-identical output. |
|
| 0.03 | Decodes a GeoTIFF/COG (https URL or inline base64), reads the selected RGB bands via windowed overview reads, applies a tone-map stretch, and returns a PNG/WebP plus georeference metadata (CRS, bounds, pixel scale) and source stats. Limits: 20 MB source, 2048 px output width. Billed per attempt: payment settles after structural validation, before decode, so decode-time failures (e.g. a bands_rgb band the source lacks) are still charged. | exactly one of |
All tools run on Base Mainnet (eip155:8453). Settlement happens server-side through an ordered facilitator chain — Coinbase CDP, then PayAI, then Primer as fallbacks — which changes nothing on your side: you sign the same EIP-3009 authorization either way, and every tool is also listed in the CDP and PayAI x402 Bazaar discovery catalogs. Exact request-body fields for each tool are also discoverable at runtime via <tool-url>/openapi.json.
Related MCP server: x402-json-repair-mcp
Quickstart
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"x402-mcp-server": {
"command": "npx",
"args": ["-y", "x402-mcp-server_by_milza"],
"env": {
"BASE_PRIVATE_KEY": "0xyour_base_mainnet_private_key"
}
}
}
}⚠️ Funding warning:
BASE_PRIVATE_KEYmust be a Base Mainnet wallet private key funded with a small amount of real USDC (e.g. $0.50 is enough for dozens of calls at these prices). Every tool call spends real money from this wallet. Do not use a key that holds funds you're not prepared to spend through this server, and never commit this key to source control.
Once configured, restart Claude Desktop and the tools listed above become available to the assistant automatically — no further setup, no dashboard, no API key registration.
How payment works
BASE_PRIVATE_KEY is your own wallet — whoever installs this server sets their own key and pays for their own calls. Each call settles straight to the tool provider's wallet; your key never touches anyone else's funds and no one else's key ever touches yours. To set it up:
Use (or create) a Base Mainnet EVM wallet you're OK spending small amounts from.
Fund it with a bit of USDC on Base (e.g. $0.50).
Export its private key and set it as
BASE_PRIVATE_KEYin your MCP client config, as shown above.
Security
BASE_PRIVATE_KEYnever leaves your machine. It is read once from the local environment and used only to sign EIP-712 typed-data (EIP-3009TransferWithAuthorization) payment authorizations locally withviem.No raw private key, seed phrase, or signature is ever sent over the network — only the resulting signed authorization, exactly as the x402 protocol requires to settle payment for the specific request being made.
Payment terms (recipient, amount, network, asset contract, expiry) are read fresh from each live
402challenge returned by the resource server, never trusted from a local cache, so a stale or tampered local catalog can't redirect funds.Spending ceiling: the live
402challenge is trusted for signing mechanics (domain, nonce window, asset) but never for the amount. Every call checks the challenge's requested amount against this catalog's known price for that tool and refuses to sign anything higher — a hijacked, compromised, or buggy endpoint can't get a blank-check signature just by asking for more.This package does not phone home, collect telemetry, or store your key anywhere on disk.
Requirements
Node.js 18+
A Base Mainnet EVM wallet, funded with a small amount of USDC, whose private key you control
License
MIT
Links
Available Tools
4 toolsburn-once-secret-vaultA
Store a secret (API key, webhook payload, signed URL) encrypted with WebCrypto AES-256-GCM and share a claim URL that yields the secret exactly once. A Durable Object serializes reads so single-use delivery is race-free, and every burn returns an Ed25519-signed attestation. Creating a vault requires x402 payment; the recipient's claim read (GET /v/:vault_id) is free. Costs 0.01 USDC per call on eip155:8453, paid automatically from BASE_PRIVATE_KEY. Request body fields are tool-specific -- see https://burn-once-secret-vault.jannioura.workers.dev/openapi.json.
markdown-extractorA
Fetches a public URL and returns clean, token-efficient markdown, paywalled with the x402 v2 protocol on Base Mainnet. Designed for autonomous AI agents to call directly: no API key, no signup — pay per call in USDC. Costs 0.01 USDC per call on eip155:8453, paid automatically from BASE_PRIVATE_KEY. Request body fields are tool-specific -- see https://markdown-extractor.jannioura.workers.dev/openapi.json.
spa-dom-to-mdA
Renders JavaScript-heavy SPA pages in real headless Chromium via Cloudflare Browser Rendering, waits for network-idle / selector-ready, strips nav/footer/script chrome, and serializes the fully-rendered DOM into clean, LLM-ready Markdown. Costs 0.03 USDC per call on eip155:8453, paid automatically from BASE_PRIVATE_KEY. Request body fields are tool-specific -- see https://spa-dom-to-md.jannioura.workers.dev/openapi.json.
svg-bar-chart-rendererA
Deterministic, paid-per-render SVG bar chart generator for LLM agents. Accepts labeled scalar data and layout options, performs exact geometry math (min/max normalization, nice-interval y-axis ticks, label spacing, bar-width distribution), and returns schema-valid, escape-correct SVG with identical input always yielding byte-identical output. Costs 0.015 USDC per call on eip155:8453, paid automatically from BASE_PRIVATE_KEY. Request body fields are tool-specific -- see https://svg-bar-chart-renderer.jannioura.workers.dev/openapi.json.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct domain: secret vaulting, markdown extraction, SPA rendering, and SVG chart generation. There is no functional overlap between any pair of tools.
Names are descriptive and readable, but they do not follow a single verb_noun or noun_verb pattern. Three use hyphenated noun phrases (burn-once-secret-vault, spa-dom-to-md, svg-bar-chart-renderer) while one uses a noun-noun compound (markdown-extractor).
Four tools is a reasonable, focused set for a paid utility server. It is slightly thin for a general-purpose toolkit, but each tool is substantial and earns its place.
The tools are independent utilities rather than a CRUD domain, so completeness is hard to assess. Each tool appears self-contained for its stated purpose, but the set lacks any broader workflow cohesion and there is no obvious way to manage or inspect the x402 payment side.
Maintenance
Related MCP Connectors
Programmatic web-scraping MCP server powered by x402 micro-transactions on Base.
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
Pay-per-call web extraction, SEO audits and text analysis. USDC on Base via x402, no API keys.
Related MCP Servers
- 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.MIT
- AlicenseNot gradedqualityDmaintenanceA small, autonomous, pay-per-call MCP server that AI agents discover and pay for per call, with revenue landing directly in a USDC wallet on Base via the x402 payment protocol.MIT
- FlicenseNot gradedqualityBmaintenanceAn enterprise-grade SSE Model Context Protocol server for ad-free Markdown web scraping, protected by on-chain x402 micropayments on Base.-
- FlicenseNot gradedqualityDmaintenanceProduction-grade Model Context Protocol (MCP) server delivering paywalled Web3 micro-services powered by autonomous x402 payment challenges on Base Mainnet.-