# x402 Markdown Reader

> x402 Markdown Reader is a paid MCP server for files and documents. Fetch a public web page as clean Markdown, paid per call in USDC on Base. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://x402-reader.xbtbot.workers.dev/openapi.json
- **MCP Registry name:** dev.workers.xbtbot.x402-reader/markdown-reader
- **Categories:** files and documents, web search and scraping
- **Listing updated:** 2026-11-16

## About

This pay-per-call reader takes the URL of a public page and returns the main content as Markdown, with boilerplate, navigation, ads and scripts stripped, plus title, byline, excerpt and site name. Each call costs 0.005 USDC on Base through the x402 payment protocol, and you are only charged when the page is fetched and converted successfully.

Limits are explicit: public hostnames only (no IP addresses or private hosts), a 2 MB page cap, a 10-second timeout, and Markdown truncated at 200,000 characters. Invalid or blocked URLs and upstream fetch failures are not charged. Unpaid requests get an HTTP 402 with payment requirements, then retry with a payment signature header.

The same service also offers a GET /read endpoint over plain HTTP, and a second paid endpoint that checks domain availability through registry RDAP for .xyz, .com, .io, .ai, .app and .dev plus name variations. The MCP endpoint exposes a read_url tool.

## Features

- **Clean Markdown output:** Returns the main content without nav, ads or scripts.
- **Page metadata:** Includes title, byline, excerpt and site name.
- **x402 micropayments:** Pay 0.005 USDC per call on Base.
- **Charged only on success:** Failed fetches and invalid URLs cost nothing.
- **Safety limits:** Public hosts only, 2 MB cap, 10 s timeout.
- **Domain check:** A separate endpoint checks domain availability via RDAP.

## Good for

- Let an agent read an article or docs page without parsing HTML
- Summarize a blog post from its URL
- Pay per request without an account or API key
- Check whether a startup name is available as a domain

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http markdown-reader https://x402-reader.xbtbot.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://x402-reader.xbtbot.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "markdown-reader": {
      "url": "https://x402-reader.xbtbot.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "markdown-reader": {
      "type": "http",
      "url": "https://x402-reader.xbtbot.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "markdown-reader": {
      "serverUrl": "https://x402-reader.xbtbot.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "markdown-reader": {
      "type": "http",
      "url": "https://x402-reader.xbtbot.workers.dev/mcp"
    }
  }
}
```

## Tools

- `read_url`: Fetch a public web page and return its main content as Markdown.

## FAQ

### How much does a call cost?

0.005 USDC on Base, charged only on successful extraction.

### What are the limits?

Public hostnames only, 2 MB page cap, 10 second timeout and 200,000 characters of Markdown.

### What is the MCP tool called?

read_url, at the /mcp endpoint.

### What happens without payment?

The server returns HTTP 402 with x402 payment requirements.

### Is x402 Markdown Reader free?

No. x402 Markdown Reader is a paid product.

### How do I add x402 Markdown Reader to Claude Code?

Run this command in your terminal: claude mcp add --transport http markdown-reader https://x402-reader.xbtbot.workers.dev/mcp

### What are the best alternatives to x402 Markdown Reader?

The closest alternatives to x402 Markdown Reader are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and ASTra.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/x402-markdown-reader
