Skip to content
MCP server

x402 Markdown Reader

Fetch a public web page as clean Markdown, paid per call in USDC on Base

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://x402-reader.xbtbot.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "markdown-reader": {
      "url": "https://x402-reader.xbtbot.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. MCP 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
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP 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
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  6. Search AI tools, agents and MCP servers and get install configs from inside your AI assistant.

    • 4 tools
    • Remote
    • Free
    • Developer tools