io.github.codespar/mcp-banco-do-brasil MCP Server
io.github.codespar/mcp-banco-do-brasil
MCP server for Banco do Brasil — Pix, Cobrança (boleto), Conta-Corrente, Arrecadação with OAuth2 + mTLS.
What this kind of tool is for
- Chain multi-step workflows across the other tools in this directory.
- Run a scheduled or triggered job instead of retyping the same request.
- Have your agent watch a feed, queue, or repo and act on new items.
How to compare servers like this
- Trigger model:
- Understand what starts the automation — a command, a schedule, or an event — before relying on it.
- Blast radius:
- Prefer tools that hand you a review point before an irreversible action runs.
- Chaining cost:
- Each chained step adds a failure point; keep critical paths on the fewest tools.
- Maintenance signal:
- Automations break quietly; a maintained tool is the difference between repair and rediscovery.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the io.github.codespar/mcp-banco-do-brasil MCP server?
The Banco do Brasil MCP server enables AI agents to interact with Brazil's largest public bank through the Model Context Protocol. It provides access to Pix instant payments, boleto billing (Cobrança), checking accounts (Conta-Corrente), and tax collection (Arrecadação) using OAuth2 and mutual TLS authentication.
This server connects your AI agent to Banco do Brasil's core banking services. You can create and manage Pix transfers, issue and track boletos, access account information, and handle tax payments — all through a standardized MCP interface. It's part of the broader MCP Dev LATAM ecosystem for running complete business workflows in Latin America.
How to install io.github.codespar/mcp-banco-do-brasil
Copy-paste configuration for popular MCP clients.
BB_CLIENT_IDrequiredBanco do Brasil OAuth client_id issued via developers.bb.com.br after contract onboarding.
BB_CLIENT_SECRETrequiredsecretBanco do Brasil OAuth client_secret.
BB_DEVELOPER_APP_KEYrequiredsecretBB Developer App Key (gw-dev-app-key) — appended as a query param on most BB API calls.
BB_CERT_PATHAbsolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2 in production.
BB_KEY_PATHsecretAbsolute path to the mTLS private key (.key or .pem).
BB_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.
{
"mcpServers": {
"mcp-banco-do-brasil": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-banco-do-brasil"
],
"env": {
"BB_CLIENT_ID": "<YOUR_BB_CLIENT_ID>",
"BB_CLIENT_SECRET": "<YOUR_BB_CLIENT_SECRET>",
"BB_DEVELOPER_APP_KEY": "<YOUR_BB_DEVELOPER_APP_KEY>",
"BB_CERT_PATH": "<YOUR_BB_CERT_PATH>",
"BB_KEY_PATH": "<YOUR_BB_KEY_PATH>",
"BB_ENV": "<YOUR_BB_ENV>"
}
}
}
}Tools & capabilities
Tools this server exposes to the agent.
Pix— Create and manage instant Pix payments and transfersCobrança (Boleto)— Issue, track, and manage boleto billingConta-Corrente— Access and manage checking account informationArrecadação— Handle tax collection and government payments
Use cases
- Send instant Pix payments to customers or vendors
- Issue boleto invoices for billing and payment collection
- Check account balance and transaction history
- Process tax payments and government collections
- Automate payment reconciliation in business workflows
io.github.codespar/mcp-banco-do-brasil MCP server FAQ
It's an MCP server that gives AI agents access to Banco do Brasil's banking services — Pix, boleto, account management, and tax payments — via a standardized interface.
The server itself is open-source (MIT license), but you need a Banco do Brasil API account and valid credentials to access the banking services.
Install via npm: `@codespar/mcp-banco-do-brasil`. Add it to your MCP client config with your OAuth2 credentials and mTLS certificates.
OAuth2 and mutual TLS (mTLS) authentication. You'll need API credentials from Banco do Brasil's developer portal.
Yes, once you have a production API account with Banco do Brasil. The server supports both sandbox and production environments.
Tools cover Pix transfers, boleto creation and tracking, account queries, balance checks, and tax payment processing.
README (reference)
Source of truth, from the repository.
The Problem
AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).
Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.
MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.
The Solution
Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.
🛒 Customer places order
→ 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
→ 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
→ 📦 Agent generates shipping label (Melhor Envio / Skydropx)
→ 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
→ 📊 Agent records in ERP (Omie / Bling / Tiny)
→ 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)
Six systems. Zero human intervention. One agent.
Agentic Payment Protocols
Four servers that bridge the emerging agentic payment stack:
| Protocol | Server | Tools | What it does |
|---|---|---|---|
| Google UCP | @codespar/mcp-ucp | 20 | Universal Commerce Protocol — agentic shopping, cart, checkout, orders, delivery, identity. Google's full commerce stack for AI agents. |
| Stripe ACP | @codespar/mcp-stripe-acp | 24 | Agentic Commerce Protocol — AI agent checkout, payment delegation, products, invoices. Live in ChatGPT with 1M+ Shopify merchants. |
| x402 | @codespar/mcp-x402 | 10 | HTTP-native micropayments by Coinbase — when an agent hits a 402, it pays USDC on Base/Solana and retries. Pure HTTP, no checkout UI. |
| AP2 | @codespar/mcp-ap2 <sub>alpha</sub> | 22 | Google's Agent-to-Agent Payment Protocol — authorization, audit trails, scoped spend limits. 60+ partners including Visa, Mastercard, Stripe, PayPal. |
The Autonomy Spectrum
Each protocol sits at a different level of agent autonomy:
Human-in-loop ◄──────────────────────────────► Fully autonomous
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ ACP │ │ UCP │ │ AP2 │ │ x402 │
│ Stripe │ │ Google │ │ Google │ │Coinbase │
└─────────┘ └─────────┘ └─────────┘ └─────────┘
User confirms Commerce User sets No user.
every purchase lifecycle rules, agent Machine-to-
in-chat managed acts within machine at
by agent budget/scope HTTP layer
The Convergence Stack
┌─────────────────────────────────────────────┐
│ Application Layer ACP / UCP │ Chat UX, product discovery
├─────────────────────────────────────────────┤
│ Authorization Layer AP2 / Mandates │ Spend limits, audit trails
├─────────────────────────────────────────────┤
│ Tool Layer MCP ◄── WE ARE │ Standardized agent tools
├─────────────────────────────────────────────┤
│ Settlement Layer x402 / Pix / Card │ On-chain or traditional rails
└─────────────────────────────────────────────┘
MCP Dev LATAM sits at the Tool Layer — the middleware that connects every application, authorization, and settlement protocol through one interface.
Why this matters
Agent needs to buy something
├── Full commerce? → Google UCP (search → cart → checkout → delivery)
├── Retail checkout? → Stripe ACP (create_checkout → complete_checkout)
├── API micropayment? → x402 (pay_request → USDC $0.001 → data returned)
├── Agent-to-agent? → AP2 (authorize_payment → execute_payment)
└── LATAM merchant? → Asaas / Mercado Pago / Conekta / Wompi / etc.
All via MCP. Same interface. One agent.
Quick Start
With Claude Desktop
Add to ~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"stripe-acp": {
"command": "npx",
"args": ["-y", "@codespar/mcp-stripe-acp"],
"env": {
"STRIPE_API_KEY": "sk_test_..."
}
},
"asaas": {
"command": "npx",
"args": ["-y", "@codespar/mcp-asaas"],
"env": {
"ASAAS_API_KEY": "your-api-key",
"ASAAS_SANDBOX": "true"
}
}
}
}
For alpha packages (contract-gated providers like Itaú, Bradesco, Santander, Caixa, BB, BTG, C6, Sicoob, Bradesco, Matera), add @alpha to the install:
npx -y @codespar/mcp-itau@alpha
With any MCP client
npx @codespar/mcp-stripe-acp # Agentic Commerce Protocol
npx @codespar/mcp-ucp # Google Universal Commerce Protocol
npx @codespar/mcp-x402 # HTTP micropayments (Coinbase)
npx @codespar/mcp-ap2@alpha # Agent-to-Agent payment authorization
npx @codespar/mcp-asaas # BR billing + Pix
npx @codespar/mcp-mercado-pago # LATAM payments
npx @codespar/mcp-nuvem-fiscal # NFe / NFSe
npx @codespar/mcp-melhor-envio # Multi-carrier shipping
npx @codespar/mcp-z-api # WhatsApp messaging
npx @codespar/mcp-omie # ERP
npx @codespar/mcp-stark-bank # Banking
npx @codespar/mcp-brasil-api # CEP, CNPJ (no key needed!)
Try it now (no API key)
BrasilAPI and BCRA are public — no key required. Try it in your terminal:
npx @codespar/mcp-brasil-api
Then ask your agent: "What is the address for CEP 01001-000?" or "Look up CNPJ 00.000.000/0001-91".
The Complete Loop
This is what makes the LATAM catalog different — not individual connectors, but a complete business workflow across verticals:
| Step | Vertical | Example providers | What the agent does |
|---|---|---|---|
| 1 | 💳 Payment | Asaas / Mercado Pago / Zoop | Creates Pix charge, splits to sellers |
| 2 | 📄 Fiscal | Nuvem Fiscal / NFe.io / Focus NFe | Issues NFe/NFSe when payment confirmed |
| 3 | 📦 Logistics | Melhor Envio / Correios / Skydropx | Quotes shipping, generates label |
| 4 | 📱 Messaging | Z-API / WhatsApp Cloud / Twilio | Sends tracking via customer's preferred channel |
| 5 | 📊 ERP | Omie / Bling / Tiny / Conta Azul | Records order, updates inventory |
| 6 | 🏦 Banking | Stark Bank / Itaú / BTG | Reconciles balance, creates reports |
To orchestrate all six steps with governance, approval workflows, and audit trails — use CodeSpar.
All Servers
Browse the full catalog at codespar.dev/servers. Each server has its own README, env-var requirements, and tool reference under packages/<category>/<slug>/.
💳 Payments (40 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Mercado Pago | 30 | @codespar/mcp-mercado-pago | API Key |
| Stripe | 30 | @codespar/mcp-stripe | API Key |
| Zoop | 28 | @codespar/mcp-zoop | API Key |
| Adyen | 25 | @codespar/mcp-adyen | API Key |
| Asaas | 24 | @codespar/mcp-asaas | API Key |
| Pagseguro | 24 | @codespar/mcp-pagseguro | API Key |
| Stripe ACP | 24 | @codespar/mcp-stripe-acp | API Key |
| Iugu | 23 | @codespar/mcp-iugu | API Key |
| Openpay | 23 | @codespar/mcp-openpay | API Key |
| AP2 <sub>alpha</sub> | 22 | @codespar/mcp-ap2 | API Key |
| Braintree | 22 | @codespar/mcp-braintree | API Key |
| Braspag | 22 | @codespar/mcp-braspag | API Key |
| Cielo | 22 | @codespar/mcp-cielo | API Key |
| Inter Bank | 22 | @codespar/mcp-inter-bank | OAuth2 |
| Mercado Libre | 22 | @codespar/mcp-mercado-libre | API Key |
| Nubank <sub>alpha</sub> | 22 | @codespar/mcp-nubank | OAuth2 |
| Nupay | 22 | @codespar/mcp-nupay | OAuth2 |
| Pagar Me | 22 | @codespar/mcp-pagar-me | API Key |
| Rapyd | 22 | @codespar/mcp-rapyd | API Key |
| Rede <sub>alpha</sub> | 22 | @codespar/mcp-rede | API Key |
| Safrapay <sub>alpha</sub> | 22 | @codespar/mcp-safrapay | OAuth2 |
| Worldpay <sub>alpha</sub> | 22 | @codespar/mcp-worldpay | API Key |
| Khipu <sub>alpha</sub> | 21 | @codespar/mcp-khipu | API Key |
| Stone | 21 | @codespar/mcp-stone | API Key |
| Wise | 21 | @codespar/mcp-wise | API Key |
| Airwallex | 20 | @codespar/mcp-airwallex | OAuth2 |
| Culqi | 20 | @codespar/mcp-culqi | API Key |
| Getnet | 20 | @codespar/mcp-getnet | OAuth2 |
| Izipay <sub>alpha</sub> | 20 | @codespar/mcp-izipay | API Key |
| Picpay <sub>alpha</sub> | 20 | @codespar/mcp-picpay | API Key |
| UCP | 20 | @codespar/mcp-ucp | API Key |
| Vindi | 20 | @codespar/mcp-vindi | API Key |
| Paypal | 19 | @codespar/mcp-paypal | OAuth2 |
| Transbank <sub>alpha</sub> | 19 | @codespar/mcp-transbank | API Key |
| Celcoin | 18 | @codespar/mcp-celcoin | API Key |
| dLocal | 18 | @codespar/mcp-dlocal | API Key |
| Ebanx | 18 | @codespar/mcp-ebanx | API Key |
| Efi | 18 | @codespar/mcp-efi | API Key |
| Pix BCB | 18 | @codespar/mcp-pix-bcb | API Key |
| Chargebee | 15 | @codespar/mcp-chargebee | API Key |
🏦 Banking (12 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Stark Bank | 27 | @codespar/mcp-stark-bank | API Key |
| Caixa <sub>alpha</sub> | 23 | @codespar/mcp-caixa | OAuth2 |
| Santander <sub>alpha</sub> | 23 | @codespar/mcp-santander | OAuth2 |
| Bradesco <sub>alpha</sub> | 22 | @codespar/mcp-bradesco | OAuth2 |
| Itau <sub>alpha</sub> | 22 | @codespar/mcp-itau | OAuth2 |
| Matera <sub>alpha</sub> | 22 | @codespar/mcp-matera | OAuth2 |
| Dock <sub>alpha</sub> | 20 | @codespar/mcp-dock | OAuth2 |
| Open Finance | 18 | @codespar/mcp-open-finance | API Key |
| C6 <sub>alpha</sub> | 14 | @codespar/mcp-c6 | OAuth2 |
| Banco Do Brasil <sub>alpha</sub> | 13 | @codespar/mcp-banco-do-brasil | OAuth2 |
| Sicoob <sub>alpha</sub> | 13 | @codespar/mcp-sicoob | OAuth2 |
| BTG <sub>alpha</sub> | 12 | @codespar/mcp-btg | OAuth2 |
📄 Fiscal (Brasil) (4 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Nuvem Fiscal | 24 | @codespar/mcp-nuvem-fiscal | API Key |
| Nfe Io | 22 | @codespar/mcp-nfe-io | API Key |
| Conta Azul | 20 | @codespar/mcp-conta-azul | API Key |
| Focus Nfe | 19 | @codespar/mcp-focus-nfe | API Key |
📱 Communication (8 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Z API | 27 | @codespar/mcp-z-api | API Key |
| Evolution API | 25 | @codespar/mcp-evolution-api | API Key |
| Twilio | 22 | @codespar/mcp-twilio | API Key |
| Whatsapp Cloud | 22 | @codespar/mcp-whatsapp-cloud | API Key |
| Sendgrid | 20 | @codespar/mcp-sendgrid | API Key |
| Rd Station | 18 | @codespar/mcp-rd-station | API Key |
| Take Blip | 18 | @codespar/mcp-take-blip | API Key |
| Zenvia | 18 | @codespar/mcp-zenvia | API Key |
📦 E-commerce / Logistics (7 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Vtex | 33 | @codespar/mcp-vtex | API Key |
| Shopify | 28 | @codespar/mcp-shopify | API Key |
| Amazon <sub>alpha</sub> | 24 | @codespar/mcp-amazon | OAuth2 |
| Shopee <sub>alpha</sub> | 22 | @codespar/mcp-shopee | API Key |
| Correios <sub>alpha</sub> | 21 | @codespar/mcp-correios | API Key |
| Melhor Envio | 18 | @codespar/mcp-melhor-envio | API Key |
| SuperFrete | 11 | @codespar/mcp-superfrete | API Key |
📊 ERP / Accounting (5 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Omie | 30 | @codespar/mcp-omie | API Key |
| Bling | 28 | @codespar/mcp-bling | API Key |
| Xero | 24 | @codespar/mcp-xero | API Key |
| Quickbooks | 22 | @codespar/mcp-quickbooks | API Key |
| Tiny | 21 | @codespar/mcp-tiny | API Key |
🪪 Identity & KYC (5 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Brasil API | 24 | @codespar/mcp-brasil-api | No auth |
| Jumio | 20 | @codespar/mcp-jumio | API Key |
| Onfido | 20 | @codespar/mcp-onfido | API Key |
| Persona | 20 | @codespar/mcp-persona | API Key |
| Unico <sub>alpha</sub> | 18 | @codespar/mcp-unico | OAuth2 |
🛡️ Fraud & Risk (4 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Sift <sub>alpha</sub> | 20 | @codespar/mcp-sift | API Key |
| Clearsale <sub>alpha</sub> | 18 | @codespar/mcp-clearsale | API Key |
| Konduto <sub>alpha</sub> | 18 | @codespar/mcp-konduto | API Key |
| Legiti <sub>alpha</sub> | 18 | @codespar/mcp-legiti | API Key |
🪙 Crypto / Stablecoins (9 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Circle | 23 | @codespar/mcp-circle | API Key |
| Foxbit | 21 | @codespar/mcp-foxbit | API Key |
| Bitso | 20 | @codespar/mcp-bitso | API Key |
| Mercado Bitcoin | 20 | @codespar/mcp-mercado-bitcoin | API Key |
| Moonpay | 20 | @codespar/mcp-moonpay | API Key |
| Unblockpay | 13 | @codespar/mcp-unblockpay | API Key |
| Coinbase Commerce | 18 | @codespar/mcp-coinbase-commerce | API Key |
| Transak <sub>alpha</sub> | 18 | @codespar/mcp-transak | API Key |
| x402 | 10 | @codespar/mcp-x402 | API Key |
🇦🇷 Argentina (5 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Tienda Nube | 24 | @codespar/mcp-tienda-nube | API Key |
| Colppy <sub>alpha</sub> | 22 | @codespar/mcp-colppy | API Key |
| AFIP <sub>alpha</sub> | 20 | @codespar/mcp-afip | API Key |
| Andreani <sub>alpha</sub> | 18 | @codespar/mcp-andreani | API Key |
| BCRA | 16 | @codespar/mcp-bcra | No auth |
🇨🇴 Colombia (5 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Siigo | 22 | @codespar/mcp-siigo | API Key |
| Wompi | 22 | @codespar/mcp-wompi | API Key |
| Alegra | 20 | @codespar/mcp-alegra | API Key |
| Coordinadora <sub>alpha</sub> | 19 | @codespar/mcp-coordinadora | API Key |
| Nequi <sub>alpha</sub> | 16 | @codespar/mcp-nequi | OAuth2 |
🇲🇽 Mexico (6 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
| Belvo | 24 | @codespar/mcp-belvo | API Key |
| Skydropx | 23 | @codespar/mcp-skydropx | API Key |
| Conekta | 21 | @codespar/mcp-conekta | API Key |
| Bind ERP | 20 | @codespar/mcp-bind-erp | API Key |
| Facturapi | 20 | @codespar/mcp-facturapi | API Key |
| STP/SPEI <sub>alpha</sub> | 18 | @codespar/mcp-stp-spei | API Key |
Why MCP?
Model Context Protocol is the open standard for connecting AI agents to external tools. Instead of each agent building its own integrations, MCP provides a typed, discoverable interface that works with Claude, ChatGPT, Cursor, VS Code, and more.
AI Agent (Claude, ChatGPT, Cursor)
↕
MCP Server (this repo)
↕
LATAM API / Agentic Protocol (Stripe ACP, x402, Asaas, Mercado Pago, NFe.io, etc.)
Each MCP server in this repo:
- Exposes typed tools with input/output schemas
- Handles authentication (OAuth, mTLS, API keys, Basic Auth, JWT-RSA, signed requests)
- Supports dual transport — stdio (default) and Streamable HTTP (
--httpflag) - Compatible with Claude Managed Agents via MCP Connector
- Supports sandbox mode for safe testing
- Returns structured JSON responses
Running in HTTP mode
Any server can run as an HTTP server for remote/cloud use:
# stdio (default — local, Claude Desktop, Cursor, Claude Code)
npx @codespar/mcp-asaas
# HTTP (remote — Managed Agents, cloud deployments)
npx @codespar/mcp-asaas --http
# or
MCP_HTTP=true npx @codespar/mcp-asaas
HTTP mode exposes /mcp (Streamable HTTP) and /health (status check).
Alpha vs stable
About a third of the catalog ships under the alpha npm dist-tag. These packages have correct tool schemas and auth flow, but the endpoint paths are best-guesses — typically because the provider's developer portal is contract-gated (BR public banks, AR central authority APIs, MX bank-transfer providers). They're flagged with TODO(verify) in source.
npm install @codespar/mcp-itau@alpha
Stable packages (the majority) install with the default tag:
npm install @codespar/mcp-stripe
Status is shown on every package page at codespar.dev/servers and in each package README.
About CodeSpar
CodeSpar builds commerce infrastructure for AI agents in Latin America — an MCP catalog (this repo), a runtime + SDK (@codespar/sdk on npm, codespar on PyPI), and a managed-tier governance product (AgentGate: programmable wallet, policy engine, CFO-grade audit, fiscal-compliance certifications).
Individual MCP servers are useful. Orchestrating many with governance is powerful. That's what CodeSpar does.
Contributing
We welcome contributions. See CONTRIBUTING.md.
Want a server for a service not listed? Open a server-request issue — there's a structured form with name, npm package, docs link, auth flow.
License
MIT — use freely in commercial and open source projects.
Related MCP servers

Free, no-key access to Argentina's Central Bank data—exchange rates, inflation, and reserves.

Belvo Open Finance aggregator for LATAM — access banking, payments, and financial data across Latin America via MCP.
Query BigDataCorp's Brazilian KYC and antifraud data (CPF/CNPJ/vehicle/property) from your AI agent.

Connect AI agents to Bind ERP, Mexico's cloud ERP, for order and inventory management via MCP.

MCP server for Bitso crypto exchange — trade, fund, and withdraw on Latin America's leading digital asset platform.

MCP server for Bling ERP — manage products, orders, invoices (NF-e/NFS-e), stock, AR/AP, and webhooks.