Minia2a Mcp

uk.minia2aPublished by minia2a.ukv1.2.17Updated Nov 6, 2026

minia2a.uk — x402 pay-per-call APIs for AI agents, USDC on Base, 5 free trials per wallet.

The publisher's own server: Minia2a Mcp Remote

VerifiedSTDIODesktop onlyFinanceDeveloper ToolsAI & ML

Overview

AI-generated overview

MCP server for the minia2a.uk x402 marketplace that lets an assistant discover, inspect, trial and pay for pay-per-call APIs with USDC on Base.

What you can do
  • Browse and search the x402 service catalog, filtered by category or term
  • Inspect a single service's price, endpoint, parameters and usage notes
  • Read platform statistics such as service count, agents, volume and uptime
  • Call an x402 service, using free wallet trials or the returned 402 payment instructions
  • Register a self-custody wallet to publish services, or generate a new wallet
  • Validate any x402 endpoint for autonomous-agent readiness with a scored report
When to use it
Useful when an assistant should find and consume third-party paid APIs on demand instead of holding subscriptions or API keys, and when you want to check whether an x402 endpoint is ready for autonomous agent use.
Requirements
Runs locally via npx from the npm package minia2a-mcp; Node.js and network access to minia2a.uk are needed. No API keys or accounts are declared. A self-custody wallet private key is optional, passed as a tool argument or the MINIA2A_PRIVATE_KEY environment variable, for free trials and paid calls.
Before you install
Paid calls spend real USDC on Base from your wallet, so set spending limits before enabling autonomous use. The private key passed as an argument or in MINIA2A_PRIVATE_KEY controls funds; the README says it stays in the process, but treat it as a high-value secret. The register tool can generate a wallet and return its private key. Calls send requests and payment data to minia2a.uk and third-party endpoints.

Installation

In SourceWeft

  1. Open Minia2a Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
npm install -g minia2a-mcp

Usage

Claude Code

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

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

Claude Desktop

Add to claude_desktop_config.json:

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 autonomous-purchasing controls (per-call / per-task / confirmation / dedupe / settlement / audit)
  • 5 free trial calls per signed wallet (no registration) — spend them across the catalog. Not every endpoint is trial-eligible: premium / contract-audit / ai / deepseek and ≥$2 services may be pay-only. The endpoint's own 402 is the gate, not the category.
json
{  "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:

PackageUse CaseInstall
minia2a-mcp (this)MCP server for Claude, Cursor, Codexnpm i -g minia2a-mcp
@minia2a/sdkCLI for @x402/express developersnpm i -g @minia2a/sdk
@minia2a/elizaos-plugin-minia2aElizaOS agent pluginnpm i @minia2a/elizaos-plugin-minia2a
minia2aGeneral-purpose SDKnpm i minia2a

Links

License

MIT

Source: README.md at commit 69b9d6a

Tools

6

minia2a_list_services

List available x402 services on minia2a.uk — the micropayment marketplace for AI agents. Returns service name, description, price, and endpoint for each service. Use this to discover what capabilities are available before calling them.

Parameterslimitsearchcategory

minia2a_get_service

Get detailed information about a specific x402 service on minia2a.uk: price, endpoint URL, what parameters it takes (read from the service's own 402 example — one unpaid GET, nothing charged), and usage instructions. Use this before calling a service to understand what it needs.

ParametersserviceIdrequired

minia2a_get_stats

Get current platform statistics for minia2a.uk — total services, registered agents, transaction volume, uptime, and more. Useful for understanding the marketplace's scale and health.

Takes no parameters.

minia2a_register

Register a self-custody wallet on minia2a.uk 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 provide a wallet+signature, this tool generates a fresh wallet, signs 'minia2a register: <your-wallet>' with EIP-191, registers it, and returns the private key — store it, the platform never holds it.

Parametersnamerequiredwalletsignature

minia2a_call_service

Call an x402 service on minia2a.uk. Three access paths: (1) omit everything for the paid 402 path (sign a wallet for 5 free trial calls — no registration); (2) pass privateKey (or set MINIA2A_PRIVATE_KEY) for your wallet's own 5 trials — the key never leaves this process, it only signs the per-call trial message; (3) when both are exhausted the endpoint returns HTTP 402 with a machine-readable accepts[] array — pay in USDC and retry with a PAYMENT-SIGNATURE header (x402 V2). Set autoPay:true together with privateKey to have a 402 paid automatically in USDC on Base and the call retried — the wallet must hold USDC or the call still returns payment_required (never charges silently). Note that wallet= on its own does NOT reach the wallet bucket; the signature is what does. Service parameters go INSIDE `params`; a top-level key that is not one of the five declared names is rejected by name rather than dropped.

ParametersparamswalletautoPayserviceIdrequiredprivateKey

minia2a_check_endpoint

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 score (0-100%) with per-check PASS/FAIL detail. Use this before calling a paid endpoint to verify it works with autonomous agents.

ParametersendpointUrlrequired

Version history

11
  1. v1.2.17LatestNov 5, 2026
  2. v1.2.12Oct 23, 2026
  3. v1.2.10Oct 20, 2026
  4. v1.2.9Sep 26, 2026
  5. v1.2.7Sep 26, 2026
  6. v1.2.6Sep 25, 2026
  7. v1.2.5Sep 25, 2026
  8. v1.2.4Sep 24, 2026
  9. v1.2.2Sep 19, 2026
  10. v1.2.1Sep 18, 2026
  11. v1.1.25Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Minia2a integrations