Pix BCB

v0.2.0OAuth2

Official Pix API from Banco Central do Brasil. Instant transfers, QR codes, DICT key lookup, and devolution flows.

18 tools1 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-pix-bcb

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "pix-bcb": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-pix-bcb"
      ],
      "env": {
        "PIX_CLIENT_SECRET": "<your_pix_client_secret>"
      }
    }
  }
}

After restart, your agent can call any of the 18 tools below — try create_cob first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

PIX_CLIENT_SECRET

requiredsecret

API key for pix-bcb

Available tools · 18

Each tool is independent — your agent loads only what it needs to reduce context and response time.

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)

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.