mcp-bradesco — Claude Code MCP server: setup
This MCP server lets an agent use Bradesco APIs for Pix, boletos, statements, and transfers. OAuth2 credentials and an mTLS certificate are required.
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-bradescoWhat mcp-bradesco 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.
What it helps with
- 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 for the agent
- 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.
How to install mcp-bradesco
Platform CLI
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-bradescoReplace <…> with your own values
Platform CLI
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-bradescoReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-bradescoReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-bradesco
How do I install mcp-bradesco in Claude Code?
Run `claude mcp add mcp-bradesco -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> -- npx -y @codespar/mcp-bradesco`. Replace the OAuth values and certificate paths before starting it.
What does mcp-bradesco do?
It gives an agent Bradesco actions for Pix, boletos, statements, balances, bill payments, transfers, and DICT keys.
What does mcp-bradesco need to run?
You need OAuth2 credentials from the Bradesco Developer Portal plus a client certificate and private key for mTLS. Check the API paths against the OpenAPI specification provided for the merchant account.
