{"_id":"@codespar/mcp-bradesco","_rev":"5-83bf55a7a498dcd15dfc7a005b0097a4","name":"@codespar/mcp-bradesco","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0-alpha.1":{"name":"@codespar/mcp-bradesco","version":"0.1.0-alpha.1","keywords":["mcp","bradesco","banking","pix","boleto","cobranca","arrecadacao","extrato","brazil"],"license":"MIT","_id":"@codespar/mcp-bradesco@0.1.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-bradesco":"dist/index.js"},"dist":{"shasum":"7f075882b32babca101b5182b241cb86f3237f54","tarball":"https://registry.npmjs.org/@codespar/mcp-bradesco/-/mcp-bradesco-0.1.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-XGT5QlhlRKhSxj3jI3qNS0AMjEW/J6nlLhJ9I147Hr6WBeBic9BryHg9NeiBeey0y8Iq6+6rzSjzdG9viInGhQ==","signatures":[{"sig":"MEUCIQCRgDJfs3JdY6uhqegT7qwD1z+plx6IykZnNX+TeXIQRwIgcCDM6cCPCLx3CyZ3LXSqL7Fwp6WfUei3oseJXySZMHc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55661},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8f8994b2acdc8be3a6c666b30ef44974f33752ed","mcpName":"io.github.codespar/mcp-bradesco","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Bradesco — Brazil's 2nd largest private bank. Pix, Cobrança (boleto), Arrecadação, and Extrato via Bradesco's Developer Portal APIs (OAuth2 + mTLS).","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bradesco_0.1.0-alpha.1_1776997179013_0.6273398445687215","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-bradesco","version":"0.2.0-alpha.1","keywords":["mcp","bradesco","banking","pix","boleto","cobranca","arrecadacao","extrato","brazil"],"license":"MIT","_id":"@codespar/mcp-bradesco@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-bradesco":"dist/index.js"},"dist":{"shasum":"d00ff6abc240278563e3bc714bc75b5012205d3c","tarball":"https://registry.npmjs.org/@codespar/mcp-bradesco/-/mcp-bradesco-0.2.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-kKNkSa5LBv0G5qBSY/dzQueduS8zlSiLovGFROrUjcWm5piQokUlnT0XN5bfE9NdFeAKwiQ3rWaZbDKOcO3dOQ==","signatures":[{"sig":"MEUCIQCNzSw+mktFtWngQRwhlEzOR/fV6ggqfwlDaLDKrwq0PwIgFFzh+Tw4TJrxpXEVCbxYodv3xkYRf8dDXq2tVoe37xg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92659},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ea10b1dfe82e3d4b5e84fffdfe18d44018529bfa","mcpName":"io.github.codespar/mcp-bradesco","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Bradesco — Brazil's 2nd largest private bank. Pix, Cobrança (boleto), Arrecadação, and Extrato via Bradesco's Developer Portal APIs (OAuth2 + mTLS).","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bradesco_0.2.0-alpha.1_1777064157348_0.15778102324441634","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-bradesco","version":"0.2.0-alpha.2","keywords":["mcp","bradesco","banking","pix","boleto","cobranca","arrecadacao","extrato","brazil"],"license":"MIT","_id":"@codespar/mcp-bradesco@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-bradesco":"dist/index.js"},"dist":{"shasum":"1077e08607e148c90373bbc3a282569911a639ff","tarball":"https://registry.npmjs.org/@codespar/mcp-bradesco/-/mcp-bradesco-0.2.0-alpha.2.tgz","fileCount":6,"integrity":"sha512-VaNrzhLBfAqH1EfZ682bKrHwS+LVkT5nL6Yp9KD3Je+sycPrJJKDKDhbYQLxHaopPys+mpSFe2++yDcni0z05g==","signatures":[{"sig":"MEQCIHZ3BCM5Tfc0VCelYLrdMZ1fgOzxmxPpqxkpWtTZAhENAiAgR1OQQEL7Ois83wRLvpOVx51LLVS7JO8gJAPPSrSZ1g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":94143},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b8f7e5b70db9046319ed757225e0eae8f2dc4451","mcpName":"io.github.codespar/mcp-bradesco","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Bradesco — Brazil's 2nd largest private bank. Pix, Cobrança (boleto), Arrecadação, and Extrato via Bradesco's Developer Portal APIs (OAuth2 + mTLS).","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bradesco_0.2.0-alpha.2_1777122903496_0.5695370251810179","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-bradesco","version":"0.2.0-alpha.3","description":"MCP server for Bradesco — Brazil's 2nd largest private bank. Pix, Cobrança (boleto), Arrecadação, and Extrato via Bradesco's Developer Portal APIs (OAuth2 + mTLS).","type":"module","main":"./dist/index.js","bin":{"mcp-bradesco":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","bradesco","banking","pix","boleto","cobranca","arrecadacao","extrato","brazil"],"mcpName":"io.github.codespar/mcp-bradesco","_id":"@codespar/mcp-bradesco@0.2.0-alpha.3","gitHead":"8e115a5cb8aed75e812af698b03aa996ccd8d7c1","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-P4K7E0P62gQuq+K49Lh0qE+iufnQ7pCFs7rqG389PSXPkgMVPGUGVMPr8VB5lCHJ3aQldMcKJT79AexUsQsH3A==","shasum":"19b79383ba5537961b58e18dc743f51b9f7e7cbe","tarball":"https://registry.npmjs.org/@codespar/mcp-bradesco/-/mcp-bradesco-0.2.0-alpha.3.tgz","fileCount":6,"unpackedSize":95572,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDzYYQIvundG9mjhHJsxn2SPpjnD7DBPbLVj4CW7fT54wIgbIL6ZqX5LsPFDE0lYB9vtg/dYTd+9oa7SXnNojgQ+Rk="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-bradesco_0.2.0-alpha.3_1782158036870_0.12063856572795961"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T02:19:38.912Z","modified":"2026-06-22T19:53:57.163Z","0.1.0-alpha.1":"2026-04-24T02:19:39.158Z","0.2.0-alpha.1":"2026-04-24T20:55:57.511Z","0.2.0-alpha.2":"2026-04-25T13:15:03.638Z","0.2.0-alpha.3":"2026-06-22T19:53:57.008Z"},"license":"MIT","keywords":["mcp","bradesco","banking","pix","boleto","cobranca","arrecadacao","extrato","brazil"],"description":"MCP server for Bradesco — Brazil's 2nd largest private bank. Pix, Cobrança (boleto), Arrecadação, and Extrato via Bradesco's Developer Portal APIs (OAuth2 + mTLS).","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-bradesco\n\nMCP server for [Bradesco](https://developers.bradesco.com.br) — Brazil's 2nd largest private bank (after Itaú).\n\nTogether with [`@codespar/mcp-itau`](../itau), [`@codespar/mcp-banco-inter`](../../payments/banco-inter), and [`@codespar/mcp-stark-bank`](../stark-bank), this covers the major BR private-bank API landscape. Merchants with meaningful Pix, boleto, and cash-management volume integrate directly with Bradesco instead of going through a PSP.\n\n## Status: alpha (`0.1.0-alpha.1`)\n\nBradesco's Developer Portal is **contract-gated** — the full OpenAPI specs for Pix, Cobrança, Arrecadação, and Extrato are only visible to onboarded merchants. The endpoint paths in this server are best-guesses based on (a) BACEN Pix v2 standard paths, (b) Bradesco's public integration guides, and (c) conventions shared across Itaú / Santander / BB. Every unverified path is flagged `TODO(verify)` in the source.\n\nPin to exact versions during `0.1.x`; paths will be corrected to match the portal spec once an onboarded merchant can validate.\n\n## Tools (22)\n\n| Tool | Purpose |\n|---|---|\n| `get_oauth_token` | Mint or return a cached OAuth2 client_credentials bearer token for the Bradesco Developer Portal. |\n| `send_pix` | Initiate an outbound Pix payment from the merchant's Bradesco account. |\n| `create_pix_qr` | Create a dynamic Pix charge with QR code (cob). |\n| `get_pix` | Retrieve a Pix transaction by its BCB endToEndId (E<ispb><yyyymmddhhmm><sequence>). |\n| `resolve_dict_key` | Resolve a DICT key (CPF, CNPJ, email, phone, EVP) to the owner's account data before sending a Pix. |\n| `refund_pix` | Refund (devolução) a previously received Pix. |\n| `create_boleto` | Issue a boleto via Bradesco Cobrança. |\n| `get_boleto` | Retrieve a boleto by its Bradesco identifier (id or nosso_numero). |\n| `cancel_boleto` | Cancel (baixa) an outstanding boleto before payment. |\n| `get_statement` | Retrieve account statement transactions for a given period. |\n| `arrecadacao_pay` | Pay a utility, tax, or concessionária bill via Bradesco Arrecadação. |\n| `list_pix_received` | List Pix transactions received by the merchant during a period. |\n| `create_pix_due_charge` | Create a Pix charge with a due date (cobv) — commonly used for installments and scheduled invoices. |\n| `get_pix_due_charge` | Retrieve a Pix due charge (cobv) by txid. |\n| `update_pix_due_charge` | Patch a Pix due charge (cobv) — revise amount, due date, discount, or debtor before payment. |\n| `register_dict_key` | Register a DICT key (CPF, CNPJ, email, phone, or EVP) pointing to a merchant account at Bradesco. |\n| `delete_dict_key` | Delete (unlink) a DICT key that points to a merchant account at Bradesco. |\n| `list_boletos` | List boletos issued by the merchant filtered by status and issue/due period. |\n| `get_boleto_pdf` | Download the boleto PDF as base64. |\n| `get_account_balance` | Retrieve the current available balance (saldo disponível) for a merchant account. |\n| `transfer_ted` | Execute a TED (or TEF when intra-Bradesco) transfer from the merchant's account to a beneficiary bank account. |\n| `pay_tax_darf` | Pay a federal tax (DARF) or union fee (GRU) via Bradesco Arrecadação. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-bradesco@0.1.0-alpha.1\n```\n\n## Environment\n\n```bash\nBRADESCO_CLIENT_ID=\"...\"       # OAuth client_id from Bradesco's Developer Portal\nBRADESCO_CLIENT_SECRET=\"...\"   # OAuth client_secret\nBRADESCO_CERT_PATH=\"/abs/path/to/client.crt\"   # mTLS client certificate\nBRADESCO_KEY_PATH=\"/abs/path/to/client.key\"    # mTLS private key\nBRADESCO_ENV=\"sandbox\"                          # or \"production\" (default: sandbox)\n```\n\n## Authentication\n\nTwo factors are **both** required on every call:\n\n1. **OAuth2 `client_credentials`** — the server calls the token endpoint, caches the bearer until ~60s before expiry, and attaches `Authorization: Bearer <token>` to downstream calls.\n2. **mTLS** — BACEN mandates mutual TLS for Pix v2, and Bradesco enforces it across product families. The server loads the client certificate and private key from the paths you set, builds a Node `https.Agent`, and routes every request through it.\n\nYou obtain the cert + key bundle from the Bradesco Developer Portal after your merchant contract is signed. They are distinct from the OAuth credentials.\n\n## Base URLs\n\n- **Production**: `https://proxy.api.prebanco.com.br` (Bradesco's standard external proxy)\n- **Sandbox**: `https://apihom-bradescorip.bradesco.com.br` (homologação)\n\nBoth hosts are marked `TODO(verify)` — Bradesco provisions per-merchant subdomains in some product families and the exact homologação host may differ. Fork and override `BASE_URL` if your portal provisioning differs.\n\n## Run\n\n```bash\n# stdio (default)\nnpx @codespar/mcp-bradesco\n\n# HTTP transport\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-bradesco\n```\n\n## Caveats\n\n- **Paths are unverified.** See the `TODO(verify)` markers in `src/index.ts`. Onboarded merchants should validate against their portal-issued OpenAPI spec and open a PR.\n- **Base URLs are best-guess.** See above — override if your provisioning differs.\n- **Arrecadação barcode validation** is server-side in this alpha — no client-side mod-10 / mod-11 check yet.\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"}