MCP 服务器

minia2a-mcp

MCP server for the x402 micropayment marketplace minia2a.uk, enabling AI agents to discover, call, and pay for 1,700+ services using USDC micropayments with no API keys or subscriptions. Supports registration, credits, service browsing, and autonomous calling with Claude Code auto-mode.

README

minia2a-mcp

MCP server for minia2a.uk — the x402 micropayment marketplace for AI agents.

🚀 Claude Code auto-mode ready (Aug 14, 2026). Let your AI agent discover, call, and pay for 1,700+ services using the x402 protocol with built-in USDC micropayments. 500 free credits on registration (through Sep 1, 2026) with a self-custody wallet + EIP-191 signature — no API keys, no subscriptions. 15 free trial calls shared globally, no wallet needed to start. .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 (8)

`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 with a self-custody wallet + EIP-191 signature — get 500 free credits to start. If you don't supply a wallet, one is generated for you and the private key returned.

`minia2a_credits`

Explain the V5 credit/trial model + platform stats. (V5 has no per-wallet balance endpoint — credits decrement automatically per call.)

`minia2a_buy_credits`

Claim credits from a completed USDC on-chain transfer by submitting your transaction hash.

`minia2a_call_service`

Call any x402 service with ?wallet=<your-wallet> (credits decrement) or anonymously (trial). Handles the HTTP 402 payment flow.

`minia2a_check_endpoint` ← NEW in v1.1.3

Validate any x402 endpoint for Claude Code auto-mode readiness (Aug 14, 2026). Checks 9 signals: HTTP reachability, JSON content-type, 4 payment headers (amount/chain/token/recipient), trial info, registration path, and /api/agent-ready handshake. Returns a scored report with per-check PASS/FAIL detail.

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,700+ x402 services — crypto, web, AI, data, and more
772 registered agents — an emerging machine-to-machine economy
745K+ requests served — production-proven infrastructure
15 free trial calls shared globally — no wallet needed to start
500 free credits on registration — through Sep 1, 2026 (self-custody wallet + EIP-191 signature)
USDC settlement across 8 chains — Base, Algorand, and more
Claude Code auto-mode ready — .agent-budget v1.1 support, machine-readable 402 body

Claude Code Auto Mode (Aug 14, 2026)

Claude Code auto mode becomes the default on August 14. 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 autonomous-purchasing controls (per-call / per-task / confirmation / dedupe / settlement / audit)
15 free trial calls shared globally — no wallet, no registration
500 free credits on registration — try any paid endpoint

{
  "version": "1.1",
  "daily_limit_usdc": 5,
  "max_per_call_usdc": 1,
  "per_task_limit_usdc": 3,
  "confirmation_threshold_usdc": 0.5,
  "idempotency_key": "required",
  "verify_settlement": true,
  "audit_trail": true
}

Quickstart guide →

What is x402?

x402 is an open protocol that extends HTTP 402 Payment Required for machine-to-machine micropayments. Services declare their price in HTTP response headers, and clients pay in USDC on Base. No intermediaries, no settlement delays. x402 Foundation launched July 2026 under the Linux Foundation with 40+ founding members including Visa, Mastercard, Stripe, and Cloudflare.

Learn more at x402.org.

Ecosystem

minia2a offers multiple integration paths depending on your stack:

Package	Use Case	Install
minia2a-mcp (this)	MCP server for Claude, Cursor, Codex	`npm i -g minia2a-mcp`
@minia2a/sdk	CLI for @x402/express developers	`npm i -g @minia2a/sdk`
@minia2a/elizaos-plugin-minia2a	ElizaOS agent plugin	`npm i @minia2a/elizaos-plugin-minia2a`
minia2a	General-purpose SDK	`npm i minia2a`