mcp-sicoob — Claude Code MCP server: what it does and setup
Connects an agent to Sicoob for Pix, boleto, DICT, and account-balance operations. It fits payment workflows that need Sicoob tools through MCP.
claude mcp add --env SICOOB_CLIENT_ID=<SICOOB_CLIENT_ID> --env SICOOB_CLIENT_SECRET=<SICOOB_CLIENT_SECRET> --env SICOOB_CERT_PATH=<SICOOB_CERT_PATH> --env SICOOB_KEY_PATH=<SICOOB_KEY_PATH> --env SICOOB_ENV=<SICOOB_ENV> --transport stdio sicoob -- npx -y @codespar/mcp-sicoobWhat mcp-sicoob does
mcp-sicoob exposes Sicoob actions for immediate Pix charges, due-date Pix charges, DICT key lookups, boleto issuance and cancellation, and balance checks. The server also retrieves charges by transaction or Sicoob identifiers and can register or remove DICT keys.
Authentication combines OAuth2 client credentials with mutual TLS. OAuth tokens are cached briefly before expiry, while requests use the client certificate and private key configured through environment variables. Set SICOOB_CLIENT_ID, SICOOB_CLIENT_SECRET, SICOOB_CERT_PATH, SICOOB_KEY_PATH, and choose sandbox or production with SICOOB_ENV.
This package is alpha software, and its API paths still need validation against the cooperative’s OpenAPI specification. That means some calls can fail until the paths match the portal provisioned for the cooperative.
What it helps with
- create an immediate Pix charge with QR data
- resolve a DICT key before sending Pix
- issue or cancel a Sicoob boleto
- read the merchant account balance
Example prompts for the agent
- Use
create_pix_cobto create an immediate Pix charge and return its QR data. - Run
lookup_dict_keyfor this CPF before sending the Pix. - Check the account with
get_account_balanceand show the current balance.
How to install mcp-sicoob
Platform CLI
claude mcp add --env SICOOB_CLIENT_ID=<SICOOB_CLIENT_ID> --env SICOOB_CLIENT_SECRET=<SICOOB_CLIENT_SECRET> --env SICOOB_CERT_PATH=<SICOOB_CERT_PATH> --env SICOOB_KEY_PATH=<SICOOB_KEY_PATH> --env SICOOB_ENV=<SICOOB_ENV> --transport stdio sicoob -- npx -y @codespar/mcp-sicoobReplace <…> with your own values
Platform CLI
codex mcp add sicoob --env SICOOB_CLIENT_ID=<SICOOB_CLIENT_ID> --env SICOOB_CLIENT_SECRET=<SICOOB_CLIENT_SECRET> --env SICOOB_CERT_PATH=<SICOOB_CERT_PATH> --env SICOOB_KEY_PATH=<SICOOB_KEY_PATH> --env SICOOB_ENV=<SICOOB_ENV> -- npx -y @codespar/mcp-sicoobReplace <…> with your own values
Config file
{
"mcpServers": {
"sicoob": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-sicoob"
],
"env": {
"SICOOB_CLIENT_ID": "<SICOOB_CLIENT_ID>",
"SICOOB_CLIENT_SECRET": "<SICOOB_CLIENT_SECRET>",
"SICOOB_CERT_PATH": "<SICOOB_CERT_PATH>",
"SICOOB_KEY_PATH": "<SICOOB_KEY_PATH>",
"SICOOB_ENV": "<SICOOB_ENV>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"sicoob": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-sicoob"
],
"env": {
"SICOOB_CLIENT_ID": "<SICOOB_CLIENT_ID>",
"SICOOB_CLIENT_SECRET": "<SICOOB_CLIENT_SECRET>",
"SICOOB_CERT_PATH": "<SICOOB_CERT_PATH>",
"SICOOB_KEY_PATH": "<SICOOB_KEY_PATH>",
"SICOOB_ENV": "<SICOOB_ENV>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e SICOOB_CLIENT_ID=<SICOOB_CLIENT_ID> -e SICOOB_CLIENT_SECRET=<SICOOB_CLIENT_SECRET> -e SICOOB_CERT_PATH=<SICOOB_CERT_PATH> -e SICOOB_KEY_PATH=<SICOOB_KEY_PATH> -e SICOOB_ENV=<SICOOB_ENV> sicoob npx -y @codespar/mcp-sicoobReplace <…> 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-sicoob
How do I install mcp-sicoob in Claude Code?
Run `claude mcp add mcp-sicoob -e SICOOB_CLIENT_ID=<SICOOB_CLIENT_ID> -e SICOOB_CLIENT_SECRET=<SICOOB_CLIENT_SECRET> -e SICOOB_CERT_PATH=<SICOOB_CERT_PATH> -e SICOOB_KEY_PATH=<SICOOB_KEY_PATH> -- npx -y @codespar/mcp-sicoob`.
What does mcp-sicoob do?
It gives an agent Sicoob tools for Pix charges, DICT keys, boletos, and account balances. Calls use OAuth2 together with mutual TLS.
What credentials are required?
You need the Sicoob OAuth client ID and secret plus a client certificate and private key from the Developers Portal after cooperative onboarding. Both OAuth2 and mTLS are required for calls.
