Mcp Unblockpay

io.github.codesparPublished by GitHub account codesparv0.3.1Updated Oct 24, 2026

MCP server for UnblockPay — fiat-to-stablecoin onramp/offramp, wallets, transfers

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.codespar/mcp-unblockpay
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account codespar for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.codespar%2Fmcp-unblockpay.svg)](https://sourceweft.com/mcp/io.github.codespar%2Fmcp-unblockpay?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server for UnblockPay that lets an assistant manage customers, KYC, stablecoin wallets, FX quotes and fiat-to-stablecoin pay-ins and payouts.

What you can do: Create and list customers, and trigger or poll KYC verification status for individuals and businesses. Create and list stablecoin wallets under approved customers. Register and list external fiat accounts for Pix, wire, SEPA and SPEI payouts. Lock FX and fee quotes, then create pay-ins or payouts against a quote. Poll transaction status and cancel transactions still awaiting deposit.
When to use it: Useful when you want an assistant to drive UnblockPay cross-border fiat and stablecoin flows from chat: onboarding customers, checking KYC, opening wallets, quoting FX and initiating or tracking pay-ins and payouts. Test against the sandbox before touching live money.
Requirements: Runs locally via npx with Node.js. Requires an UnblockPay account and an API key supplied in the UNBLOCKPAY_API_KEY environment variable. Optionally set UNBLOCKPAY_BASE_URL to the sandbox endpoint for testing. Network access to the UnblockPay API.

Before you install

The API key grants access to real payment operations; keep it out of shared configs. Tools create customers, wallets, external accounts, quotes, pay-ins and payouts, and can cancel transactions, so they move real money and change account data. Quotes expire after five minutes. Defaults to the production API unless the sandbox base URL is set.

Installation

In SourceWeft

Open Mcp Unblockpay in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-unblockpay

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

[npm] [License: MIT]

Quick Start

Claude Desktop

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

json

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

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

Claude Code

Cursor / VS Code

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

json

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

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

Sign in at app.unblockpay.com (or follow the docs)
Generate an API key in the dashboard
Set the UNBLOCKPAY_API_KEY environment variable
(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.

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

Source: packages/crypto/unblockpay/README.md at commit d0a519a

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.3.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts