# agentreader-mcp

MCP server for [AgentReader](https://agentreader.dev) — 13 pay-per-call tools for AI agents (web intelligence, OFAC sanctions screening, x402 trust data), paid automatically in USDC on Base via the [x402 protocol](https://www.x402.org). No API keys, no accounts: your agent's wallet pays $0.001–$0.05 per call and failed requests are never charged.

## Tools

| Tool | Price | What it does |
|---|---|---|
| `read_page` | $0.005 | Web page → clean LLM-ready markdown article |
| `page_metadata` | $0.002 | Title, OpenGraph, Twitter cards, JSON-LD, headings |
| `clean_html` | $0.003 | Raw HTML → markdown |
| `pdf_text` | $0.01 | PDF URL → full text (up to 25 MB) |
| `parse_feed` | $0.003 | RSS/Atom/RDF feed → normalized JSON items |
| `parse_sitemap` | $0.003 | XML sitemap → URL list |
| `extract_links` | $0.002 | Page link graph with anchor text |
| `dns_lookup` | $0.001 | DNS records with TTLs |
| `screenshot` | $0.02 | Real-browser PNG screenshot |
| `summarize` | $0.02 | AI summary of URL or text (dense, factual) |
| `extract_structured` | $0.03 | Page/text → JSON matching **your** JSON Schema |
| `sanctions_screen` | $0.05 | OFAC SDN + Consolidated screening: fuzzy transliteration-aware name match or crypto-address lookup, with verdict + list provenance |
| `x402_trust_lookup` | $0.05 | Verified-delivery history for any x402 service, built from real paid test purchases (free aggregate: [/leaderboard](https://agentreader.dev/leaderboard)) |

## Setup

You need a wallet holding a little USDC on **Base mainnet** ($1 covers hundreds of calls). Use a dedicated agent wallet, not your main one.

Claude Desktop / Claude Code / any MCP client:

```json
{
  "mcpServers": {
    "agentreader": {
      "command": "npx",
      "args": ["-y", "agentreader-mcp"],
      "env": { "AGENTREADER_PRIVATE_KEY": "0xYourAgentWalletPrivateKey" }
    }
  }
}
```

Also listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=agentreader) as `io.github.ajanani1/agentreader-mcp` and on [npm](https://www.npmjs.com/package/agentreader-mcp).

Environment variables:

- `AGENTREADER_PRIVATE_KEY` (required) — private key of the paying wallet (USDC on Base; gas not needed, x402 uses gasless USDC authorizations)
- `AGENTREADER_API` (optional) — API base URL, default `https://agentreader.dev`

## How payment works

Each tool call hits the AgentReader API, receives an HTTP 402 with x402 payment requirements, signs a USDC authorization with your key, and retries. Settlement happens through the Coinbase CDP facilitator on Base mainnet. Errors (4xx/5xx) never settle — you only pay for delivered results.

## API without MCP

The same endpoints are callable directly over HTTP with any x402 client: [catalog](https://agentreader.dev/) · [OpenAPI](https://agentreader.dev/openapi.json) · [llms.txt](https://agentreader.dev/llms.txt) · [x402 discovery](https://agentreader.dev/.well-known/x402)

## License

MIT