# x402-md-mcp

MCP server for **webpage → clean Markdown** extraction, paid per call in USDC on Base
mainnet via the [x402](https://x402.org) protocol. No API key, no account.

Exposes one tool, **`extract_markdown(url)`**, which fetches a webpage through the
[x402-md](https://x402-md.lagoontechsystems.com) 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

```bash
# 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](https://lagoontechsystems.com). MIT licensed.