English Français العربية

dev.charliemorrison/agent-web-reader

السجل الرسمي المالية والمدفوعات

Pay-per-call data tools for AI agents: crypto signal, web reader, SEO audit. x402 USDC on Base.

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

ماذا يمكنك أن تفعل مع dev.charliemorrison/agent-web-reader؟

  • GET / — discovery doc (service + paid-endpoint metadata, x402-aware)
  • GET /healthz — liveness
  • GET /.well-known/mcp.json — MCP discovery manifest
  • GET /.well-known/agent.json — A2A Agent Card
  • POST /mcp — remote MCP server (Streamable HTTP). Lists the three tools; an

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http agent-web-reader 'https://x402.charliemorrison.dev/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "agent-web-reader": {
            "type": "http",
            "url": "https://x402.charliemorrison.dev/mcp"
        }
    }
}

التوثيق

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

المحتويات
  1. x402-agent-data
  2. Tools
  3. How payment works
  4. Run it
  5. Why this shape
  6. License

x402-agent-data

Pay-per-call data tools for AI agents, settled per call in USDC on Base via the **x402** protocol. The buyer is another agent: it discovers an endpoint, auto-pays per request (HTTP 402 → payment → data), and gets structured JSON back. No API key, no signup, no account — the seller's only setup is one public wallet address.

Live at **https://x402.charliemorrison.dev** — also listed as a remote MCP server in the Official MCP Registry as dev.charliemorrison/agent-web-reader.

Tools

ToolEndpointPriceReturns
market_signalGET /signal$0.005Crypto market signal (price/trend/momentum) for a symbol
web_readGET /extract$0.005Clean, readable text + metadata extracted from any URL
repo_auditGET /audit?owner=&repo=$0.005GitHub repo discoverability/SEO score (0–100) + concrete fixes

Free, unpaid routes:

  • GET / — discovery doc (service + paid-endpoint metadata, x402-aware)
  • GET /healthz — liveness
  • GET /.well-known/mcp.json — MCP discovery manifest
  • GET /.well-known/agent.json — A2A Agent Card
  • POST /mcp — remote MCP server (Streamable HTTP). Lists the three tools; an unpaid tools/call returns the decoded x402 payment-required challenge, and a call carrying an x402 payment returns the data.

How payment works

  1. Agent calls a paid route with no payment → server responds HTTP 402 with an x402 challenge (amount, asset = USDC, network = base, payTo address).
  2. Agent's x402 client signs a payment authorization and retries with the X-PAYMENT header.
  3. Server verifies/settles via an x402 facilitator and returns the data.

No private key ever lives in this server's config — it only receives. Settlement is delegated to an x402 facilitator (default: a zero-fee, gas-sponsored facilitator; Coinbase CDP facilitator is supported via env and inert unless configured).

Run it

npm install
PAY_TO=0xYourReceivingAddress node server.js   # listens on :4021

Environment:

  • PAY_TO — your receiving wallet (USDC on Base). Required for real revenue.
  • PORT — default 4021.
  • CDP_API_KEY_ID / CDP_API_KEY_SECRET — optional; switches settlement to the Coinbase CDP facilitator. Omitted by default.

Why this shape

The buyer is a machine and distribution is a registry — there's no cold human audience to recruit, which is the wall that kills most indie API/tool launches. Seller setup is a single wallet address; every call is zero-marginal-cost public data.

License

MIT

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

ما هو dev.charliemorrison/agent-web-reader؟

Pay-per-call data tools for AI agents: crypto signal, web reader, SEO audit. x402 USDC on Base.

كيف أثبّت dev.charliemorrison/agent-web-reader؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http agent-web-reader 'https://x402.charliemorrison.dev/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج dev.charliemorrison/agent-web-reader إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل dev.charliemorrison/agent-web-reader مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون dev.charliemorrison/agent-web-reader؟

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

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