{"_id":"@codespar/mcp-banco-do-brasil","_rev":"6-36f914d5d5ff79ffb6bcdda48f2f8458","name":"@codespar/mcp-banco-do-brasil","dist-tags":{"alpha":"0.1.0-alpha.2","latest":"0.1.0-alpha.5"},"versions":{"0.1.0-alpha.1":{"name":"@codespar/mcp-banco-do-brasil","version":"0.1.0-alpha.1","keywords":["mcp","banco-do-brasil","bb","banking","pix","boleto","cobranca","open-finance","brazil"],"license":"MIT","_id":"@codespar/mcp-banco-do-brasil@0.1.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-banco-do-brasil":"dist/index.js"},"dist":{"shasum":"9a661cd407d3e4736ae3de358503527d03dea76a","tarball":"https://registry.npmjs.org/@codespar/mcp-banco-do-brasil/-/mcp-banco-do-brasil-0.1.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-c/zK/iOoP1wqLMpGQHpO7l4RKlBFgWvwlL+4PE/o7kOFtEn8FW544qeD7t/wC3cQIIs2irM/lifQdpApNESlcQ==","signatures":[{"sig":"MEUCIBHru8FZHl7yhg+6C9EINiKyTM5Q1wtV6fpcMy7E1yuVAiEAkHUXdeG9TCGH+EzZbO3nHWfDPFMyU2wurfpe4jtxhUA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56988},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"abceab06a74a933da6920cfb3b1735adcf271566","mcpName":"io.github.codespar/banco-do-brasil","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Banco do Brasil — Brazil's top public bank. Pix, Cobrança (boleto), Conta-Corrente, and Arrecadação via BB's Developer Portal APIs (OAuth2 + mTLS).","directories":{},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-banco-do-brasil_0.1.0-alpha.1_1777119833618_0.7705170371712093","host":"s3://npm-registry-packages-npm-production"}},"0.1.0-alpha.2":{"name":"@codespar/mcp-banco-do-brasil","version":"0.1.0-alpha.2","keywords":["mcp","banco-do-brasil","bb","banking","pix","boleto","cobranca","open-finance","brazil"],"license":"MIT","_id":"@codespar/mcp-banco-do-brasil@0.1.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-banco-do-brasil":"dist/index.js"},"dist":{"shasum":"260c47106273138e57a036b32b5c941bb717e0e6","tarball":"https://registry.npmjs.org/@codespar/mcp-banco-do-brasil/-/mcp-banco-do-brasil-0.1.0-alpha.2.tgz","fileCount":6,"integrity":"sha512-SoBm3+cXtwRdjJhgPRDLEkMC6/ha562gLxNKHW7E1SxURQB2osM0dPjh2leBI8khEwN6QVsTkwHIANt4BrGUBg==","signatures":[{"sig":"MEYCIQCyMG5hOBDJfME0ePGDv8liR+VB0i9Wb2HmFoFUBscbtgIhAJOy26VjuYJ03neJL3ROXEgZTfjul/g0niLOQ1EbVgNt","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57286},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b8f7e5b70db9046319ed757225e0eae8f2dc4451","mcpName":"io.github.codespar/banco-do-brasil","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Banco do Brasil — Brazil's top public bank. Pix, Cobrança (boleto), Conta-Corrente, and Arrecadação via BB's Developer Portal APIs (OAuth2 + mTLS).","directories":{},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-banco-do-brasil_0.1.0-alpha.2_1777122899594_0.4936854958658452","host":"s3://npm-registry-packages-npm-production"}},"0.1.0-alpha.3":{"name":"@codespar/mcp-banco-do-brasil","version":"0.1.0-alpha.3","keywords":["mcp","banco-do-brasil","bb","banking","pix","boleto","cobranca","open-finance","brazil"],"license":"MIT","_id":"@codespar/mcp-banco-do-brasil@0.1.0-alpha.3","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"bin":{"mcp-banco-do-brasil":"dist/index.js"},"dist":{"shasum":"4a9847403f81a3be609742ea63f7312492aee31e","tarball":"https://registry.npmjs.org/@codespar/mcp-banco-do-brasil/-/mcp-banco-do-brasil-0.1.0-alpha.3.tgz","fileCount":6,"integrity":"sha512-Gn78sT1p+VllppgNKL7jdBsccR0MW++TYnJpmiJMNWCjYcbr4C5w403EL90I6Mcvvrpl7oB6B9fDL0ve97BFVg==","signatures":[{"sig":"MEQCICH0hT5KZvW8/NTDQwLtcc6KEP6xtkEqb6waFWsSZG51AiB40TkNW8kQ+jnrooSV9qr8Qb1FIIGTrhLHr7hK4H2yAQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57739},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"a121ea567035fa095d42b603f244273e3a34cc90","mcpName":"io.github.codespar/mcp-banco-do-brasil","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"10.9.8","description":"MCP server for Banco do Brasil — Brazil's top public bank. Pix, Cobrança (boleto), Conta-Corrente, and Arrecadação via BB's Developer Portal APIs (OAuth2 + mTLS).","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-banco-do-brasil_0.1.0-alpha.3_1781995318996_0.05175999935813169","host":"s3://npm-registry-packages-npm-production"}},"0.1.0-alpha.4":{"name":"@codespar/mcp-banco-do-brasil","version":"0.1.0-alpha.4","keywords":["mcp","banco-do-brasil","bb","banking","pix","boleto","cobranca","open-finance","brazil"],"license":"MIT","_id":"@codespar/mcp-banco-do-brasil@0.1.0-alpha.4","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"bin":{"mcp-banco-do-brasil":"dist/index.js"},"dist":{"shasum":"f7d08f00f6ce5bd0eeeb396ca4eab00af9dd4777","tarball":"https://registry.npmjs.org/@codespar/mcp-banco-do-brasil/-/mcp-banco-do-brasil-0.1.0-alpha.4.tgz","fileCount":6,"integrity":"sha512-SNRn3QW1fZ9Fi9jonN7U1RrTUpYDAgCSjtnu8Yks54xjrL65s4Eqyvv2rIFICz4pKC+Chru5YwGDXQOm8VflqA==","signatures":[{"sig":"MEUCIDvAGAd2q8OXt8RK+vVkdRl8V7urSRwVvszUqkeUrMnUAiEAlZvbX6VSb8tB/HpNq+DGxxAmJXYIIJDteIDXLhAGVgM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58714},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","mcpName":"io.github.codespar/mcp-banco-do-brasil","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"_npmVersion":"10.9.8","description":"MCP server for Banco do Brasil — Brazil's top public bank. Pix, Cobrança (boleto), Conta-Corrente, and Arrecadação via BB's Developer Portal APIs (OAuth2 + mTLS).","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-banco-do-brasil_0.1.0-alpha.4_1782153365418_0.9083303533757976","host":"s3://npm-registry-packages-npm-production"}},"0.1.0-alpha.5":{"_id":"@codespar/mcp-banco-do-brasil@0.1.0-alpha.5","bin":{"mcp-banco-do-brasil":"dist/index.js"},"dist":{"shasum":"7ac1c58f7498069dac10cf2728c644d8a210f300","tarball":"https://registry.npmjs.org/@codespar/mcp-banco-do-brasil/-/mcp-banco-do-brasil-0.1.0-alpha.5.tgz","fileCount":6,"integrity":"sha512-mj+R5jeFDlXwQ4yQpQOto4SeqlBz2CL+v8pqrApnYgI8QBOgJ3MEjOvWgFhMmheK6dZlEJbsQ9u3V1CVjCMM2g==","signatures":[{"sig":"MEYCIQC8ad6lkeJhLMVP4IT0nHDHSfr9FEiYGoVDlvi8AfaMmgIhAOM5rLzGVBfPtTWjPlLbBQCJ0ibKzvD3UQZVi1GcCOgG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFGXFKm/E3eU+zLv939B+isyQhvM4g4nE4efWo3EOSiLAiBxVrlgoGnfSoHkXPicdWGzPMKX59n+OIZOkHssBIWeUQ=="}],"unpackedSize":60054},"main":"./dist/index.js","name":"@codespar/mcp-banco-do-brasil","type":"module","types":"./dist/index.d.ts","gitHead":"d0a519ad3ce12b701c361bed27a62a866d744094","license":"MIT","mcpName":"io.github.codespar/mcp-banco-do-brasil","scripts":{"build":"tsc","start":"node dist/index.js"},"version":"0.1.0-alpha.5","_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"keywords":["mcp","banco-do-brasil","bb","banking","pix","boleto","cobranca","open-finance","brazil"],"_npmVersion":"10.9.8","description":"MCP server for Banco do Brasil — Brazil's top public bank. Pix, Cobrança (boleto), Conta-Corrente, and Arrecadação via BB's Developer Portal APIs (OAuth2 + mTLS).","directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_nodeVersion":"22.23.2","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-banco-do-brasil_0.1.0-alpha.5_1790519846839_0.09978852010037009"}}},"time":{"created":"2026-04-25T12:23:53.541Z","modified":"2026-09-27T14:37:27.189Z","0.1.0-alpha.1":"2026-04-25T12:23:53.740Z","0.1.0-alpha.2":"2026-04-25T13:14:59.748Z","0.1.0-alpha.3":"2026-06-20T22:41:59.142Z","0.1.0-alpha.4":"2026-06-22T18:36:05.574Z","0.1.0-alpha.5":"2026-09-27T14:37:26.939Z"},"license":"MIT","keywords":["mcp","banco-do-brasil","bb","banking","pix","boleto","cobranca","open-finance","brazil"],"description":"MCP server for Banco do Brasil — Brazil's top public bank. Pix, Cobrança (boleto), Conta-Corrente, and Arrecadação via BB's Developer Portal APIs (OAuth2 + mTLS).","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-banco-do-brasil\n\nMCP server for [Banco do Brasil](https://developers.bb.com.br) — Brazil's top public bank.\n\nBB exposes one of the broadest public-bank API surfaces in the country across Pix, Cobranças, Conta-Corrente, Open Finance, and Arrecadação. Merchants doing high-volume Pix and boleto operations integrate directly with BB instead of going through a PSP.\n\n## Status: alpha (`0.1.0-alpha.1`)\n\nBB's Developer Portal is **contract-gated** — the full OpenAPI specs are visible only after merchant onboarding. Pix paths follow the BACEN Pix v2 standard; boleto, account, and statement paths are best-guesses based on BB's public marketing pages and conventions shared with peers (Itaú, Santander, Bradesco). Every unverified path is flagged `TODO(verify)` in `src/index.ts`. Pin to exact versions during `0.1.x`.\n\n## Tools (13)\n\n| Tool | Purpose |\n|---|---|\n| `create_pix_cob` | Create an immediate Pix charge (cob) with QR code. |\n| `get_pix_cob` | Retrieve an immediate Pix charge by its txid. |\n| `list_pix_cob` | List immediate Pix charges (cob) by date range. |\n| `create_pix_devolucao` | Refund (devolução) a previously received Pix. |\n| `get_pix_devolucao` | Retrieve a Pix devolução by its endToEndId + refund id. |\n| `resolve_dict_key` | Resolve a DICT key (CPF, CNPJ, email, phone, EVP) to the owner's account data before sending a Pix. |\n| `register_dict_key` | Register a DICT key on a BB account owned by the merchant. |\n| `delete_dict_key` | Delete a DICT key owned by the merchant. |\n| `register_boleto` | Issue a boleto via BB Cobranças. |\n| `get_boleto` | Retrieve a boleto by nosso_numero. |\n| `cancel_boleto` | Cancel (baixa) an outstanding boleto before payment. |\n| `get_account_balance` | Retrieve the current balance of a BB conta-corrente (checking) account. |\n| `get_statement` | Retrieve account statement transactions for a BB conta-corrente over a date range. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-banco-do-brasil@0.1.0-alpha.1\n```\n\n## Environment\n\n```bash\nBB_CLIENT_ID=\"...\"             # OAuth client_id from developers.bb.com.br\nBB_CLIENT_SECRET=\"...\"         # OAuth client_secret\nBB_DEVELOPER_APP_KEY=\"...\"     # gw-dev-app-key — required on most calls\nBB_CERT_PATH=\"/abs/path/client.crt\"   # mTLS cert (production only)\nBB_KEY_PATH=\"/abs/path/client.key\"    # mTLS key  (production only)\nBB_ENV=\"sandbox\"                       # or \"production\" (default: sandbox)\nBB_BASE_URL=\"...\"                      # optional; default api.hm.bb.com.br (sandbox) / api.bb.com.br\nBB_AUTH_URL=\"...\"                      # optional; default https://oauth.hm.bb.com.br/oauth/token (sandbox) / oauth.bb.com.br\n```\n\n## Authentication\n\n- **OAuth2 `client_credentials`** — token endpoint at `oauth.{env}.bb.com.br`. Bearer cached until ~60s before expiry.\n- **mTLS** — required by BACEN for Pix v2 in production. Sandbox typically allows TLS-only; cert/key are optional in sandbox and required in production.\n- **`gw-dev-app-key`** — BB API gateway key, appended as a query param on all calls.\n\n## Run\n\n```bash\nnpx @codespar/mcp-banco-do-brasil\n```\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}