@codespar/mcp-banco-do-brasil 0.1.0-alpha.1 → 0.1.0-alpha.3

package/README.md

@@ -8,23 +8,23 @@ BB exposes one of the broadest public-bank API surfaces in the country across Pi
 
 BB'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`.
 
-## Tools (10)
+## Tools (13)
 
 | Tool | Purpose |
 |---|---|
-| `create_pix_cob` | Create immediate Pix charge (cob) |
-| `get_pix_cob` | Get an immediate Pix charge by txid |
-| `list_pix_cob` | List immediate Pix charges by date range |
-| `create_pix_devolucao` | Refund a received Pix (devolução) |
-| `get_pix_devolucao` | Retrieve a devolução by id |
-| `resolve_dict_key` | Resolve a DICT key to account data |
-| `register_dict_key` | Register a DICT key on a BB account |
-| `delete_dict_key` | Delete a DICT key owned by the merchant |
-| `register_boleto` | Issue a boleto via BB Cobranças |
-| `get_boleto` | Retrieve a boleto by nosso_numero |
-| `cancel_boleto` | Cancel (baixa) an outstanding boleto |
-| `get_account_balance` | Conta-corrente balance |
-| `get_statement` | Account statement transactions |
+| `create_pix_cob` | Create an immediate Pix charge (cob) with QR code. |
+| `get_pix_cob` | Retrieve an immediate Pix charge by its txid. |
+| `list_pix_cob` | List immediate Pix charges (cob) by date range. |
+| `create_pix_devolucao` | Refund (devolução) a previously received Pix. |
+| `get_pix_devolucao` | Retrieve a Pix devolução by its endToEndId + refund id. |
+| `resolve_dict_key` | Resolve a DICT key (CPF, CNPJ, email, phone, EVP) to the owner's account data before sending a Pix. |
+| `register_dict_key` | Register a DICT key on a BB account owned by the merchant. |
+| `delete_dict_key` | Delete a DICT key owned by the merchant. |
+| `register_boleto` | Issue a boleto via BB Cobranças. |
+| `get_boleto` | Retrieve a boleto by nosso_numero. |
+| `cancel_boleto` | Cancel (baixa) an outstanding boleto before payment. |
+| `get_account_balance` | Retrieve the current balance of a BB conta-corrente (checking) account. |
+| `get_statement` | Retrieve account statement transactions for a BB conta-corrente over a date range. |
 
 ## Install
 
@@ -55,6 +55,10 @@ BB_ENV="sandbox"                       # or "production" (default: sandbox)
 npx @codespar/mcp-banco-do-brasil
 ```
 
+## Enterprise
+
+Need 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.
+
 ## License
 
 MIT

package/dist/index.js

@@ -172,7 +172,7 @@ async function bbRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-banco-do-brasil", version: "0.1.0-alpha.1" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-banco-do-brasil", version: "0.1.0-alpha.2" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codespar/mcp-banco-do-brasil",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "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).",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,5 +31,5 @@
     "open-finance",
     "brazil"
   ],
-  "mcpName": "io.github.codespar/banco-do-brasil"
+  "mcpName": "io.github.codespar/mcp-banco-do-brasil"
 }

package/server.json

@@ -1,18 +1,18 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.codespar/banco-do-brasil",
-  "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).",
+  "name": "io.github.codespar/mcp-banco-do-brasil",
+  "description": "MCP server for Banco do Brasil — Pix, Cobrança (boleto), Conta-Corrente, Arrecadação (OAuth2 + mTLS)",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/banking/banco-do-brasil"
   },
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-banco-do-brasil",
-      "version": "0.1.0-alpha.1",
+      "version": "0.1.0-alpha.3",
       "transport": {
         "type": "stdio"
       },
@@ -61,5 +61,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.bb.com.br",
+    "logoUrl": "https://logo.clearbit.com/bb.com.br",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=bb.com.br&sz=128",
+    "docsUrl": "https://developers.bb.com.br",
+    "sandbox": {
+      "available": true
+    }
+  }
 }

package/src/index.ts

@@ -197,7 +197,7 @@ async function bbRequest(method: string, path: string, body?: unknown): Promise<
 }
 
 const server = new Server(
-  { name: "mcp-banco-do-brasil", version: "0.1.0-alpha.1" },
+  { name: "mcp-banco-do-brasil", version: "0.1.0-alpha.2" },
   { capabilities: { tools: {} } }
 );