{
  "markdown": "# AmanChain\n[![smithery badge](https://smithery.ai/badge/sat-ma/amanchain)](https://smithery.ai/servers/sat-ma/amanchain)\n[![AmanChain MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/gitajhd/amanchain/badges/card.svg)](https://glama.ai/mcp/servers/gitajhd/amanchain)\n\n> 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](https://www.x402.org). No accounts, no API keys, no subscriptions. Payment IS authentication.\n\n\n**Live MCP server:** `https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet`\n**Registry listing:** [`io.github.gitajhd/amanchain`](https://registry.modelcontextprotocol.io) - Official MCP Registry, v2.28.0\nAlso listed on Smithery: https://smithery.ai/server/@sat-ma/amanchain\n---\n\n## What is this?\n\nAmanChain 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**: 50 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](https://www.x402.org) HTTP-native payment protocol.\n\nEvery payment is verified against a real mined transaction 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.\n\n## Connect from any MCP client\n\nAmanChain exposes a remote MCP server (streamable HTTP, protocol `2025-06-18`, 11 tools). Point your MCP client at:\n\n```json\n{\n  \"mcpServers\": {\n    \"amanchain\": {\n      \"url\": \"https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet\"\n    }\n  }\n}\n```\n\nWorks 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 50 paid services.\n\n## Buy any service with plain HTTP (x402)\n\nTwo payment rails, both x402-native:\n\n| Rail | How it works | Best for |\n|---|---|---|\n| **USDC on Base** | Standard x402: unpaid request -> `402` with payment requirements -> retry with `X-PAYMENT` / `PAYMENT-SIGNATURE` header -> `200` + settlement receipt. Verified & settled by the Coinbase facilitator (EIP-3009, gasless). | Existing x402 clients and wallets |\n| **AMAN (native)** | `402` with price + pay-to address -> sign an `agent_invoke` transaction (chainId 1) -> broadcast -> re-request with the txId -> node verifies on-chain and executes. | Zero third parties, on-chain settlement |\n\n### Quick start (native AMAN, 3 steps)\n\n```bash\n# 1. Get the 402 payment requirements for a service\ncurl -s -X POST \"https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"serviceId\":\"aman-crypto-prices\"}'\n\n# 2. Pay: sign an agent_invoke transaction for the exact price and broadcast it\n#    POST https://amanchain-relay.gitajhd.workers.dev/api/v1/tx\n\n# 3. Retry with the txId - the node verifies the real on-chain payment\ncurl -s -X POST \"https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"serviceId\":\"aman-crypto-prices\",\"payment\":{\"txId\":\"<your-txid>\"}}'\n```\n\n### Quick start (USDC on Base, standard x402)\n\n```bash\n# GET or POST any service resource unpaid -> HTTP 402 with \"accepts\" requirements\ncurl -s \"https://amanchain-relay.gitajhd.workers.dev/api/x402/aman-token-audit\"\n# Sign per the accepts block (scheme \"exact\", network eip155:8453) and retry\n# with your signature in the X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2) header.\n# A 200 response carries the real result + the settlement receipt.\n```\n\n## The marketplace (50 live services)\n\nFull live catalog with per-call prices: **[`/llms.txt`](https://amanchain-relay.gitajhd.workers.dev/llms.txt)** (machine-readable, prices update with the AMAN AMM) or **[`/services.json`](https://amanchain-relay.gitajhd.workers.dev/services.json)**. Entry prices start around **$0.001 per call**.\n\n| Category | Flagship services |\n|---|---|\n| **On-chain audits** | Token Risk Audit , Token Supply Audit , Stablecoin Health , Token Launch Check |\n| **Market data** | Live Crypto Prices (BTC/ETH/SOL/BNB/LTC) , AMAN Price Feed , OHLC History , Swap Quotes , Pool Analytics , Arbitrage Scan |\n| **Web & utilities** | Live Web Search , Fetch Web Page , RSS Reader , Domain RDAP , IP Geolocation , Weather + Forecast , FX Rates , Translate , Email Validation |\n| **AI generation** | AI Text Generation (LLM) , AI Image Generation (1024x1024 PNG) , Summarize , Sentiment Analysis |\n| **Network & explorer** | Network Stats , Fee & Gas Tracker , Block Inspector , Transaction Lookup , Bridge Status , Agent Roster |\n| **Business documents** | Invoice PDF , Pro Forma Invoice , Payment Receipt , Credit Note , Quote & Estimate |\n\n### Invoice fleet (5 document families, real PDFs)\n\nAgents 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:\n\n| Service | Document | Extras |\n|---|---|---|\n| `aman-invoice-pdf` | INVOICE | due date, notes |\n| `aman-invoice-proforma` | PROFORMA INVOICE | validity date (customs / advance payment) |\n| `aman-receipt-payment` | PAYMENT RECEIPT | payment method + transaction reference + paid date |\n| `aman-credit-note` | CREDIT NOTE | original-invoice reference, negative lines allowed |\n| `aman-quote-estimate` | QUOTE | validity date (devis / estimate) |\n\n```json\nPOST https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet\n{\"serviceId\":\"aman-invoice-pdf\",\"request\":\"{\\\"invoiceNumber\\\":\\\"INV-1\\\",\\\"buyer\\\":{\\\"name\\\":\\\"Acme\\\"},\\\"items\\\":[{\\\"description\\\":\\\"Work\\\",\\\"qty\\\":1,\\\"unitPrice\\\":50}],\\\"vatRate\\\":20}\"}\n```\n\nEvery service response is deterministic where the task is deterministic (audits, lookups, quotes, document rendering) and carries a signed x402 receipt.\n\n## Discovery surfaces (for agents)\n\n| Surface | URL |\n|---|---|\n| MCP endpoint | `https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet` |\n| Agent catalog (llms.txt) | https://amanchain-relay.gitajhd.workers.dev/llms.txt |\n| Agent card | https://amanchain-relay.gitajhd.workers.dev/.well-known/agent.json |\n| OpenAPI | https://amanchain-relay.gitajhd.workers.dev/openapi.json |\n| x402 discovery | https://amanchain-relay.gitajhd.workers.dev/x402/discovery |\n| Network explorer API | https://amanchain-relay.gitajhd.workers.dev/api/status |\n\n## Releases & integrity\n\nEach platform version is frozen as a signed 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 on this repository follow the `vX.Y.Z` tags of `package.json`; v2.28.0 is live.\n\n## Status\n\n- Mainnet live: PoW consensus, agent autopilot settling real x402 calls around the clock\n- Official MCP Registry: [`io.github.gitajhd/amanchain`](https://registry.modelcontextprotocol.io) - active\n- All 50 services indexed and purchasable today\n",
  "bytes": 7293,
  "sha": "18cd8880f08d3912c14f3f6bbc1905a34ec8f3520feac11bf3c7df0306e796ca",
  "repo_slug": "gitajhd/amanchain",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gitajhd_amanchain_e0075d40/readme"
}