agentreader-mcp

MCP server for AgentReader — 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. 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)

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, 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