x402 Markdown Reader
Fetch a public web page as clean Markdown, paid per call in USDC on Base
- Pricing
- Paid
- Platforms
- API
- Runs
- Remotely
- Version
- 1.0.0
- Listing updated
- 1 day ago
About x402 Markdown Reader
x402 Markdown Reader is a paid MCP server for files and documents. It runs as a hosted remote server, so there is nothing to install locally.
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.
Install
Run in a terminal
claude mcp add --transport http markdown-reader https://x402-reader.xbtbot.workers.dev/mcpAdd to Settings → Connectors → Add custom connector
https://x402-reader.xbtbot.workers.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"markdown-reader": {
"url": "https://x402-reader.xbtbot.workers.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"markdown-reader": {
"type": "http",
"url": "https://x402-reader.xbtbot.workers.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"markdown-reader": {
"serverUrl": "https://x402-reader.xbtbot.workers.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"markdown-reader": {
"type": "http",
"url": "https://x402-reader.xbtbot.workers.dev/mcp"
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- read_url
- Fetch a public web page and return its main content as Markdown.
What it does
- 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
Pricing
Paid
0.005 USDC per call on Base via x402
Prices change. Check x402-reader.xbtbot.workers.dev before you buy.
x402 Markdown Reader 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 to x402 Markdown Reader

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Firecrawl MCP Server
MCP serverMCP server that lets AI agents search, scrape and interact with web pages
- 3 tools
- Remote
- Freemium
- 7.8K GitHub stars
- Web search and scraping

SearXNG Search
MCP serverMCP server for web search and page reading through a SearXNG instance
Runs locally- 3 tools
- Open source
- 1.4K GitHub stars
- Web search and scraping

NeuralVerge
MCP serverStructured, source-tagged business and people data from 300+ sources for agents
- 200 tools
- Remote
- Free trial
- 1 GitHub star
- Web search and scraping

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

AI-Powered directory
MCP serverSearch AI tools, agents and MCP servers and get install configs from inside your AI assistant.
- 4 tools
- Remote
- Free
- Developer tools