BR top public bank (largest by assets). OAuth2 + mTLS + gw-dev-app-key. Pix, DICT, boleto cobranças, conta-corrente. Alpha on npm — devportal contract-gated, paths follow BACEN standard.
Banco do Brasil gives your agent 13 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.
create_pix_cob — Create an immediate Pix charge (cob) with QR code. Returns txid, EMV copy-paste payload, and location URL. BACEN Pix v2 standard.get_pix_cob — Retrieve an immediate Pix charge by its txid.list_pix_cob — List immediate Pix charges (cob) by date range. Paginated per BACEN Pix v2.// 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_pix_cob", { /* ... */ });$ npm install @codespar/mcp-banco-do-brasil@alphaAdd this entry to your claude_desktop_config.json (or any MCP-compatible client config).
{
"mcpServers": {
"banco-do-brasil": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-banco-do-brasil@alpha"
],
"env": {
"BB_CLIENT_ID": "<your_bb_client_id>",
"BB_CLIENT_SECRET": "<your_bb_client_secret>",
"BB_DEVELOPER_APP_KEY": "<your_bb_developer_app_key>"
}
}
}
}After restart, your agent can call any of the 13 tools below — try create_pix_cob first.
Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.
BB_CLIENT_IDBanco do Brasil OAuth client_id issued via developers.bb.com.br after contract onboarding.
BB_CLIENT_SECRETBanco do Brasil OAuth client_secret.
BB_DEVELOPER_APP_KEYBB Developer App Key (gw-dev-app-key) — appended as a query param on most BB API calls.
BB_CERT_PATHAbsolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2 in production.
BB_KEY_PATHAbsolute path to the mTLS private key (.key or .pem).
BB_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.
Each tool is independent — your agent loads only what it needs to reduce context and response time.
create_pix_cobget_pix_coblist_pix_cobcreate_pix_devolucaoget_pix_devolucaoresolve_dict_keyregister_dict_keydelete_dict_keyMCP is a protocol — any framework that speaks it can mount this server.