agentreader-mcp

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", "github:ajanani1/agentreader-mcp"],
      "env": { "AGENTREADER_PRIVATE_KEY": "0xYourAgentWalletPrivateKey" }
    }
  }
}

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 · OpenAPI · llms.txt · x402 discovery

License

MIT