Mcp Banco Do Brasil

stdio

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

Getting Started

npx @getmcp/cli add io.github.codespar/mcp-banco-do-brasil

Requires Node.js 18+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

BB_CLIENT_ID
Banco do Brasil OAuth client_id issued via developers.bb.com.br after contract onboarding.
BB_CLIENT_SECRET
Banco do Brasil OAuth client_secret.
BB_DEVELOPER_APP_KEY
BB Developer App Key (gw-dev-app-key) — appended as a query param on most BB API calls.

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.codespar/mcp-banco-do-brasil": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-banco-do-brasil"
      ],
      "env": {
        "BB_CLIENT_ID": "",
        "BB_CLIENT_SECRET": "",
        "BB_DEVELOPER_APP_KEY": "",
        "BB_CERT_PATH": "",
        "BB_KEY_PATH": "",
        "BB_ENV": ""
      }
    }
  }
}

Claude Desktop MCP documentation