Sicoob

v0.1.0-alpha.1OAuth2alpha

BR cooperative bank network — top 4 in Pix volume. Pix immediate + cobv, DICT, boleto, account balance. OAuth2 + mTLS. Alpha — developers.sicoob.com.br contract-gated.

13 tools5 env vars🇧🇷 Brazilalpha — pending validation

Install

terminal

$ npm install @codespar/mcp-sicoob@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "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>"
      }
    }
  }
}

After restart, your agent can call any of the 13 tools below — try get_oauth_token first.

Environment variables · 5

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

SICOOB_CLIENT_ID

required

Sicoob OAuth client_id issued via the Developers Portal after cooperative onboarding.

SICOOB_CLIENT_SECRET

requiredsecret

Sicoob OAuth client_secret.

SICOOB_CERT_PATH

required

Absolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2.

SICOOB_KEY_PATH

requiredsecret

Absolute path to the mTLS private key (.key or .pem).

SICOOB_ENV

optional

Environment: 'sandbox' or 'production'. Defaults to 'sandbox'.

Available tools · 13

Each tool is independent — your agent loads only what it needs to reduce context and response time.

READget_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.

WRITEcreate_pix_cob

Create an immediate Pix charge (cob) with QR code. Returns the txid, copy-paste EMV payload, and location URL.

READget_pix_cob

Retrieve an immediate Pix charge by its txid.

READlist_pix_cob

List immediate Pix charges (cob) registered by the merchant within a date range. Paginated per BACEN Pix v2.

WRITEcreate_pix_cobv

Create a Pix charge with due date (cobv) — boleto-like Pix payable on or after a due date with optional fine/interest/discount. Returns txid, copy-paste EMV payload, and location URL.

READget_pix_cobv

Retrieve a due-date Pix charge (cobv) by its txid.

READlookup_dict_key

Resolve a DICT key (CPF, CNPJ, email, phone, EVP) to the owner's account data before sending a Pix. Subject to BCB rate limits per consenting payer.

WRITEregister_dict_key

Register a DICT key (CPF, CNPJ, email, phone, or EVP) on a Sicoob account owned by the cooperative member. Subject to BCB validation flows (e.g. email/SMS confirmation for email/phone keys).

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.