# mcp-unblockpay

MCP server connecting AI assistants to UnblockPay. It handles cross-border rails, customer onboarding, stablecoin wallets, and currency conversions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/crypto/unblockpay
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-unblockpay

## What it does

This integration exposes 13 tools mirroring the UnblockPay v1 endpoints. Assistants can register customer profiles, trigger identity checks, and lock conversion rates. Quotes expire after five minutes. The API accepts an amount on either the sending or receiving side, never both. Without an approved KYC state, wallet creation fails outright.

For settlements, the server processes deposits into stablecoins and payouts back to fiat rails like Pix, SEPA, SPEI, or USD wire. Pay-in calls generate deposit instructions, including EMV strings for Brazilian Pix. Cancellation is restricted. You can abort a transaction only while it rests in the `awaiting_deposit` phase.

Authentication requires `UNBLOCKPAY_API_KEY` passed straight into request headers. To run test cycles, point `UNBLOCKPAY_BASE_URL` to `https://api.sandbox.unblockpay.com/v1` with a sandbox key.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `UNBLOCKPAY_API_KEY`, `UNBLOCKPAY_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)

**Platform CLI**
```bash
claude mcp add --env UNBLOCKPAY_API_KEY=<UNBLOCKPAY_API_KEY> --env UNBLOCKPAY_BASE_URL=<UNBLOCKPAY_BASE_URL> --transport stdio unblockpay -- npx -y @codespar/mcp-unblockpay
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add unblockpay --env UNBLOCKPAY_API_KEY=<UNBLOCKPAY_API_KEY> --env UNBLOCKPAY_BASE_URL=<UNBLOCKPAY_BASE_URL> -- npx -y @codespar/mcp-unblockpay
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unblockpay": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-unblockpay"
            ],
            "env": {
                "UNBLOCKPAY_API_KEY": "<UNBLOCKPAY_API_KEY>",
                "UNBLOCKPAY_BASE_URL": "<UNBLOCKPAY_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "unblockpay": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-unblockpay"
            ],
            "env": {
                "UNBLOCKPAY_API_KEY": "<UNBLOCKPAY_API_KEY>",
                "UNBLOCKPAY_BASE_URL": "<UNBLOCKPAY_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e UNBLOCKPAY_API_KEY=<UNBLOCKPAY_API_KEY> -e UNBLOCKPAY_BASE_URL=<UNBLOCKPAY_BASE_URL> unblockpay npx -y @codespar/mcp-unblockpay
```
Replace <…> with your own values

## When to use it
- register customer records and trigger identity verification checks
- lock exchange rates and processing fees prior to conversion
- generate deposit instructions for fiat-to-stablecoin onramps
- route payouts to external bank accounts through SEPA, SPEI, wire, or Pix
- inspect settlement statuses and cancel unpaid transfers

## Example prompts
- Register a new corporate customer in UnblockPay with their incorporation date.
- Lock a quote to transfer 500 USD into stablecoins and show the quote ID.
- Check the current status of the specified transaction ID.

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

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

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