Skip to content
appsgit

Banco Do Brasil

Banco Do Brasil is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for Banco do Brasil — Pix, Cobrança (boleto), Conta-Corrente, Arrecadação (OAuth2 + mTLS). It has 274 GitHub stars, is released under the MIT license and runs locally with npx -y @codespar/mcp-banco-do-brasil.

github.com/codespar/mcp-dev-latam (opens in a new tab)

Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error

View on GitHub (opens in a new tab)

Install Banco Do Brasil

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "banco-do-brasil": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-banco-do-brasil"
      ],
      "env": {
        "BB_CLIENT_ID": "your-value",
        "BB_CLIENT_SECRET": "your-value",
        "BB_DEVELOPER_APP_KEY": "your-value",
        "BB_KEY_PATH": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env BB_CLIENT_ID=your-value --env BB_CLIENT_SECRET=your-value --env BB_DEVELOPER_APP_KEY=your-value --env BB_KEY_PATH=your-value --transport stdio banco-do-brasil -- npx -y @codespar/mcp-banco-do-brasil

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "banco-do-brasil": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-banco-do-brasil"
      ],
      "env": {
        "BB_CLIENT_ID": "your-value",
        "BB_CLIENT_SECRET": "your-value",
        "BB_DEVELOPER_APP_KEY": "your-value",
        "BB_KEY_PATH": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "bb_client_secret",
      "description": "BB_CLIENT_SECRET",
      "password": true
    },
    {
      "type": "promptString",
      "id": "bb_developer_app_key",
      "description": "BB_DEVELOPER_APP_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "bb_key_path",
      "description": "BB_KEY_PATH",
      "password": true
    }
  ],
  "servers": {
    "banco-do-brasil": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-banco-do-brasil"
      ],
      "env": {
        "BB_CLIENT_ID": "your-value",
        "BB_CLIENT_SECRET": "${input:bb_client_secret}",
        "BB_DEVELOPER_APP_KEY": "${input:bb_developer_app_key}",
        "BB_KEY_PATH": "${input:bb_key_path}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
BB_CLIENT_IDYesBanco do Brasil OAuth client_id issued via developers.bb.com.br after contract onboarding.
BB_CLIENT_SECRETsecretYesBanco do Brasil OAuth client_secret.
BB_DEVELOPER_APP_KEYsecretYesBB Developer App Key (gw-dev-app-key) — appended as a query param on most BB API calls.
BB_CERT_PATHNoAbsolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2 in production.
BB_KEY_PATHsecretNoAbsolute path to the mTLS private key (.key or .pem).
BB_ENVNoEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.

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

  • agentic-commerce
  • ai-agents
  • brazil
  • claude
  • fintech
  • latin-america
  • llm-tools
  • mcp
  • model-context-protocol
  • nfe

Similar MCP servers

More finance MCP servers

All Finance

FAQ

Banco Do Brasil FAQ

Still curious? Email info@appsgit.com.

How do I install the Banco Do Brasil MCP server?

Add the command npx -y @codespar/mcp-banco-do-brasil to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Banco Do Brasil free?

The server is open source under the MIT license, so running it is free. It needs credentials (BB_CLIENT_SECRET, BB_DEVELOPER_APP_KEY and BB_KEY_PATH) for the service it connects to, which may require a paid account.

Is Banco Do Brasil actively maintained?

The most recent commit was on Sep 27, 2026. appsgit only lists MCP servers with a commit in the last six months.