mcpbeat Sign in

MCP Banco Do Brasil MCP Server

local only

MCP Banco Do Brasil runs on your own machine — the client starts it, so there is no endpoint to ping. 80 installs a week from npm. Last commit 27 Sep 2026.

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

Installs per day peak 36 · avg 6 · +344% w/w
a month agotoday
80
Installs / week
npm · @codespar/mcp-banco-do-brasil
277
Stars
14 open issues
27 Sep 2026
Last commit
1 release in 90 days
MIT
License
TypeScript

What the code does

We read the source, 5 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] src/index.ts:1
этот файл ставится пользователю, но в репозитории его нет

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add mcp-banco-do-brasil -e 'BB_CLIENT_ID=<BB_CLIENT_ID>' -e 'BB_CLIENT_SECRET=<BB_CLIENT_SECRET>' -e 'BB_DEVELOPER_APP_KEY=<BB_DEVELOPER_APP_KEY>' -- npx -y @codespar/mcp-banco-do-brasil
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-banco-do-brasil": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-banco-do-brasil"
      ],
      "env": {
        "BB_CLIENT_ID": "<BB_CLIENT_ID>",
        "BB_CLIENT_SECRET": "<BB_CLIENT_SECRET>",
        "BB_DEVELOPER_APP_KEY": "<BB_DEVELOPER_APP_KEY>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.mcp-banco-do-brasil]
command = "npx"
args = ["-y", "@codespar/mcp-banco-do-brasil"]
env = { BB_CLIENT_ID = "<BB_CLIENT_ID>", BB_CLIENT_SECRET = "<BB_CLIENT_SECRET>", BB_DEVELOPER_APP_KEY = "<BB_DEVELOPER_APP_KEY>" }
.cursor/mcp.json
{
  "mcpServers": {
    "mcp-banco-do-brasil": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-banco-do-brasil"
      ],
      "env": {
        "BB_CLIENT_ID": "<BB_CLIENT_ID>",
        "BB_CLIENT_SECRET": "<BB_CLIENT_SECRET>",
        "BB_DEVELOPER_APP_KEY": "<BB_DEVELOPER_APP_KEY>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mcp-banco-do-brasil": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-banco-do-brasil"
      ],
      "env": {
        "BB_CLIENT_ID": "<BB_CLIENT_ID>",
        "BB_CLIENT_SECRET": "<BB_CLIENT_SECRET>",
        "BB_DEVELOPER_APP_KEY": "<BB_DEVELOPER_APP_KEY>"
      }
    }
  }
}

Put your own values in place of <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). The author’s registry entry marks them as required.

Optional settings from the registry entry, left out of the block above: BB_CERT_PATH (Absolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2 in production), BB_KEY_PATH (Absolute path to the mTLS private key (.key or .pem)), BB_ENV (Environment: 'sandbox' or 'production'. Defaults to 'sandbox').

Alternatives to MCP Banco Do Brasil

same job, measured the same way
MCP Santander
by codespar

MCP server for Santander Brasil — Pix, Cobrança (boleto), Arrecadação, Extrato (OAuth2 + mTLS)

64 installs/wk local only
MCP Bradesco
by codespar

MCP server for Bradesco — Pix, Cobrança (boleto), Arrecadação, Extrato (OAuth2 + mTLS)

58 installs/wk local only
MCP Itau
by codespar

MCP server for Itaú Unibanco — Pix, Cobrança (boleto), Arrecadação, Extrato (OAuth2 + mTLS)

65 installs/wk local only
MCP Sicoob
by codespar

MCP server for Sicoob — Pix (cob/cobv/DICT), Cobrança (boleto), SPB (OAuth2 + mTLS)

71 installs/wk local only
MCP Caixa
by codespar

MCP server for Caixa Econômica Federal — Pix, Cobrança (SICOB boleto), Extrato (OAuth2 + mTLS)

57 installs/wk local only
MCP Pix Bcb
by codespar

MCP server for Pix BCB API — official Banco Central do Brasil Pix standard

80 installs/wk local only
MCP Btg
by codespar

MCP server for BTG Pactual — Pix, Boleto, Account, Investments (CDB/LCI/LCA/funds), OAuth2 + mTLS

55 installs/wk local only
MCP Safrapay
by codespar

MCP server for Safrapay — Banco Safra acquirer: credit, Pix, boleto + split, 3DS, chargebacks

76 installs/wk local only

MCP Banco Do Brasil — questions

Answers built from our own checks of this server.

Why is there no uptime for MCP Banco Do Brasil?
MCP Banco Do Brasil runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @codespar/mcp-banco-do-brasil was installed 80 times last week.
How do I connect MCP Banco Do Brasil?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @codespar/mcp-banco-do-brasil straight from npm; nothing to host, nothing to sign up for.
How many people use MCP Banco Do Brasil?
The npm package @codespar/mcp-banco-do-brasil was installed 80 times in the last week. Week over week that is +344%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is MCP Banco Do Brasil open source?
Yes — it is published under the MIT licence, written in TypeScript, 277 stars on GitHub and 14 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.