Maior banco público do BR (o maior por ativos). OAuth2 + mTLS + gw-dev-app-key. Pix, DICT, cobranças de boleto, conta-corrente. Alpha no npm — devportal fechado por contrato, paths seguem o padrão BACEN.
O Banco do Brasil dá ao seu agente 13 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.
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@alphaAdicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).
{
"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>"
}
}
}
}Depois de reiniciar, seu agente pode chamar qualquer uma das 13 ferramentas abaixo — teste create_pix_cob primeiro.
Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.
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'.
Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.
create_pix_cobget_pix_coblist_pix_cobcreate_pix_devolucaoget_pix_devolucaoresolve_dict_keyregister_dict_keydelete_dict_keyMCP é um protocolo — qualquer framework que o fale pode montar este server.