Amanchain MCP server

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 (claudedesktopconfig.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 AMANPRIVATEKEY — 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:

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.
• AMANMAXUSDPERCALL (default $0.05) — refuses any pricier quote.
• AMANMAXUSDPERDAY (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: AMANPRIVATEKEY, AMANORIGIN, AMANMAXUSDPERCALL, AMANMAXUSDPERDAY, AMANSPEND_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