AmanChain MCP server
Commit Sep 11, 2026Lets an AI client access a marketplace of 52 paid services including market data, on-chain audits, and document generation via quantum-resistant x402 payments.
Also known as gitajhd/amanchain
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2.28.0
- Last commit
- Sep 11, 2026
- License
- MIT
What is AmanChain MCP?
AmanChain lets an AI client access a marketplace of 52 paid services including market data, on-chain audits, and document generation via quantum-resistant x402 payments.
Summary generated from the project's README
About AmanChain MCP server
AmanChain provides an MCP server that connects AI clients to a marketplace of 52 specialized services. These services include market data, on-chain audits, AI generation, and business document creation. The system is built on a quantum-resistant proof-of-work blockchain using hybrid ML-DSA-87 and Ed25519 signatures to ensure long-term security.
Users connect via a remote HTTP endpoint to clients like Claude Desktop, Cursor, or Windsurf. Instead of traditional accounts or API keys, the server uses the x402 payment protocol for authentication. This allows agents to pay for services per call using USDC on Base as the primary rail or native AMAN as a secondary option. The aman_invoke_service tool serves as the primary gateway for purchasing and executing these tasks.
Transactions are secured through on-chain escrow and automatic refunds if execution fails. The platform also maintains public trust scores for agents based on actual escrow outcomes rather than self-reported data. This setup enables autonomous agents to trade services with minimal friction and high verifiable integrity.
What you can do with it
- 1Execute paid service callsAn AI agent can purchase and run any service from the catalog using a single tool command.
- 2Generate professional business documentsDevelopers can request the creation of real A4 PDF invoices, receipts, or credit notes via JSON requests.
- 3Perform on-chain security auditsAn AI client can request specific audits for token risks, supply, or stablecoin health.
- 4Access real-time market intelligenceUsers can fetch live cryptocurrency prices, swap quotes, or arbitrage scans.
Written from the project's README. Every use case is checked against a quote from it.
How to install AmanChain MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AmanChain MCP in Claude Code
$ claude mcp add --transport http amanchain 'https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet'Install AmanChain MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"amanchain": {
"url": "https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet"
}
}
}Install AmanChain MCP in VS Code
.vscode/mcp.json
{
"servers": {
"amanchain": {
"type": "http",
"url": "https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet"
}
}
}Install AmanChain MCP in VS Code CLI
$ code --add-mcp '{"name":"amanchain","type":"http","url":"https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet"}'Install AmanChain MCP in Codex
$ codex mcp add amanchain --url 'https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet'Install AmanChain MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.amanchain] url = "https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet"
Install AmanChain MCP in Gemini CLI
$ gemini mcp add -s user --transport http amanchain 'https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet'Install AmanChain MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"amanchain": {
"url": "https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablegitajhd/amanchain is public and reachablegithub.com/gitajhd/amanchain ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-11github.com/gitajhd/amanchain ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2024-11-05 in 1461 msPass
README
View on GitHubAmanChain
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:
| Rail | Status | How it works | Best for |
|---|---|---|---|
| USDC on Base (primary) | ✅ live | Standard x402: unpaid request → 402 with accepts[0] (scheme exact, network eip155:8453) → sign EIP-3009 → retry with X-PAYMENT / PAYMENT-SIGNATURE → 200 + settlement receipt. Verified & settled by the Coinbase facilitator, gasless. |
Any compliant x402 client — regular USDC, no AMAN needed |
| AMAN native (secondary) | ✅ live | 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 (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 inFUNDED; 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.
| 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) |
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 |
| x402 well-known (primary rail declared here) | https://amanchain-relay.gitajhd.workers.dev/.well-known/x402 |
| Agent catalog (llms.txt) | https://amanchain-relay.gitajhd.workers.dev/llms.txt (also under /.well-known/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 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
AmanChain MCP questions
How do I add AmanChain MCP to Claude Code?
Run claude mcp add --transport http amanchain 'https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet' in your terminal. Add --scope user to make it available in every project.
How do I add AmanChain MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need an account or API key to use the services?
No, the platform requires no accounts, no API keys, and no subscriptions; payment itself serves as authentication.
What happens if a service execution fails after I have paid?
If execution fails after payment, an automatic on-chain refund is triggered to ensure funds are not stuck.
Can I use AmanChain with Claude Desktop or Cursor?
Yes, it works with any MCP client including Claude Desktop/Code, Cursor, Windsurf, and Cline.