# mcp-sicoob

Connects an agent to Sicoob for Pix, boleto, DICT, and account-balance operations. It fits payment workflows that need Sicoob tools through MCP.

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

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

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SICOOB_CLIENT_ID`, `SICOOB_CLIENT_SECRET`, `SICOOB_CERT_PATH`, `SICOOB_KEY_PATH`, `SICOOB_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 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-sicoob
```
Replace <…> with your own values

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- 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
- Use `create_pix_cob` to create an immediate Pix charge and return its QR data.
- Run `lookup_dict_key` for this CPF before sending the Pix.
- Check the account with `get_account_balance` and show the current balance.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

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