# mcp-caixa

Connects AI agents to Caixa Econômica Federal for Pix transfers, Cobrança boletos, and statement queries using mTLS and OAuth2.

- 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/caixa
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-caixa

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CAIXA_CLIENT_ID`, `CAIXA_CLIENT_SECRET`, `CAIXA_CERT_PATH`, `CAIXA_KEY_PATH`, `CAIXA_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 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
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-caixa
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-caixa
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

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