# BlindPay

Wires your assistant into BlindPay's payment infrastructure: receivers, payouts, payins, quotes and FX rates without leaving the conversation.

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

## What it does

BlindPay ships an official MCP server for its stablecoin payment API. Once connected, the assistant can register receivers — people or companies — send payouts and take payins across several blockchains, pull quotes and exchange rates, open virtual accounts and wallets, and manage webhooks and API keys. Which of those operations are available depends on the profile you pick.

There are two ways in. The remote server at `https://mcp.blindpay.com/mcp` speaks Streamable HTTP and signs you in with OAuth 2.1 against your BlindPay account, so no API key is involved and the token carries only the rights of your role on the chosen instance. The local route runs `npx -y @blindpay/mcp`, needs Node.js and npm installed, and reads `BLINDPAY_API_KEY` plus `BLINDPAY_INSTANCE_ID` from the environment. Both expose the same tools and the webhook event resource `blindpay://webhooks/events`.

\`BLINDPAY_MCP_PROFILE` controls the tool surface. With `full` every public API operation is on the table, payouts and transfers included. Switch to `readonly` and only `GET` calls remain — status, balances, history — which means the wallet sign-message tool, the webhook secret tool and the webhook portal-access tool are gone, and `trace_id` is stripped from JSON responses. Worth knowing if you would rather the agent never touch money movement. Tools carry MCP annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`) derived from their HTTP verb, so the client can decide when to ask you to confirm.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.blindpay.com/mcp`
- Environment variables: `BLINDPAY_API_KEY`, `BLINDPAY_INSTANCE_ID`, `BLINDPAY_MCP_PROFILE` — 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 mcp https://mcp.blindpay.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env BLINDPAY_API_KEY=<BLINDPAY_API_KEY> --env BLINDPAY_INSTANCE_ID=<BLINDPAY_INSTANCE_ID> --env BLINDPAY_MCP_PROFILE=<BLINDPAY_MCP_PROFILE> --transport stdio blindpay -- npx -y @blindpay/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add blindpay --url https://mcp.blindpay.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add blindpay --env BLINDPAY_API_KEY=<BLINDPAY_API_KEY> --env BLINDPAY_INSTANCE_ID=<BLINDPAY_INSTANCE_ID> --env BLINDPAY_MCP_PROFILE=<BLINDPAY_MCP_PROFILE> -- npx -y @blindpay/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "blindpay": {
            "url": "https://mcp.blindpay.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "blindpay": {
            "command": "npx",
            "args": [
                "-y",
                "@blindpay/mcp"
            ],
            "env": {
                "BLINDPAY_API_KEY": "<BLINDPAY_API_KEY>",
                "BLINDPAY_INSTANCE_ID": "<BLINDPAY_INSTANCE_ID>",
                "BLINDPAY_MCP_PROFILE": "<BLINDPAY_MCP_PROFILE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "blindpay": {
            "type": "http",
            "url": "https://mcp.blindpay.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "blindpay": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@blindpay/mcp"
            ],
            "env": {
                "BLINDPAY_API_KEY": "<BLINDPAY_API_KEY>",
                "BLINDPAY_INSTANCE_ID": "<BLINDPAY_INSTANCE_ID>",
                "BLINDPAY_MCP_PROFILE": "<BLINDPAY_MCP_PROFILE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http blindpay https://mcp.blindpay.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e BLINDPAY_API_KEY=<BLINDPAY_API_KEY> -e BLINDPAY_INSTANCE_ID=<BLINDPAY_INSTANCE_ID> -e BLINDPAY_MCP_PROFILE=<BLINDPAY_MCP_PROFILE> blindpay npx -y @blindpay/mcp
```
Replace <…> with your own values

## When to use it
- register a business receiver with its payout details
- send a stablecoin payout across several blockchains
- check a quote and FX rate before moving funds
- open a virtual account to collect payins
- subscribe to payment events through webhooks

## Example prompts
- List the receivers and their current status
- Create a business receiver and attach payout details
- Get a quote for a transfer and show me the exchange rate

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

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