Amanchain Mcp

io.github.gitajhdv1.0.1Updated Oct 6, 2026

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

VerifiedSTDIODesktop onlyAI & ML Web Search & Scraping Finance

Overview

AI-generated overview

Gives an assistant 59 pay-per-call AI services, from crypto prices to LLM chat and web search, paid automatically in USDC on Base.

What it does: Exposes a catalog tool plus one tool per service, covering crypto prices and token audits, whale alerts, market reports, LLM chat, image generation, invoices and receipts, web fetch/search/summarize, geolocation, translation and other utilities. Each paid call is quoted in a signed 402 challenge and settled on-chain in USDC on Base, with a receipt. The catalog, prices and service discovery work without a wallet; paid calls explain what to configure.
When to use it: Useful when an assistant needs metered access to many small AI and data services without signing up for each provider or managing API keys, and when paying per call in USDC on Base is acceptable. It suits crypto and market data lookups, quick LLM or image calls, and web fetch or summarization inside an agent workflow.
Requirements: Runs locally over stdio, typically via npx amanchain-mcp, so Node.js is needed. Paid calls require a Base wallet holding USDC and the AMAN_PRIVATE_KEY environment variable; optional variables include AMAN_ORIGIN, AMAN_MAX_USD_PER_CALL, AMAN_MAX_USD_PER_DAY and AMAN_SPEND_LEDGER. Network access to the service endpoint is required. Desktop MCP clients only.

Before you install

Paid calls spend real USDC from the wallet whose key is supplied in AMAN_PRIVATE_KEY, which signs EIP-3009 transfers locally. Spending caps default to $0.05 per call and $1.00 per day and are persisted in a local spend file; review them before use. Prices come from the server's signed 402 challenge, so the server sets what you pay. Service results and receipts are settled on-chain and sent to a third-party marketplace.

Installation

In SourceWeft

Open Amanchain Mcp in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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)

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

Claude Code

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

json

{  "mcpServers": {    "amanchain": {      "command": "npx",      "args": ["-y", "amanchain-mcp"],      "env": { "AMAN_PRIVATE_KEY": "0xYOUR_KEY" }    }  }}

{  "mcpServers": {    "amanchain": {      "command": "npx",      "args": ["-y", "amanchain-mcp"],      "env": { "AMAN_PRIVATE_KEY": "0xYOUR_KEY" }    }  }}

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:

Tool	What it does	Price
`aman_crypto_price`	Live crypto price	~$0.001
`aman_token_audit`	On-chain token audit (backing, flags, holders, depth)	~$0.025
`aman_market_report`	Full market report	~$0.03
`aman_llm_chat`	LLM completion	~$0.008
`aman_image_gen`	Image generation	~$0.013
`aman_web_search` / `aman_web_fetch` / `aman_summarize`	Web pipeline	~$0.003–0.008
`aman_crypto_whale_watch`	Whale 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

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.

Tools

Tool metadata has not been indexed yet.

Version history

v1.0.1LatestOct 6, 2026