agentreader-mcp
MCP server for AgentReader — 11 pay-per-call web intelligence tools for AI agents, paid automatically in USDC on Base via the x402 protocol. No API keys, no accounts: your agent's wallet pays $0.001–$0.03 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 |
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:
{
"mcpServers": {
"agentreader": {
"command": "npx",
"args": ["-y", "agentreader-mcp"],
"env": { "AGENTREADER_PRIVATE_KEY": "0xYourAgentWalletPrivateKey" }
}
}
}
Also listed in the official MCP Registry as io.github.ajanani1/agentreader-mcp and on npm.
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, defaulthttps://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 · OpenAPI · llms.txt · x402 discovery
License
MIT