Banco Do Brasil MCP Server - install & status [2026]

01 · Install Banco Do Brasil

before you install - you'll need

Set BB_CLIENT_ID, BB_CLIENT_SECRET, BB_DEVELOPER_APP_KEY, BB_CERT_PATH, BB_KEY_PATH before connecting. BB_ENV is optional or environment-specific per the README.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-banking- -- npx -y @codespar/mcp-banco-do-brasil

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-banking-": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-banco-do-brasil"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-banco-do-brasil - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Banco Do Brasil can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create an immediate Pix charge (cob) with QR code, retrieve an immediate Pix charge by its txid, list immediate Pix charges (cob) by date range, and retrieve a Pix devolução by its endToEndId + refund id.

Capability map

Tools grouped from the project's README - what Banco Do Brasil lets an agent do.

Pix

5 tools - e.g. Create an immediate Pix charge (cob) with QR code.; Retrieve an immediate Pix charge by its txid.; List immediate Pix charges (cob) by date range.

create_pix_cob · get_pix_cob · list_pix_cob · create_pix_devolucao · get_pix_devolucao

Register

2 tools - e.g. Register a DICT key on a BB account owned by the merchant.; Issue a boleto via BB Cobranças.

register_dict_key · register_boleto

Boleto

2 tools - e.g. Retrieve a boleto by nosso_numero.; Cancel (baixa) an outstanding boleto before payment.

get_boleto · cancel_boleto

read & search

2 tools - e.g. Retrieve the current balance of a BB conta-corrente (checking) account.; Retrieve account statement transactions for a BB conta-corrente over a date range.

get_account_balance · get_statement

Resolve

1 tool - e.g. Resolve a DICT key (CPF, CNPJ, email, phone, EVP) to the owner's account data before sending a Pix.

resolve_dict_key

delete

1 tool - e.g. Delete a DICT key owned by the merchant.

delete_dict_key

04 · Who maintains Banco Do Brasil

mcp-banco-do-brasil is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: finance - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-banco-do-brasil (active, first published 2026-06-20 · 2 versions)
packages: npm:@codespar/mcp-banco-do-brasil

06 · Banco Do Brasil FAQ

Is Banco Do Brasil still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Banco Do Brasil do?

With this server connected, an agent can create an immediate Pix charge (cob) with QR code, retrieve an immediate Pix charge by its txid, list immediate Pix charges (cob) by date range, and retrieve a Pix devolução by its endToEndId + refund id.

How do I install Banco Do Brasil?

Run `npx -y @codespar/mcp-banco-do-brasil`. The README documents 6 environment variables (BB_CLIENT_ID, BB_CLIENT_SECRET, BB_DEVELOPER_APP_KEY…) to set first. Set BB_CLIENT_ID, BB_CLIENT_SECRET, BB_DEVELOPER_APP_KEY, BB_CERT_PATH, BB_KEY_PATH before connecting. BB_ENV is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Banco Do Brasil run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Banco Do Brasil

Alternatives to Banco Do Brasil

Maintained finance servers if Banco Do Brasil isn't the fit.

Pairs well with

Servers that cover what Banco Do Brasil doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Dock · Iniciador · Matera · Open Finance · Pluggy

More JavaScript MCP servers · Bradesco · Btg · C6 · Caixa · see all