x402-mcp-web-extract

# x402 MCP Web Extract

Pay-per-use MCP server that settles with **x402 USDC micropayments** on Base mainnet.

## Connect

```json
{
  "mcpServers": {
    "x402-web-extract": {
      "type": "http",
      "url": "https://x402-web-extract.senpi-agent.workers.dev/mcp"
    }
  }
}
```

## Tools (paid, pay-per-call)

| Tool | Price | Description |
|------|-------|-------------|
| `fetch_url` | $0.01 | Fetch any public URL as clean markdown or JSON |
| `token_price` | $0.01 | Real-time USDC spot price for any EVM token |
| `wallet_balance` | $0.02 | Native and USDC balance for any EVM wallet |

Payments are handled automatically by the `@x402/mcp` client — the wallet simply signs the x402 settlement. No subscriptions, no keys, no API tokens.

## REST fallback

The same tools are available as plain HTTP endpoints with x402 `payment-required` flow:

- `GET /fetch?url=<encoded-url>` — $0.01
- `GET /price?address=&chain=` — $0.01
- `GET /balance?address=&chain=` — $0.02

Discovery: `/llms.txt`, `/openapi.json`, `/.well-known/x402`, `/.well-known/agent-card.json`.

## Infrastructure

- Worker: `https://x402-web-extract.senpi-agent.workers.dev`
- Pay-to wallet (Base): `0xd44B22e6A97a26e0cC9615478962C9C9C2495ceC`
- Facilitator: CDP x402 (`https://api.cdp.coinbase.com/platform/v2/x402`)
- x402 spec: https://github.com/0xfabs/x402