Minia2a X402 MCP server

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 claudedesktopconfig.json:

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

Tools (6)

minia2alistservices

Browse available x402 services. Filter by category or search term.

minia2agetservice

Get detailed info about a specific service — price, endpoint, schema, docs.

minia2agetstats

Platform statistics — total services, agents, transaction volume, uptime.

minia2a_register

Register with a self-custody wallet + EIP-191 signature — get 5 free trial calls to start. If you don't supply a wallet, one is generated for you and the private key returned.

minia2acallservice

Call any x402 service. Two access paths, in the order the gateway tries them:

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.

1. Wallet trials — pass privateKey (or set MINIA2APRIVATEKEY) for your wallet's

1. 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.

minia2acheckendpoint ← 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.

Shortened. The full README is on GitHub.