mcp-unblockpay

@codespar/mcp-unblockpay

MCP server for UnblockPay — fiat ↔ stablecoin cross-border via Customer → Wallet → Quote → Payin/Payout

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "unblockpay": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-unblockpay"],
      "env": {
        "UNBLOCKPAY_API_KEY": "your-key"
      }
    }
  }
}

Claude Code

claude mcp add unblockpay -- npx @codespar/mcp-unblockpay

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "unblockpay": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-unblockpay"],
      "env": {
        "UNBLOCKPAY_API_KEY": "your-key"
      }
    }
  }
}

Tools (13)

Tool	Purpose
create_customer	Create an individual or business customer (KYC mother). Business customers require date_of_incorporation.
list_customers	List customers under the operator's API key (limit mandatory by the v1 pagination contract).
verify_customer	Trigger the KYC verification check. Idempotent (returns 422 customer_cannot_be_verified when already approved).
get_verification_details	Poll KYC state — returns customer_status: pending | approved | rejected | partially_rejected.
create_wallet	Create a stablecoin wallet under an APPROVED customer.
list_wallets	List wallets under the operator's API key.
create_external_account	Register a fiat receiver account (BRL Pix, USD wire, EUR SEPA, MXN SPEI). Skippable for BRL Pix payouts via the pix_key + document shortcut on create_payout.
list_external_accounts	List external accounts under the operator's API key.
create_quote	Lock an FX + fee quote for 5 minutes. Pass amount on EITHER sender or receiver, not both.
create_payin	Fiat → stablecoin pay-in referencing a quote_id. Returns deposit instructions (<Pix Copy & Paste EMV> for BR).
create_payout	Stablecoin → fiat payout referencing a quote_id. customer_id is REQUIRED at the top level.
get_transaction	Poll transaction status. Lifecycle: awaiting_deposit → processing → completed (or failed / refunded / cancelled / error).
cancel_transaction	Cancel a transaction. Only valid while status is awaiting_deposit.

Authentication

UnblockPay uses an API key passed verbatim in the Authorization header (no Bearer prefix). The server sets that header for you — you just provide the key via UNBLOCKPAY_API_KEY.

Sandbox / Testing

UnblockPay provides a separate sandbox environment for testing. Point the server at it by setting UNBLOCKPAY_BASE_URL=https://api.sandbox.unblockpay.com/v1 and using a sandbox-issued API key.

Get your credentials

1. Sign in at app.unblockpay.com (or follow the docs)
2. Generate an API key in the dashboard
3. Set the UNBLOCKPAY_API_KEY environment variable
4. (Sandbox only) Also set UNBLOCKPAY_BASE_URL=https://api.sandbox.unblockpay.com/v1

Environment Variables

Variable	Required	Description
UNBLOCKPAY_API_KEY	Yes	API key from the UnblockPay dashboard
UNBLOCKPAY_BASE_URL	No	Defaults to https://api.unblockpay.com/v1. Set to https://api.sandbox.unblockpay.com/v1 for sandbox.

Roadmap

The 13 tools above mirror UnblockPay's current v1 API. New tools are added as UnblockPay expands the surface.

Want to contribute? Open a PR or request a tool.

Links

• UnblockPay Website
• UnblockPay API Documentation
• MCP Dev LatAm
• Landing Page

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT