mcp-caixa — Claude Code MCP server: what it does, how to install
Connects AI agents to Caixa Econômica Federal for Pix transfers, Cobrança boletos, and statement queries using mTLS and OAuth2.
claude mcp add --env CAIXA_CLIENT_ID=<CAIXA_CLIENT_ID> --env CAIXA_CLIENT_SECRET=<CAIXA_CLIENT_SECRET> --env CAIXA_CERT_PATH=<CAIXA_CERT_PATH> --env CAIXA_KEY_PATH=<CAIXA_KEY_PATH> --env CAIXA_ENV=<CAIXA_ENV> --transport stdio caixa -- npx -y @codespar/mcp-caixaWhat mcp-caixa does
This server supplies 23 tools designed for Caixa Econômica Federal integrations. It handles outbound Pix transactions, dynamic QR codes, DICT key operations, and account statement lookups. It also covers Cobrança v2 boleto issuance, PDF downloads, and tax payments for federal receipts such as DARF and GRU.
Security relies on two mandatory layers. The server requests OAuth2 bearer tokens and routes requests via Node HTTPS agents with mutual TLS. You must provide the client certificate and private key paths using local environment variables.
The package runs on version 0.1.0-alpha.1. Because Caixa restricts developer documentation behind vendor contracts, the author mapped endpoints from BACEN Pix v2 standards and peer bank conventions. Several routes remain unverified in the code, meaning you need active Caixa onboarding credentials to test them.
What it helps with
- create dynamic Pix charges and QR codes
- issue and cancel Cobrança v2 boletos
- download rendered PDF documents for issued boletos
- retrieve account statements and check FGTS balances
- settle federal tribute payments such as DARF and GRU
Example prompts for the agent
- Create a dynamic Pix charge with a QR code for 120 BRL
- Issue a new boleto with Caixa Cobrança and return the PDF file
- Check the status of our Pix transaction using the endToEndId
How to install mcp-caixa
Platform CLI
claude mcp add --env CAIXA_CLIENT_ID=<CAIXA_CLIENT_ID> --env CAIXA_CLIENT_SECRET=<CAIXA_CLIENT_SECRET> --env CAIXA_CERT_PATH=<CAIXA_CERT_PATH> --env CAIXA_KEY_PATH=<CAIXA_KEY_PATH> --env CAIXA_ENV=<CAIXA_ENV> --transport stdio caixa -- npx -y @codespar/mcp-caixaReplace <…> with your own values
Platform CLI
codex mcp add caixa --env CAIXA_CLIENT_ID=<CAIXA_CLIENT_ID> --env CAIXA_CLIENT_SECRET=<CAIXA_CLIENT_SECRET> --env CAIXA_CERT_PATH=<CAIXA_CERT_PATH> --env CAIXA_KEY_PATH=<CAIXA_KEY_PATH> --env CAIXA_ENV=<CAIXA_ENV> -- npx -y @codespar/mcp-caixaReplace <…> with your own values
Config file
{
"mcpServers": {
"caixa": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-caixa"
],
"env": {
"CAIXA_CLIENT_ID": "<CAIXA_CLIENT_ID>",
"CAIXA_CLIENT_SECRET": "<CAIXA_CLIENT_SECRET>",
"CAIXA_CERT_PATH": "<CAIXA_CERT_PATH>",
"CAIXA_KEY_PATH": "<CAIXA_KEY_PATH>",
"CAIXA_ENV": "<CAIXA_ENV>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"caixa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-caixa"
],
"env": {
"CAIXA_CLIENT_ID": "<CAIXA_CLIENT_ID>",
"CAIXA_CLIENT_SECRET": "<CAIXA_CLIENT_SECRET>",
"CAIXA_CERT_PATH": "<CAIXA_CERT_PATH>",
"CAIXA_KEY_PATH": "<CAIXA_KEY_PATH>",
"CAIXA_ENV": "<CAIXA_ENV>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e CAIXA_CLIENT_ID=<CAIXA_CLIENT_ID> -e CAIXA_CLIENT_SECRET=<CAIXA_CLIENT_SECRET> -e CAIXA_CERT_PATH=<CAIXA_CERT_PATH> -e CAIXA_KEY_PATH=<CAIXA_KEY_PATH> -e CAIXA_ENV=<CAIXA_ENV> caixa npx -y @codespar/mcp-caixaReplace <…> 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-caixa
How do I install mcp-caixa in Claude Code?
Run the stdio command with your credentials and certificate paths: `claude mcp add --env CAIXA_CLIENT_ID=<CAIXA_CLIENT_ID> --env CAIXA_CLIENT_SECRET=<CAIXA_CLIENT_SECRET> --env CAIXA_CERT_PATH=<CAIXA_CERT_PATH> --env CAIXA_KEY_PATH=<CAIXA_KEY_PATH> --env CAIXA_ENV=<CAIXA_ENV> --transport stdio caixa -- npx -y @codespar/mcp-caixa`.
What does mcp-caixa do?
It provides MCP tools to interact with Caixa banking services in Brazil. An assistant can manage Pix payments, generate boletos, download payment slips, and query statements.
What credentials are required to connect?
You need an approved merchant agreement with Caixa. The server requires OAuth2 client credentials alongside an mTLS certificate and a matching private key.
