English Français العربية

io.github.ajanani1/agentreader-mcp

Official registry AI and agents

11 pay-per-call web tools for AI agents, auto-paid in USDC on Base via x402. No API keys.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package agentreader-mcp
Claude Code 
claude mcp add agentreader-mcp -e 'AGENTREADER_PRIVATE_KEY=<your agentreader_private_key>' -e 'AGENTREADER_API=<AGENTREADER_API>' -- npx -y agentreader-mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "agentreader-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "agentreader-mcp@1.0.0"
            ],
            "env": {
                "AGENTREADER_PRIVATE_KEY": "<your agentreader_private_key>",
                "AGENTREADER_API": "<AGENTREADER_API>"
            }
        }
    }
}

Environment variables

  • AGENTREADER_PRIVATE_KEY required secret 0x-prefixed private key of a wallet holding USDC on Base mainnet (use a dedicated agent wallet)
  • AGENTREADER_API API base URL override (default https://agentreader.dev)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. agentreader-mcp
  2. Tools
  3. Setup
  4. How payment works
  5. API without MCP
  6. License

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

ToolPriceWhat it does
read_page$0.005Web page → clean LLM-ready markdown article
page_metadata$0.002Title, OpenGraph, Twitter cards, JSON-LD, headings
clean_html$0.003Raw HTML → markdown
pdf_text$0.01PDF URL → full text (up to 25 MB)
parse_feed$0.003RSS/Atom/RDF feed → normalized JSON items
parse_sitemap$0.003XML sitemap → URL list
extract_links$0.002Page link graph with anchor text
dns_lookup$0.001DNS records with TTLs
screenshot$0.02Real-browser PNG screenshot
summarize$0.02AI summary of URL or text (dense, factual)
extract_structured$0.03Page/text → JSON matching your JSON Schema
sanctions_screen$0.05OFAC SDN + Consolidated screening: fuzzy transliteration-aware name match or crypto-address lookup, with verdict + list provenance
x402_trust_lookup$0.05Verified-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

Frequently asked questions

What is io.github.ajanani1/agentreader-mcp?

11 pay-per-call web tools for AI agents, auto-paid in USDC on Base via x402. No API keys.

How do I install io.github.ajanani1/agentreader-mcp?

It runs on your machine. In Claude Code: claude mcp add agentreader-mcp -e 'AGENTREADER_PRIVATE_KEY=<your agentreader_private_key>' -e 'AGENTREADER_API=<AGENTREADER_API>' -- npx -y agentreader-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ajanani1/agentreader-mcp need an API key?

Yes. It expects AGENTREADER_PRIVATE_KEY, which you set in its configuration.

Is io.github.ajanani1/agentreader-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.ajanani1/agentreader-mcp?

It is published by ajanani1. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.