English Français العربية

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.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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>"
            }
        }
    }
}

متغيرات البيئة

  • AGENTREADER_PRIVATE_KEY إلزامي سري 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)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو 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.

كيف أثبّت io.github.ajanani1/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ajanani1/agentreader-mcp إلى مفتاح API؟

نعم. يتطلب AGENTREADER_PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.ajanani1/agentreader-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.ajanani1/agentreader-mcp؟

ينشره ajanani1. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.