Banco público estatal do BR. Distinto dos pares privados: a Caixa cuida de programas sociais (FGTS, PIS/PASEP, bolsa família), loterias e merchants que precisam da credibilidade de um banco estatal. OAuth2 + mTLS (Pix v2 do BACEN). Alpha no npm — onboarding estatal + docs fechadas por contrato.
O Caixa dá ao seu agente 23 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.
get_oauth_token — Mint or return a cached OAuth2 client_credentials bearer token for the Caixa Developer Portal. Exposed so agents can inspect token freshness; normal tool calls obtain tokens implicitly.send_pix — Initiate an outbound Pix payment from the merchant's Caixa account. Amount in BRL major units (e.g. '10.50').create_pix_qr — Create a dynamic Pix charge with QR code (cob). Returns the txid, copy-paste EMV payload, and location URL.// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("get_oauth_token", { /* ... */ });$ npm install @codespar/mcp-caixa@alphaAdicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).
{
"mcpServers": {
"caixa": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-caixa@alpha"
],
"env": {
"CAIXA_CLIENT_ID": "<your_caixa_client_id>",
"CAIXA_CLIENT_SECRET": "<your_caixa_client_secret>",
"CAIXA_CERT_PATH": "<your_caixa_cert_path>",
"CAIXA_KEY_PATH": "<your_caixa_key_path>"
}
}
}
}Depois de reiniciar, seu agente pode chamar qualquer uma das 23 ferramentas abaixo — teste get_oauth_token primeiro.
Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.
CAIXA_CLIENT_IDCaixa OAuth client_id issued via the Developer Portal after contract onboarding.
CAIXA_CLIENT_SECRETCaixa OAuth client_secret.
CAIXA_CERT_PATHAbsolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2.
CAIXA_KEY_PATHAbsolute path to the mTLS private key (.key or .pem).
CAIXA_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.
Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.
get_oauth_tokensend_pixcreate_pix_qrget_pixresolve_dict_keyrefund_pixcreate_boletoget_boletoMCP é um protocolo — qualquer framework que o fale pode montar este server.