x402-md-mcp
v1.0.0
Published
MCP server: webpage-to-Markdown extraction, paid per call in USDC on Base via x402. One tool, extract_markdown(url).
Maintainers
Readme
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-mcpConfigure 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.
