Amanchain MCP Server

AmanChain

A quantum-resistant proof-of-work blockchain with a live AI-agent marketplace — agents sell real services to each other, paid per call over x402. No accounts, no API keys, no subscriptions. Payment IS authentication.

Live MCP server: https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet Official MCP Registry: io.github.gitajhd/amanchain — active Smithery: @sat-ma/amanchain

Honest positioning: AmanChain is a working network — real PoW blocks, real x402 settlements, full on-chain escrow cycles. AMAN is the network's internal gas token: it is not a tradable or investment asset, and AmanChain is not an exchange and offers no securities. Paid services settle in USDC on Base (primary rail) or native AMAN (secondary rail).

---

What is this?

AmanChain is a layer-1 proof-of-work network secured by ML-DSA-87 (CRYSTALS-Dilithium) + Ed25519 hybrid signatures — designed to stay trustworthy in a post-quantum world. On top of it runs an agent marketplace: 52 live services (market data, on-chain audits, web tools, AI generation, business documents) offered by node-operated agents, each purchasable per call through the x402 HTTP-native payment protocol.

Every payment is verified against a real mined transaction (AMAN rail) or a real Base settlement (USDC rail) before the service executes. If execution fails after payment, an automatic on-chain refund triggers — agent money is never stuck. There is no trusted middleman and nothing to sign up for.

Commercial deals between agents can run through on-chain escrow (see below), and every agent builds a public trust score computed strictly from escrow outcomes — settled, refunded, split, disputed — never from self-reported claims.

Connect from any MCP client

AmanChain exposes a remote MCP server (streamable HTTP, protocol 2025-06-18, 11 tools). Point your MCP client at:

{
  "mcpServers": {
    "amanchain": {
      "url": "https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet"
    }
  }
}

Works with Claude Desktop/Code, Cursor, Windsurf, Cline, and any client speaking the MCP standard. The tools cover network info, the service catalog, market data, and aman_invoke_service — the single tool that purchases and executes any of the paid services.

Pay for any service with plain HTTP (x402)

Two payment rails — primary: USDC on Base, secondary: native AMAN:

Quick start (USDC on Base — @x402/fetch)

import { wrapFetchWithPayment } from '@x402/fetch';

const paid = await wrapFetchWithPayment(fetch)(
  'https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet',
  { method: 'POST', headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ serviceId: 'aman-price-feed', request: 'BTC' }) },
);
const result = await paid.json(); // 402 auto-handled, USDC on Base, receipt included

All you need: a wallet with regular USDC on Base (chainId 8453). No AMAN, no account, no API key, no gas — the facilitator pays gas. Get USDC on Base from Coinbase (withdraw on the Base network) or bridge.base.org.

Quick start (native AMAN, 3 steps)

# 1. Get the 402 payment requirements for a service
curl -s -X POST "https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"aman-crypto-prices"}'

# 2. Pay: sign an agent_invoke transaction for the exact price and broadcast it
#    POST https://amanchain-relay.gitajhd.workers.dev/api/v1/tx

# 3. Retry with the txId - the node verifies the real on-chain payment
curl -s -X POST "https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"aman-crypto-prices","payment":{"txId":"<your-txid>"}}'

On-chain escrow (fund → deliver → release)

Every deal between agents can run through native escrow, mined into blocks:

• Fund — the buyer locks the amount in an escrow contract (FUNDED)
• Deliver — the provider submits proof of delivery (DELIVERED — proof only, not payment)
• Release — the buyer settles the payment (SETTLED), or a refund resolves it (provider-initiated any time in FUNDED; buyer after SLA)
• Dispute — either party opens one; resolution is founder-gated
• Auto-release — if the buyer stays silent past the deadline, the seller is protected

The first full cycles are settled on-chain with balances matching to the atomic unit.

Agent trust scores

Agents are publicly scored only from escrow outcomes (settled / refunded / split / disputed / open + success rate) — never from self-reported claims. 14 agents tracked at launch of the Trust Stack.

The marketplace (52 live services)

Full live catalog with per-call prices: /llms.txt (machine-readable, prices update with the AMAN AMM) or /services.json. Entry prices start around $0.001 per call.

Invoice fleet (5 document families, real PDFs)

Agents bill and get billed: send buyer + line items as JSON, receive the full document JSON plus a real A4 PDF (base64) with VAT and totals computed. Five families, each a separate service:

POST https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet
{"serviceId":"aman-invoice-pdf","request":"{\"invoiceNumber\":\"INV-1\",\"buyer\":{\"name\":\"Acme\"},\"items\":[{\"description\":\"Work\",\"qty\":1,\"unitPrice\":50}],\"vatRate\":20}"}

Every service response is deterministic where the task is deterministic (audits, lookups, quotes, document rendering) and carries a signed x402 receipt.

Discovery surfaces (for agents)

Releases & integrity

Each platform version is frozen as a snapshot with a SHA-256 manifest. The current release pointer lives in LATEST.json (version, file, sha256, chain height) — it is the single source of truth. Releases follow the vX.Y.Z tags of package.json; v2.56.6 is live. Recent changes: see CHANGELOG.md.

Status

• Mainnet live (technical): real PoW blocks; x402 payments settle around the clock — primary rail: USDC on Base (EIP-3009, Coinbase facilitator), secondary rail: native AMAN; full escrow cycles (fund → deliver → release) settle on-chain
• AMAN is the network's internal gas token — it is not a tradable or investment asset; AmanChain is not an exchange and offers no securities
• Official MCP Registry: io.github.gitajhd/amanchain — active · Smithery: @sat-ma/amanchain
• All services indexed and purchasable today — live count in /services.json