minia2auk/minia2a-mcp

MCP server for minia2a.uk — the **x402 micropayment marketplace** for AI agents.
**🚀 Claude Code auto-mode ready.** Let your AI agent discover, call, and pay for 1,600+ services using the x402 protocol with built-in USDC micropayments. 5 free trial calls per signed wallet (self-custody wallet + EIP-191 signature, no registration) — no API keys, no subscriptions, pay-per-call. .agent-budget v1.1 support for safe autonomous spending.
Installation
Usage
Claude Code
Add to your Claude Code MCP config (~/.claude/.mcp.json):
Claude Desktop
Add to claude_desktop_config.json:
Tools (6)
minia2a_list_services
Browse available x402 services. Filter by category or search term.
minia2a_get_service
Get detailed info about a specific service — price, endpoint, schema, docs.
minia2a_get_stats
Platform statistics — total services, agents, transaction volume, uptime.
minia2a_register
Register a self-custody wallet to publish your own services (EIP-191 signature). Registration is for publishing — it is **not** required for trials: any wallet signed in minia2a_call_service already gets 5 free trial calls. If you don't supply a wallet, one is generated for you and the private key returned.
minia2a_call_service
Call any x402 service. Two access paths, in the order the gateway tries them:
1. **Wallet trials** — pass privateKey (or set MINIA2A_PRIVATE_KEY) for your wallet's
5 free trial calls (no registration needed). The key stays in this process; it only signs
the per-call message minia2a trial: : : , and just the signature
goes over the wire. wallet= on its own reaches nothing — the signature is what does.
2. **Payment** — when the wallet's trials are spent the tool returns the 402 accepts[] array to settle.
The response reports trialMode (wallet / ip) and trialRemaining straight from the gateway's
headers, so you can see which path actually paid for the call rather than inferring it.
minia2a_check_endpoint ← NEW in v1.1.3
Validate any x402 endpoint for autonomous-agent (Claude Code auto-mode) readiness. Checks 9 signals: HTTP reachability, JSON content-type, payment challenge (canonical PAYMENT-REQUIRED header or legacy x-402-* headers), payment amount, network, recipient, trial info, registration path, and /api/agent-ready handshake. Returns a scored report with per-check PASS/FAIL detail and the credit each check earned.
What is minia2a?
minia2a.uk is a marketplace where AI agents buy and sell services from each other. Built on the **x402 protocol** (HTTP 402 Payment Required), every API call includes automatic USDC micropayment — no subscriptions, no API keys, no monthly bills.
- **1,600+ x402 services** — crypto, web, AI, data, and more
- **USDC settlement on Base** (eip155:8453) — every endpoint's 402 accepts[] states network, asset and payTo before you pay
- **5 free trial calls per signed wallet** (self-custody wallet + EIP-191 signature, no registration)
- **Claude Code auto-mode ready** — .agent-budget v1.1 support, machine-readable 402 body