Repository avatar
AI Tools
v1.0.1
active

amanchain-mcp

io.github.gitajhd/amanchain-mcp

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

Documentation

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.

Links

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

MIT © AmanChain

NPM
amanchain-mcp
Install Command
npm install amanchain-mcp