# SnapEX Pay

This MCP server for Claude Code connects an agent to SnapEX Pay crypto payments. It creates invoices, receives crypto and sends payouts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: snapexpay
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/snapexpay/snapex-pay-mcp
- Updated: 2026-11-04
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/snapex-pay

## What it does

The server lets an agent open a SnapEX Pay account and obtain an API key, then create invoices with hosted payment pages, accept crypto at permanent addresses and send payouts across coins and networks. The account balance is held in USDT. A payout starts with `preview_payout`, followed by `create_payout` using an idempotency key; retrying with the same key will not send a second payment.

Catalogue tools work without a key. Test mode runs the flow without real funds: a test invoice becomes paid about 10 seconds after a coin is selected, while the balance stays unchanged. Connect to `https://pay.snapex.pro/mcp` or run the local package with `npx -y snapex-pay-mcp`. Payouts cannot be reversed.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://pay.snapex.pro/mcp`
- Environment variables: `SNAPEX_API_KEY`, `SNAPEX_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http pay https://pay.snapex.pro/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env SNAPEX_API_KEY=<SNAPEX_API_KEY> --env SNAPEX_BASE_URL=<SNAPEX_BASE_URL> --transport stdio snapex-pay -- npx -y snapex-pay-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add snapex-pay --url https://pay.snapex.pro/mcp
```

2. **Platform CLI**
```bash
codex mcp add snapex-pay --env SNAPEX_API_KEY=<SNAPEX_API_KEY> --env SNAPEX_BASE_URL=<SNAPEX_BASE_URL> -- npx -y snapex-pay-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "snapex-pay": {
            "url": "https://pay.snapex.pro/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "snapex-pay": {
            "command": "npx",
            "args": [
                "-y",
                "snapex-pay-mcp"
            ],
            "env": {
                "SNAPEX_API_KEY": "<SNAPEX_API_KEY>",
                "SNAPEX_BASE_URL": "<SNAPEX_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "snapex-pay": {
            "type": "http",
            "url": "https://pay.snapex.pro/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "snapex-pay": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "snapex-pay-mcp"
            ],
            "env": {
                "SNAPEX_API_KEY": "<SNAPEX_API_KEY>",
                "SNAPEX_BASE_URL": "<SNAPEX_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http snapex-pay https://pay.snapex.pro/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SNAPEX_API_KEY=<SNAPEX_API_KEY> -e SNAPEX_BASE_URL=<SNAPEX_BASE_URL> snapex-pay npx -y snapex-pay-mcp
```
Replace <…> with your own values

## When to use it
- create an invoice to accept crypto
- check the payment status of an invoice
- send a payout in a selected coin and network
- inspect the account balance and transaction history

## Example prompts
- Create a SnapEX Pay invoice for a crypto payment and return its payment link.
- Check the status of my invoice and show the SnapEX Pay balance.
- Prepare a payout on the selected network and show its preview.

## Similar
- [vibe-pay](https://affpapa.org/en/nevibecode/mcp/vibe-pay.md) — MCP server · 8540 installs
- [onchain-pay-open-api](https://affpapa.org/en/nevibecode/skills/onchain-pay-open-api.md) — skill · 6100 installs
- [agents-pay](https://affpapa.org/en/nevibecode/skills/agents-pay.md) — skill · 953 installs
- [pay-via-agent-wallet](https://affpapa.org/en/nevibecode/skills/pay-via-agent-wallet.md) — skill · 859 installs
- [pay-with-any-token](https://affpapa.org/en/nevibecode/skills/pay-with-any-token.md) — skill · 847 installs
- [stripe-pay](https://affpapa.org/en/nevibecode/skills/stripe-pay.md) — skill · 766 installs

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