MCP server for Banco do Brasil — Pix, Cobrança (boleto), Conta-Corrente, Arrecadação (OAuth2 + mTLS)
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add banco-do-brasil --env BB_CLIENT_ID='<BB_CLIENT_ID>' --env BB_CLIENT_SECRET='<BB_CLIENT_SECRET>' --env BB_DEVELOPER_APP_KEY='<BB_DEVELOPER_APP_KEY>' --env BB_KEY_PATH='<BB_KEY_PATH>' -- npx -y @codespar/mcp-banco-do-brasil~/.codex/config.toml
[mcp_servers.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>", BB_KEY_PATH = "<BB_KEY_PATH>" }
# codex mcp add banco-do-brasil --env BB_CLIENT_ID='<BB_CLIENT_ID>' --env BB_CLIENT_SECRET='<BB_CLIENT_SECRET>' --env BB_DEVELOPER_APP_KEY='<BB_DEVELOPER_APP_KEY>' --env BB_KEY_PATH='<BB_KEY_PATH>' -- npx -y @codespar/mcp-banco-do-brasil~/.cursor/mcp.json
{
"mcpServers": {
"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>",
"BB_KEY_PATH": "<BB_KEY_PATH>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"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>",
"BB_KEY_PATH": "<BB_KEY_PATH>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"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>",
"BB_KEY_PATH": "<BB_KEY_PATH>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"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>",
"BB_KEY_PATH": "<BB_KEY_PATH>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"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>",
"BB_KEY_PATH": "<BB_KEY_PATH>"
}
}
}
}Environment variables
BB_CLIENT_IDBB_CLIENT_SECRETBB_DEVELOPER_APP_KEYBB_KEY_PATH
Replace the placeholders with your own credentials and keep them out of version control.