# minia2a-x402

Connect an agent to a pay-per-call API catalog settled in USDC on Base. It lists about 1,700 services and offers 5 trial calls per wallet.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: minia2auk
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/minia2auk/minia2a-x402
- Updated: 2026-09-25
- HTML: https://affpapa.org/en/nevibecode/mcp/minia2a-x402

## What it does

The server lets an agent search services by category or text, inspect a service’s price and input schema, then call it. It can also test x402 endpoints for auto-mode readiness, report live platform stats, and register a wallet for publishing. Trial calls do not require registration.

Payments use USDC on Base through x402. A signed wallet is needed for trial access; no API key is required. `minia2a-x402` is a lightweight alias that imports `minia2a-mcp` rather than shipping its own server code. Running it with `npx` therefore relies on the canonical package.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add minia2a-x402 -- npx -y minia2a-x402
```

### Codex

**Platform CLI**
```bash
codex mcp add minia2a-x402 -- npx -y minia2a-x402
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "minia2a-x402": {
            "command": "npx",
            "args": [
                "-y",
                "minia2a-x402"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "minia2a-x402": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "minia2a-x402"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add minia2a-x402 npx -y minia2a-x402
```

## When to use it
- search an API catalog by category or query
- check a service’s price and input schema
- call a paid API through the x402 payment flow
- test whether an x402 endpoint is ready for agent auto-mode
- retrieve current platform statistics

## Example prompts
- Find an API for address checks and show me its price and input schema.
- Call the selected service through x402 and pay with my wallet.
- Check whether this x402 endpoint is ready for agent auto-mode.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md