Skip to main content
UN

UnblockPay

v0.2.2API Key

On/off-ramp de fiat-a-stablecoin: convertí BRL, MXN o USD a USDC y de vuelta. Tu agente hace el puente entre las finanzas tradicionales y los rieles cripto.

13 herramientas2 env vars🌐 GLOBALestable en npm

Qué puede hacer tu agente

UnblockPay le da a tu agente 13 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier 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).
Ejemplo de llamada
// 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

Agregá esta entrada a tu claude_desktop_config.json (o a la config de cualquier cliente compatible con MCP).

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

Después de reiniciar, tu agente puede llamar cualquiera de las 13 herramientas de abajo — probá create_customer primero.

Variables de entorno · 2

Necesarias para autenticar el server. Almacenadas cifradas al usar el hosting gestionado de CodeSpar.

UNBLOCKPAY_API_KEY
obligatoriosecret

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.

Herramientas disponibles · 13

Cada herramienta es independiente — tu agente carga solo lo que necesita para reducir contexto y tiempo de respuesta.

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 compatibles

MCP es un protocolo — cualquier framework que lo hable puede montar este server.

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

Preguntas frecuentes

Corré `npx -y @codespar/mcp-unblockpay` y agregá el bloque de config de arriba a tu cliente MCP — Claude, Cursor, VS Code o cualquier cliente compatible con MCP. Sin build, sin SDK. ¿Preferís hosted? El tier gestionado de CodeSpar lo corre por vos, con la auth resuelta.
UnblockPay — MCP server · 13 tools | CodeSpar