agentreader-mcp

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