# mcp-bradesco

This MCP server lets an agent use Bradesco APIs for Pix, boletos, statements, and transfers. OAuth2 credentials and an mTLS certificate are required.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/banking/bradesco
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-bradesco

## What it does

mcp-bradesco exposes 22 Bradesco operations to an agent. They cover outbound and refunded Pix, dynamic QR charges, boletos, account statements, balance checks, bill and DARF payments, TED transfers, and DICT key management. Pix charges with due dates are supported too.

It runs through `npx` with stdio or HTTP transport. Each request uses OAuth2 `client_credentials` together with mutual TLS. Configure `BRADESCO_CLIENT_ID`, `BRADESCO_CLIENT_SECRET`, `BRADESCO_CERT_PATH`, and `BRADESCO_KEY_PATH`; select the environment with `BRADESCO_ENV`.

The package is alpha, and its API paths and base URLs still need comparison with the OpenAPI specification issued by Bradesco. Without the client certificate and private key, mTLS authentication will fail.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BRADESCO_CLIENT_ID`, `BRADESCO_CLIENT_SECRET`, `BRADESCO_CERT_PATH`, `BRADESCO_KEY_PATH`, `BRADESCO_ENV` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env BRADESCO_CLIENT_ID=<BRADESCO_CLIENT_ID> --env BRADESCO_CLIENT_SECRET=<BRADESCO_CLIENT_SECRET> --env BRADESCO_CERT_PATH=<BRADESCO_CERT_PATH> --env BRADESCO_KEY_PATH=<BRADESCO_KEY_PATH> --env BRADESCO_ENV=<BRADESCO_ENV> --transport stdio bradesco -- npx -y @codespar/mcp-bradesco
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add bradesco --env BRADESCO_CLIENT_ID=<BRADESCO_CLIENT_ID> --env BRADESCO_CLIENT_SECRET=<BRADESCO_CLIENT_SECRET> --env BRADESCO_CERT_PATH=<BRADESCO_CERT_PATH> --env BRADESCO_KEY_PATH=<BRADESCO_KEY_PATH> --env BRADESCO_ENV=<BRADESCO_ENV> -- npx -y @codespar/mcp-bradesco
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bradesco": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-bradesco"
            ],
            "env": {
                "BRADESCO_CLIENT_ID": "<BRADESCO_CLIENT_ID>",
                "BRADESCO_CLIENT_SECRET": "<BRADESCO_CLIENT_SECRET>",
                "BRADESCO_CERT_PATH": "<BRADESCO_CERT_PATH>",
                "BRADESCO_KEY_PATH": "<BRADESCO_KEY_PATH>",
                "BRADESCO_ENV": "<BRADESCO_ENV>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bradesco": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-bradesco"
            ],
            "env": {
                "BRADESCO_CLIENT_ID": "<BRADESCO_CLIENT_ID>",
                "BRADESCO_CLIENT_SECRET": "<BRADESCO_CLIENT_SECRET>",
                "BRADESCO_CERT_PATH": "<BRADESCO_CERT_PATH>",
                "BRADESCO_KEY_PATH": "<BRADESCO_KEY_PATH>",
                "BRADESCO_ENV": "<BRADESCO_ENV>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BRADESCO_CLIENT_ID=<BRADESCO_CLIENT_ID> -e BRADESCO_CLIENT_SECRET=<BRADESCO_CLIENT_SECRET> -e BRADESCO_CERT_PATH=<BRADESCO_CERT_PATH> -e BRADESCO_KEY_PATH=<BRADESCO_KEY_PATH> -e BRADESCO_ENV=<BRADESCO_ENV> bradesco npx -y @codespar/mcp-bradesco
```
Replace <…> with your own values

## When to use it
- send a Pix payment from a merchant account
- issue a QR-based Pix charge or boleto
- read transactions for an account period
- pay a DARF or utility bill
- manage DICT keys for a Bradesco account

## Example prompts
- Send a Pix payment from the Bradesco account using these recipient details and report the result.
- Create a dynamic Pix QR charge for the specified amount.
- Fetch the Bradesco account statement for this period and list its transactions.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md