Skip to main content
PI

Pix BCB

v0.2.1OAuth2

API oficial de Pix del Banco Central de Brasil. Transferencias instantáneas, QR codes, consulta de clave DICT y flujos de devolución.

18 herramientas1 env vars🇧🇷 Brasilestable en npm

Qué puede hacer tu agente

Pix BCB le da a tu agente 18 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier cliente MCP.

  • create_cobCreate an immediate Pix charge (cobranca imediata)
  • get_cobGet immediate charge details by txid
  • list_cobsList immediate charges with date range and filters
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_cob", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-pix-bcb

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": {
    "pix-bcb": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-pix-bcb"
      ],
      "env": {
        "PIX_CLIENT_SECRET": "<your_pix_client_secret>"
      }
    }
  }
}

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

Variables de entorno · 1

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

PIX_CLIENT_SECRET
obligatoriosecret

API key for pix-bcb

Herramientas disponibles · 18

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

WRITEcreate_cob
Create an immediate Pix charge (cobranca imediata)
READget_cob
Get immediate charge details by txid
READlist_cobs
List immediate charges with date range and filters
WRITEupdate_cob
Revise an existing immediate charge (PATCH /cob/{txid}). Common updates: status REMOVIDA_PELO_USUARIO_RECEBEDOR to cancel, or change valor/solicitacaoPagador.
WRITEcreate_cobv
Create a due-date Pix charge (cobranca com vencimento)
READlist_cobv
List due-date charges (cobv) within a date range
WRITEupdate_cobv
Revise an existing due-date charge (PATCH /cobv/{txid})
READget_pix
Get a received Pix payment by e2eid (endToEndId)

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-pix-bcb` 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.
Pix BCB — MCP server · 18 tools | CodeSpar