Skip to main content
UN

UnblockPay

v0.2.2API Key

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.

13 ferramentas2 env vars🌐 GLOBALestável no npm

O que seu agente faz

O UnblockPay dá ao seu agente 13 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.

  • create_customerCreate 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_customersList customers under the operator's API key. `limit` is mandatory per UnblockPay's pagination contract.
  • verify_customerTrigger 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).
Exemplo de chamada
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_customer", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-unblockpay

Quickstart

Adicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "unblockpay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-unblockpay"
      ],
      "env": {
        "UNBLOCKPAY_API_KEY": "<your_unblockpay_api_key>"
      }
    }
  }
}

Depois de reiniciar, seu agente pode chamar qualquer uma das 13 ferramentas abaixo — teste create_customer primeiro.

Variáveis de ambiente · 2

Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.

UNBLOCKPAY_API_KEY
obrigatóriosecret

API key from the UnblockPay dashboard

UNBLOCKPAY_BASE_URL
opcional

Optional API base URL. Defaults to https://api.unblockpay.com/v1. Set to https://api.sandbox.unblockpay.com/v1 to hit the sandbox.

Ferramentas disponíveis · 13

Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.

WRITEcreate_customer
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 } }.
READlist_customers
List customers under the operator's API key. `limit` is mandatory per UnblockPay's pagination contract.
READverify_customer
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).
READget_verification_details
Poll the KYC verification state for a customer. Returns { customer_status: 'pending' | 'approved' | 'rejected' | 'partially_rejected', verification_steps: [...] }.
WRITEcreate_wallet
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).
READlist_wallets
List wallets under the operator's API key.
WRITEcreate_external_account
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.
READlist_external_accounts
List external accounts under the operator's API key.

Frameworks compatíveis

MCP é um protocolo — qualquer framework que o fale pode montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Qualquer cliente MCPProtocolo

Perguntas frequentes

Rode `npx -y @codespar/mcp-unblockpay` e adicione o bloco de config acima ao seu cliente MCP — Claude, Cursor, VS Code ou qualquer cliente compatível com MCP. Sem build, sem SDK. Prefere hospedado? O tier gerenciado da CodeSpar roda pra você, com a auth resolvida.
UnblockPay — MCP server · 13 tools | CodeSpar