English Français العربية

io.github.gitajhd/amanchain-mcp

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

59 pay-per-call AI services as MCP tools with automatic x402 USDC-on-Base payment.

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

التثبيت

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

NPM package amanchain-mcp
Claude Code 
claude mcp add amanchain-mcp -- npx -y amanchain-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "amanchain-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "amanchain-mcp@1.0.1"
            ]
        }
    }
}

التوثيق

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

المحتويات
  1. AmanChain MCP Gateway
  2. Quickstart (60 seconds)
  3. What your agent gets
  4. Safety
  5. How it works
  6. Links

AmanChain MCP Gateway

59 pay-per-call AI services as MCP tools — with automatic x402 payment in USDC on Base.

Crypto prices & audits, whale alerts, market reports, LLM chat, image generation, invoices & receipts, web fetch/search/summarize, geolocation, translation, and more — no API keys, no signups, no subscriptions. Your agent pays per call with USDC (gasless — the facilitator covers gas), every settlement lands on-chain with a receipt.

Works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

Quickstart (60 seconds)

  1. Get a Base wallet with ~$1 of USDC (Coinbase → withdraw USDC → Base network, or bridge.base.org).
  2. Add the server:

Claude Code

claude mcp add amanchain -e AMAN_PRIVATE_KEY=0xYOUR_KEY -- npx -y amanchain-mcp

Claude Desktop / Cursor (claude_desktop_config.json / mcp.json)

{
  "mcpServers": {
    "amanchain": {
      "command": "npx",
      "args": ["-y", "amanchain-mcp"],
      "env": { "AMAN_PRIVATE_KEY": "0xYOUR_KEY" }
    }
  }
}
  1. Ask your agent: "use amanchain to get the current BTC price" — done.

No wallet yet? Run it without AMAN_PRIVATE_KEY — the catalog, prices and service discovery all work; paid calls explain exactly what to set up.

What your agent gets

amanchain_catalog first, then one tool per service. Highlights:

ToolWhat it doesPrice
aman_crypto_priceLive crypto price~$0.001
aman_token_auditOn-chain token audit (backing, flags, holders, depth)~$0.025
aman_market_reportFull market report~$0.03
aman_llm_chatLLM completion~$0.008
aman_image_genImage generation~$0.013
aman_web_search / aman_web_fetch / aman_summarizeWeb pipeline~$0.003–0.008
aman_crypto_whale_watchWhale transaction watch~$0.10
aman_geo_ip, aman_weather, aman_fx_rates, aman_translate …utilities~$0.001–0.005

Prices are set by the network, quoted live in every 402 response, and published in the live catalog. Every payment produces an on-chain receipt — see the public receipts ledger.

Safety

  • Your key never leaves your machine — it only signs EIP-3009 USDC transfers locally.
  • AMAN_MAX_USD_PER_CALL (default $0.05) — refuses any pricier quote.
  • AMAN_MAX_USD_PER_DAY (default $1.00) — rolling daily cap, persisted in ~/.amanchain-mcp-spend.json.
  • Prices are taken only from the server's signed 402 challenge — never guessed.

All env vars: AMAN_PRIVATE_KEY, AMAN_ORIGIN, AMAN_MAX_USD_PER_CALL, AMAN_MAX_USD_PER_DAY, AMAN_SPEND_LEDGER.

How it works

agent ── tools/call ──▶ amanchain-mcp ──▶ POST /api/x402/<service>
                              ◀────────── 402 + signed price challenge
        local EIP-3009 signature (USDC on Base, gasless)
                              ──▶ retry + PAYMENT-SIGNATURE
                              ◀────────── 200 + result + on-chain receipt

AmanChain is a quantum-resistant proof-of-work chain whose AI marketplace settles agent payments on-chain — service results and receipts are mined into blocks.

  • Live catalog: /.well-known/x402.json
  • Public receipts: /receipts
  • Ecosystem: x402scan · 402index

MIT © AmanChain

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

ما هو io.github.gitajhd/amanchain-mcp؟

59 pay-per-call AI services as MCP tools with automatic x402 USDC-on-Base payment.

كيف أثبّت io.github.gitajhd/amanchain-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add amanchain-mcp -- npx -y amanchain-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

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

من يصون io.github.gitajhd/amanchain-mcp؟

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

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