UnblockPay

On/off-ramp de fiat-pra-stablecoin: converta BRL, MXN ou USD pra USDC e de volta. Seu agente faz a ponte entre as finanças tradicionais e as trilhas cripto.

MIT · roda localmente ou pelo runtime da CodeSpar

Variáveis de ambiente, nomes e descrições das ferramentas vêm do pacote npm e ficam em inglês.

Início rápido

Instale, configure as credenciais, faça a primeira chamada.

Escolha seu cliente. O servidor roda localmente via stdio, ou pelo runtime hospedado.

Ferramentas

O que o seu agente pode chamar.

Create an individual or business customer (KYC mother). Business customers require date_of_incorporation; both types use 3-letter ISO country codes (BRA/USA/MEX). Returns { id, status: 'pending', verification: { verification_link } }.

List customers under the operator's API key. `limit` is mandatory per UnblockPay's pagination contract.

Trigger the KYC verification check for a customer. Sandbox auto-progresses business customers through the hosted KYC flow once documents are uploaded. Idempotent — returns 422 'customer_cannot_be_verified' when already approved (safe to ignore).

Poll the KYC verification state for a customer. Returns { customer_status: 'pending' | 'approved' | 'rejected' | 'partially_rejected', verification_steps: [...] }.

Create a stablecoin wallet under an APPROVED customer. blockchain selects the network (solana → USDC; ethereum/polygon → USDC/USDT; tron → USDT). Customer must be 'approved' before this succeeds (422 customer_not_allowed otherwise).

List wallets under the operator's API key.

Register a fiat receiver account (BRL Pix, USD wire, EUR SEPA, MXN SPEI). Skippable for BRL Pix payouts — pass pix_key + document directly on /payout instead.

List external accounts under the operator's API key.

Lock an FX + fee quote for a 5-minute TTL. Same endpoint for both on_ramp (fiat → stablecoin) and off_ramp (stablecoin → fiat). Pass amount on EITHER sender or receiver, not both. Response carries { id, expires_at, commercial_quotation, fees }.

Create a fiat → stablecoin pay-in referencing a quote_id. Sandbox min: 150 BRL / payout-side equivalents. Response carries { id, status: 'awaiting_deposit', sender_deposit_instructions: { deposit_address: '<Pix Copy & Paste EMV>' }, transaction_link }.

Create a stablecoin → fiat payout referencing a quote_id. customer_id is REQUIRED at the top level (404 'Customer not found' otherwise). Pix-BR shortcut: pass receiver.pix_key + receiver.document directly to skip external_account registration. Sandbox min: 25 USDC. Response carries { id, status: 'awaiting_deposit', transaction_link, sender_deposit_instructions: { deposit_address: '<blockchain address>' } }.

Poll transaction status. Lifecycle: awaiting_deposit → processing → completed (or failed / refunded / cancelled / error). Sandbox does NOT auto-progress without a webhook simulation — see UnblockPay's /concepts/transactions docs for the mocked transaction IDs available for status testing.

Compatibilidade

MCP é um protocolo. Qualquer cliente que o fale pode montar este servidor.

Pelo runtime da CodeSpar, o codespar_discover encontra as ferramentas deste servidor, e um tools/call roda com a credencial conectada no seu projeto, inclusive com chave de teste.

Comece em segundos.

No runtime da CodeSpar, a credencial que você conecta fica criptografada para a sua organização e o runtime a coloca em cada chamada. Você só chama a ferramenta.