Mcp Banco Do Brasil

io.github.codespar由 GitHub 帳號 codespar 發布v0.1.0-alpha.5更新於 Oct 24, 2026

MCP server for Banco do Brasil — Pix, Cobrança (boleto), Conta-Corrente, Arrecadação (OAuth2 + mTLS)

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

針對巴西銀行（Banco do Brasil）API 的本地 MCP 伺服器，讓助理建立與管理 Pix 收款、boleto、DICT 金鑰，並讀取帳戶餘額與交易明細。

可以做什麼
建立、查詢與列出即時 Pix 收款（cob），並發起與查詢 Pix 退款（devolução）。解析、註冊與刪除 DICT 金鑰（CPF、CNPJ、電子郵件、電話、EVP）。透過 BB Cobranças 簽發、查詢與取消 boleto。依日期範圍讀取巴西銀行活期帳戶的餘額與交易明細。
適用情境
適合直接串接巴西銀行、進行大量 Pix 與 boleto 業務的商家或開發者，或需要在助理中查看帳戶餘額與交易明細。鑑於其 alpha 狀態，建議先在沙箱環境試用。
執行需求
透過 npm（npx）以 stdio 在本機執行。需要巴西銀行開發者合約及 OAuth 憑證：BB_CLIENT_ID、BB_CLIENT_SECRET 與 BB_DEVELOPER_APP_KEY。正式環境的 Pix v2 要求 mTLS，因此 BB_CERT_PATH 與 BB_KEY_PATH 需指向用戶端憑證與私鑰。BB_ENV 選擇 sandbox（預設）或 production。需要連線至 BB API 與 OAuth 端點的網路。
安裝前請注意
需要 OAuth 密鑰（BB_CLIENT_SECRET、BB_DEVELOPER_APP_KEY）與 mTLS 私鑰檔案（BB_KEY_PATH），請妥善保管。工具涉及真實資金操作：建立 Pix 收款、發起退款、註冊或刪除 DICT 金鑰、簽發與取消 boleto，以及讀取餘額與交易明細。此伺服器為 alpha 版本，boleto、帳戶與交易明細的 API 路徑為未經核實的推測，請鎖定確切版本並在正式上線前於沙箱測試。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Banco Do Brasil，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@codespar/mcp-banco-do-brasil

MCP server for Banco do Brasil — Brazil's top public bank.

BB 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.

Status: alpha (0.1.0-alpha.1)

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 (13)

ToolPurpose
create_pix_cobCreate an immediate Pix charge (cob) with QR code.
get_pix_cobRetrieve an immediate Pix charge by its txid.
list_pix_cobList immediate Pix charges (cob) by date range.
create_pix_devolucaoRefund (devolução) a previously received Pix.
get_pix_devolucaoRetrieve a Pix devolução by its endToEndId + refund id.
resolve_dict_keyResolve a DICT key (CPF, CNPJ, email, phone, EVP) to the owner's account data before sending a Pix.
register_dict_keyRegister a DICT key on a BB account owned by the merchant.
delete_dict_keyDelete a DICT key owned by the merchant.
register_boletoIssue a boleto via BB Cobranças.
get_boletoRetrieve a boleto by nosso_numero.
cancel_boletoCancel (baixa) an outstanding boleto before payment.
get_account_balanceRetrieve the current balance of a BB conta-corrente (checking) account.
get_statementRetrieve account statement transactions for a BB conta-corrente over a date range.

Install

bash
npm install @codespar/[email protected]

Environment

bash
BB_CLIENT_ID="..."             # OAuth client_id from developers.bb.com.brBB_CLIENT_SECRET="..."         # OAuth client_secretBB_DEVELOPER_APP_KEY="..."     # gw-dev-app-key — required on most callsBB_CERT_PATH="/abs/path/client.crt"   # mTLS cert (production only)BB_KEY_PATH="/abs/path/client.key"    # mTLS key  (production only)BB_ENV="sandbox"                       # or "production" (default: sandbox)BB_BASE_URL="..."                      # optional; default api.hm.bb.com.br (sandbox) / api.bb.com.brBB_AUTH_URL="..."                      # optional; default https://oauth.hm.bb.com.br/oauth/token (sandbox) / oauth.bb.com.br

Authentication

  • OAuth2 client_credentials — token endpoint at oauth.{env}.bb.com.br. Bearer cached until ~60s before expiry.
  • mTLS — required by BACEN for Pix v2 in production. Sandbox typically allows TLS-only; cert/key are optional in sandbox and required in production.
  • gw-dev-app-key — BB API gateway key, appended as a query param on all calls.

Run

bash
npx @codespar/mcp-banco-do-brasil

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

來源：packages/banking/banco-do-brasil/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

2
  1. v0.1.0-alpha.5最新Sep 27, 2026
  2. v0.1.0-alpha.4Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分