# mpp32-mcp-server

This MCP server lets agents call paid APIs through x402 and other payment protocols. Use it when an agent needs to pay for external services.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 221
- Author: MPP32
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MPP32/MPP32/tree/HEAD/mcp-server
- Updated: 2026-08-04
- HTML: https://affpapa.org/en/nevibecode/mcp/mpp32-mcp-server

## What it does

mpp32-mcp-server gives an agent access to a catalog of paid and free APIs. It finds a service, selects a matching protocol, signs the payment with a key on your machine, and returns the result. The package includes signers for Solana, Base, and Tempo. Its listed rails include x402, Tempo, AP2 / AGTP, and ACP with different network and production states.

Set `MPP32_AGENT_KEY` to use 10 free Intelligence Oracle calls per day without a wallet. The anonymous `try_solana_token_intelligence_free` tool works without keys for a quick test. Paid services need a wallet key. `MPP32_SOLANA_PRIVATE_KEY` must be a base58-encoded 64-byte Solana secret key. The wallet needs both USDC and SOL: a USDC-only wallet fails with `insufficient funds for rent`.

In Claude Code, add the server with `claude mcp add`. The agent can then call tools such as `get_solana_token_intelligence` and `get_mpp32_diagnostics`. Treat the private key as a password because it can spend USDC and SOL held by the wallet.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MPP32_AGENT_KEY`, `MPP32_SOLANA_PRIVATE_KEY`, `MPP32_PRIVATE_KEY`, `MPP32_API_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MPP32_AGENT_KEY=<MPP32_AGENT_KEY> --env MPP32_SOLANA_PRIVATE_KEY=<MPP32_SOLANA_PRIVATE_KEY> --env MPP32_PRIVATE_KEY=<MPP32_PRIVATE_KEY> --env MPP32_API_URL=<MPP32_API_URL> --transport stdio mcp-server -- npx -y mpp32-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server --env MPP32_AGENT_KEY=<MPP32_AGENT_KEY> --env MPP32_SOLANA_PRIVATE_KEY=<MPP32_SOLANA_PRIVATE_KEY> --env MPP32_PRIVATE_KEY=<MPP32_PRIVATE_KEY> --env MPP32_API_URL=<MPP32_API_URL> -- npx -y mpp32-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "mpp32-mcp-server"
            ],
            "env": {
                "MPP32_AGENT_KEY": "<MPP32_AGENT_KEY>",
                "MPP32_SOLANA_PRIVATE_KEY": "<MPP32_SOLANA_PRIVATE_KEY>",
                "MPP32_PRIVATE_KEY": "<MPP32_PRIVATE_KEY>",
                "MPP32_API_URL": "<MPP32_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mpp32-mcp-server"
            ],
            "env": {
                "MPP32_AGENT_KEY": "<MPP32_AGENT_KEY>",
                "MPP32_SOLANA_PRIVATE_KEY": "<MPP32_SOLANA_PRIVATE_KEY>",
                "MPP32_PRIVATE_KEY": "<MPP32_PRIVATE_KEY>",
                "MPP32_API_URL": "<MPP32_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MPP32_AGENT_KEY=<MPP32_AGENT_KEY> -e MPP32_SOLANA_PRIVATE_KEY=<MPP32_SOLANA_PRIVATE_KEY> -e MPP32_PRIVATE_KEY=<MPP32_PRIVATE_KEY> -e MPP32_API_URL=<MPP32_API_URL> mcp-server npx -y mpp32-mcp-server
```
Replace <…> with your own values

## When to use it
- call paid APIs from an agent
- settle x402 payments from a local key
- browse a catalog of machine-payable APIs
- inspect MCP environment variables
- query Solana token intelligence

## Example prompts
- Check the MCP connection and payment readiness with `get_mpp32_diagnostics`.
- Query Solana token intelligence for this token with `get_solana_token_intelligence`.
- Find a suitable paid API in the catalog and call it through mpp32-mcp-server.

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221

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