Rede de banco cooperativo do BR — top 4 em volume de Pix. Pix imediato + cobv, DICT, boleto, saldo de conta. OAuth2 + mTLS. Alpha — developers.sicoob.com.br fechado por contrato.
O Sicoob dá ao seu agente 13 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 Sicoob Developers Portal. Exposed so agents can inspect token freshness; normal tool calls obtain tokens implicitly.create_pix_cob — Create an immediate Pix charge (cob) with QR code. Returns the txid, copy-paste EMV payload, and location URL.get_pix_cob — Retrieve an immediate Pix charge by its txid.// 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-sicoob@alphaAdicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).
{
"mcpServers": {
"sicoob": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-sicoob@alpha"
],
"env": {
"SICOOB_CLIENT_ID": "<your_sicoob_client_id>",
"SICOOB_CLIENT_SECRET": "<your_sicoob_client_secret>",
"SICOOB_CERT_PATH": "<your_sicoob_cert_path>",
"SICOOB_KEY_PATH": "<your_sicoob_key_path>"
}
}
}
}Depois de reiniciar, seu agente pode chamar qualquer uma das 13 ferramentas abaixo — teste get_oauth_token primeiro.
Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.
SICOOB_CLIENT_IDSicoob OAuth client_id issued via the Developers Portal after cooperative onboarding.
SICOOB_CLIENT_SECRETSicoob OAuth client_secret.
SICOOB_CERT_PATHAbsolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2.
SICOOB_KEY_PATHAbsolute path to the mTLS private key (.key or .pem).
SICOOB_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_tokencreate_pix_cobget_pix_coblist_pix_cobcreate_pix_cobvget_pix_cobvlookup_dict_keyregister_dict_keyMCP é um protocolo — qualquer framework que o fale pode montar este server.