X402 Md

MCP server for webpage → clean Markdown extraction, paid per call in USDC on Base mainnet via the x402 protocol. No API key, no account.

Exposes one tool, extract_markdown(url), which fetches a webpage through the x402-md service (Mozilla Readability + Turndown), strips nav/ads/footer, and returns clean Markdown. The $0.005 USDC payment is settled automatically from your wallet — the server handles the x402 402→sign→retry flow for you.

Install / run

# stdio (for Claude Desktop, Cline, and other MCP clients)
npx x402-md-mcp

Configure your client to launch npx x402-md-mcp as an MCP server.

Configuration (env)

Var	Default	Notes
BUYER_WALLET_PATH	~/.x402-buyer/wallet.json	You supply this. JSON file { "private_key": "0x..." } for a wallet funded with a little USDC on Base. Every call spends $0.005 from it.
X402_MD_URL	https://x402-md.lagoontechsystems.com/api/extract	Target endpoint.
MCP_TRANSPORT	stdio	stdio or http (streamable-HTTP on HOST:PORT).

You pay for your own calls. This server signs USDC transfers from the wallet you configure. Use a dedicated, lightly-funded wallet — never your main wallet.

Tool

extract_markdown(url: string) → clean Markdown of the page's main content. Response from the upstream service: { success, title, content, url, word_count, char_count }.

Provider

Lagoon Tech Systems. MIT licensed.