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

npm install -g minia2a-mcp

Usage

Claude Code

Add to your Claude Code MCP config (~/.claude/.mcp.json):

{
  "mcpServers": {
    "minia2a": {
      "command": "npx",
      "args": ["-y", "minia2a-mcp"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "minia2a": {
      "command": "npx",
      "args": ["-y", "minia2a-mcp"]
    }
  }
}

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:<wallet>:<serviceId>:<unixSeconds>, 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

Claude Code Auto Mode

Claude Code auto mode is the default. Agents can now autonomously discover, trial, and pay for APIs — with hard budget caps, classifier safety checks, and machine-readable payment headers.

minia2a is auto-mode ready:

• /api/agent-ready — machine-readable handshake with payment info, registration endpoint, and quickstart
• 402 body: accepts[] array (amount/asset/network/payTo/scheme) — agent parses full payment instruction (x402 V2)
• .agent-budget v1.1 — 7-field autonom

... View full README on GitHub