How do I use x402-md-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@x402-md-mcp Extract clean Markdown from https://example.com/blog" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

x402-md-mcp

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 }.