io.github.gitajhd/amanchain
AmanChain: quantum-resistant x402 payments. Remote MCP, 50 paid services. USDC on Base or AMAN.
Open source Repository Open in the app JSON README (API)
About
AmanChain: quantum-resistant x402 payments. Remote MCP, 50 paid services. USDC on Base or AMAN.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- gitajhd
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 2.28.0
- Last push
- 2026-09-08T18:10:00Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-09-07 16:07:29
- Updated
- 2026-09-08 01:01:06
- Origin id
io.github.gitajhd/amanchain
README
# AmanChain
[](https://smithery.ai/servers/sat-ma/amanchain)
[](https://glama.ai/mcp/servers/gitajhd/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](https://www.x402.org). No accounts, no API keys, no subscriptions. Payment IS authentication.
**Live MCP server:** `https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet`
**Registry listing:** [`io.github.gitajhd/amanchain`](https://registry.modelcontextprotocol.io) - Official MCP Registry, v2.28.0
Also listed on Smithery: https://smithery.ai/server/@sat-ma/amanchain
---
## 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**: 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.
Every 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.
## Connect from any MCP client
AmanChain exposes a remote MCP server (streamable HTTP, protocol `2025-06-18`, 11 tools). Point your MCP client at:
```json
{
"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 50 paid services.
## Buy any service with plain HTTP (x402)
Two payment rails, both x402-native:
| Rail | How it works | Best for |
|---|---|---|
| **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 |
| **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 |
### Quick start (native AMAN, 3 steps)
```bash
# 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>"}}'
```
### Quick start (USDC on Base, standard x402)
```bash
# GET or POST any service resource unpaid -> HTTP 402 with "accepts" requirements
curl -s "https://amanchain-relay.gitajhd.workers.dev/api/x402/aman-token-audit"
# Sign per the accepts block (scheme "exact", network eip155:8453) and retry
# with your signature in the X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2) header.
# A 200 response carries the real result + the settlement receipt.
```
## The marketplace (50 live services)
Full 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**.
| Category | Flagship services |
|---|---|
| **On-chain audits** | Token Risk Audit , Token Supply Audit , Stablecoin Health , Token Launch Check |
| **Market data** | Live Crypto Prices (BTC/ETH/SOL/BNB/LTC) , AMAN Price Feed , OHLC History , Swap Quotes , Pool Analytics , Arbitrage Scan |
| **Web & utilities** | Live Web Search , Fetch Web Page , RSS Reader , Domain RDAP , IP Geolocation , Weather + Forecast , FX Rates , Translate , Email Validation |
| **AI generation** | AI Text Generation (LLM) , AI Image Generation (1024x1024 PNG) , Summarize , Sentiment Analysis |
| **Network & explorer** | Network Stats , Fee & Gas Tracker , Block Inspector , Transaction Lookup , Bridge Status , Agent Roster |
| **Business documents** | Invoice PDF , Pro Forma Invoice , Payment Receipt , Credit Note , Quote & Estimate |
### 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:
| Service | Document | Extras |
|---|---|---|
| `aman-invoice-pdf` | INVOICE | due date, notes |
| `aman-invoice-proforma` | PROFORMA INVOICE | validity date (customs / advance payment) |
| `aman-receipt-payment` | PAYMENT RECEIPT | payment method + transaction reference + paid date |
| `aman-credit-note` | CREDIT NOTE | original-invoice reference, negative lines allowed |
| `aman-quote-estimate` | QUOTE | validity date (devis / estimate) |
```json
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)
| Surface | URL |
|---|---|
| MCP endpoint | `https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet` |
| Agent catalog (llms.txt) | https://amanchain-relay.gitajhd.workers.dev/llms.txt |
| Agent card | https://amanchain-relay.gitajhd.workers.dev/.well-known/agent.json |
| OpenAPI | https://amanchain-relay.gitajhd.workers.dev/openapi.json |
| x402 discovery | https://amanchain-relay.gitajhd.workers.dev/x402/discovery |
| Network explorer API | https://amanchain-relay.gitajhd.workers.dev/api/status |
## Releases & integrity
Each 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.
## Status
- Mainnet live: PoW consensus, agent autopilot settling real x402 calls around the clock
- Official MCP Registry: [`io.github.gitajhd/amanchain`](https://registry.modelcontextprotocol.io) - active
- All 50 services indexed and purchasable today