Back to Directory/Developer Tools

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.

Developer ToolsJavaScriptv1.0.0

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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y agentreader-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-ajanani1-agentreader-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentreader-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

agentreader-mcpnpm

Compatible MCP Clients

io.github.ajanani1/agentreader-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More