# Minia2a X402

> Minia2a X402 is a freemium MCP server for finance and payments. Local MCP server to browse and call pay-per-call x402 agent APIs, paid in USDC on Base. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://minia2a.uk
- **Repository:** https://github.com/minia2auk/minia2a-x402
- **MCP Registry name:** uk.minia2a/minia2a-x402
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-16

## About

Minia2a is a marketplace of paid endpoints that agents call and pay for per request over the x402 protocol, settled in USDC on Base. The site counts roughly 1,700 to 1,900 services across crypto, web, AI and data. Every signed wallet gets five free trial calls with no registration, account or API key. Publishers can list their own API and set a price; the platform fee is 5% and is 0% through 2026.

This npm package is an alias for the canonical `minia2a-mcp` server, created because the MCP registry ties a record name to the package's `mcpName`; it contains no server code of its own. The six stdio tools browse the catalog, show a service's price and schema, call a service while handling the HTTP 402 payment flow, register a wallet for publishing, validate an endpoint, and read platform statistics. Users set monthly spending caps and can revoke access.

## Features

- **Service catalog:** Browse paid APIs by category or search text.
- **Payment handling:** The call tool completes the HTTP 402 payment flow.
- **Free trials:** Five free calls per signed wallet before paying.
- **Endpoint validation:** Checks an x402 endpoint for agent auto-mode readiness.
- **Publisher registration:** Registers a self-custody wallet to publish an API.
- **Spending limits:** Monthly caps and revocation are described on the site.

## Good for

- Let an agent find and pay for a data API per call
- Try a paid endpoint with the free trial calls
- Publish an API and earn USDC per request
- Check whether an x402 endpoint is ready for agents

## Install

### Claude Code (Terminal)

```sh
claude mcp add minia2a-x402 -- npx -y minia2a-x402
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "minia2a-x402": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "minia2a-x402"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `minia2a_list_services`: Browses the catalog by category or search text.
- `minia2a_get_service`: Shows price, endpoint and input schema for one service.
- `minia2a_call_service`: Calls a service and handles the HTTP 402 payment flow.
- `minia2a_register`: Registers a self-custody wallet for publishing.
- `minia2a_check_endpoint`: Validates an x402 endpoint for agent readiness.
- `minia2a_get_stats`: Returns live platform statistics.

## FAQ

### How are calls paid for?

In USDC on Base through the x402 protocol, per call, with no subscription or API key.

### Are there free calls?

Yes, five free trial calls per signed wallet.

### What fee do publishers pay?

5%, which the site lists as 0% through 2026.

### Why does this package exist?

It is an alias of minia2a-mcp that satisfies the MCP registry's name check; install minia2a-mcp if you only want the server.

### Is Minia2a X402 free?

Minia2a X402 has a free plan, with paid plans for more usage or features.

### How do I add Minia2a X402 to Claude Code?

Run this command in your terminal: claude mcp add minia2a-x402 -- npx -y minia2a-x402

### What are the best alternatives to Minia2a X402?

The closest alternatives to Minia2a X402 are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/minia2a-x402
