# AgentReader

> AgentReader is a freemium MCP server for files and documents. Turn web pages, PDFs, JSON and CSV into clean Markdown for agents, with free daily reads. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://agentreader.xyz
- **MCP Registry name:** xyz.agentreader/agentreader
- **Categories:** files and documents, web search and scraping
- **Listing updated:** 2026-11-15

## About

AgentReader converts a URL or PDF into Markdown or JSON, with a far smaller token footprint than raw HTML. Its own example shrinks GitHub's pricing page from about 243,000 tokens to roughly 5,000. It renders JavaScript, handles cookie walls and reads PDFs, and it is available over REST and through the MCP endpoint at agentreader.xyz/mcp.

Five reads a day per IP are free with no signup, resetting at 00:00 UTC. Beyond that you buy credits that do not expire: 2,000 reads for $3 or 7,000 for $10, paid by card or USDC on Base, and used with an API key. Agents with a wallet can instead pay $0.005 per read in USDC through x402. Failed reads are not charged.

It does not try to defeat bot protection, logins or paywalls: those pages return a clear error such as bot_challenge or paywalled. Only the hostname of each read is logged, with IPs stored as salted hashes for 30 days.

## Features

- **Token-lean output:** Returns Markdown or JSON far smaller than raw HTML.
- **JavaScript rendering:** Reads script-rendered pages and handles cookie walls.
- **PDF reading:** Converts PDFs such as SEC filings to text.
- **Credit packs:** 2,000 reads for $3, with credits that never expire.
- **Pay per read:** x402 payments of $0.005 in USDC on Base with no key.
- **Honest errors:** Blocked or paywalled pages return an error and are not charged.

## Good for

- Feed a pricing page to an agent in few tokens
- Read a PDF filing into Markdown
- Pull docs pages into a research agent
- Let a wallet-holding agent pay per page

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http agentreader https://agentreader.xyz/mcp
```

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

```sh
https://agentreader.xyz/mcp
```

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

```json
{
  "mcpServers": {
    "agentreader": {
      "url": "https://agentreader.xyz/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "agentreader": {
      "type": "http",
      "url": "https://agentreader.xyz/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agentreader": {
      "serverUrl": "https://agentreader.xyz/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agentreader": {
      "type": "http",
      "url": "https://agentreader.xyz/mcp"
    }
  }
}
```

## FAQ

### How many free reads are there?

Five per day per IP, with no signup or key.

### Does it work on every site?

No. Pages with strong bot protection, logins or paywalls usually cannot be read, and failed reads are free.

### Do I need an account or wallet?

No. Free reads need nothing, and credit packs come with an API key after paying by card or USDC.

### What is logged?

Only each read's hostname, not the path or query; IPs are salted hashes kept 30 days.

### Is AgentReader free?

AgentReader has a free plan, with paid plans for more usage or features.

### How do I add AgentReader to Claude Code?

Run this command in your terminal: claude mcp add --transport http agentreader https://agentreader.xyz/mcp

### What are the best alternatives to AgentReader?

The closest alternatives to AgentReader 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/agentreader
