io.github.codespar/mcp-sicoob

NPM · @CODESPAR/MCP-SICOOB · SCANNED AUG 4

MCP server for Sicoob — Pix (cob/cobv/DICT), Cobrança (boleto), SPB (OAuth2 + mTLS)

Available components

+45 this week 69 69 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security86

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 42 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability75

AI-judged instruction clarity (good).Pass
Tool/resource definitions use about 1334 tokens (~102/item across 13 items; 13 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management30

Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @codespar/mcp-sicoob

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add codespar-mcp-sicoob -- npx -y @codespar/mcp-sicoob

# add to Codex CLI

codex mcp add codespar-mcp-sicoob -- npx -y @codespar/mcp-sicoob

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "codespar-mcp-sicoob": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@codespar/mcp-sicoob"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add codespar-mcp-sicoob --command npx --arg -y --arg @codespar/mcp-sicoob

# ~/.hermes/config.yaml

mcp_servers:
  codespar-mcp-sicoob:
    command: "npx"
    args: ["-y", "@codespar/mcp-sicoob"]

// mcp.json

{
  "mcpServers": {
    "codespar-mcp-sicoob": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-sicoob"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
2 Aug 26 +47
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Schema quality: unverified → good ▲ functional
- Licence: MIT functional
31 Jul 26 −25
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 +22
- Tool coverage: unverified → 100 ▲ functional
28 Jul 26 −22
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
27 Jul 26 46

First indexed and scored.

Show 4 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Aug 2026 · Analysed npm/@codespar/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 13 exposed · ~1,267 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

cancel_boleto ~47

Cancel (baixa) an outstanding boleto before payment.

Input Output Examples

Name	Type	Req	Description
id	string	yes	Boleto id or nosso_numero
reason	string	—	Cancellation reason code or free text

No output schema declared.

No examples provided.

create_boleto ~189

Issue a boleto via Sicoob Cobrança. Returns nosso_numero, linha_digitável, barcode, and PDF URL.

Input Output Examples

Name	Type	Req	Description
amount	string	yes	Amount in BRL major units, e.g. '150.00'
contract_number	string	—	Sicoob cobrança contract number (numeroContrato) issued at onboarding
due_date	string	yes	Due date ISO-8601 (YYYY-MM-DD)
fine	object	—	Multa (fine after due date): { percentage?, amount?, days_after_due? }
instructions	array	—	Free-text instructions printed on the boleto
interest	object	—	Juros (daily interest after due date): { percentage?, amount? }
our_number	string	—	Nosso_numero. Omit to have Sicoob assign one.
payer	object	yes	Payer (sacado) data

No output schema declared.

No examples provided.

create_pix_cob ~158

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

Input Output Examples

Name	Type	Req	Description
additional_info	array	—	Optional free-text key/value info shown to the payer
amount	string	yes	Amount in BRL major units, e.g. '99.90'
description	string	—	Payer-visible description (solicitacaoPagador)
expires_in	number	—	QR lifetime in seconds (default 3600)
payer	object	—	Payer identification (optional for cob)
txid	string	—	Optional merchant-supplied txid (26-35 alphanumeric chars). Omit to have Sicoob assign one.

No output schema declared.

No examples provided.

create_pix_cobv ~225

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.

Input Output Examples

Name	Type	Req	Description
amount	string	yes	Original amount in BRL major units, e.g. '250.00'
description	string	—	Payer-visible description
discount	object	—	Desconto up to due date: { percentage?, amount? }
due_date	string	yes	Due date ISO-8601 (YYYY-MM-DD)
fine	object	—	Multa after due date: { percentage?, amount? }
interest	object	—	Juros (daily) after due date: { percentage?, amount? }
payer	object	yes	Payer identification (required for cobv)
txid	string	—	Optional merchant-supplied txid (26-35 alphanumeric chars)
validity_after_due_days	number	—	Days after due date the Pix remains payable (default 30)

No output schema declared.

No examples provided.

delete_dict_key ~54

Delete a DICT key owned by the cooperative member. Irreversible — the key becomes available for re-registration by any PSP after BCB lockout window.

Input Output Examples

Name	Type	Req	Description
key	string	yes	DICT key value to delete

No output schema declared.

No examples provided.

get_account_balance ~52

Query the merchant cooperative account balance via Sicoob SPB. Returns available, blocked, and overdraft (limite) figures.

Input Output Examples

Name	Type	Req	Description
account	string	yes	Agência-conta identifier of the cooperative member account

No output schema declared.

No examples provided.

get_boleto ~39

Retrieve a boleto by its Sicoob identifier (id or nosso_numero).

Input Output Examples

Name	Type	Req	Description
id	string	yes	Boleto id or nosso_numero

No output schema declared.

No examples provided.

get_oauth_token ~45

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_pix_cob ~39

Retrieve an immediate Pix charge by its txid.

Input Output Examples

Name	Type	Req	Description
txid	string	yes	Pix charge txid (26-35 alphanumeric chars)

No output schema declared.

No examples provided.

get_pix_cobv ~39

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

Input Output Examples

Name	Type	Req	Description
txid	string	yes	Pix charge txid

No output schema declared.

No examples provided.

list_pix_cob ~170

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

Input Output Examples

Name	Type	Req	Description
cnpj	string	—	Optional payer CNPJ filter (digits only)
cpf	string	—	Optional payer CPF filter (digits only)
from	string	yes	Start date-time ISO-8601 (inicio)
page	number	—	Page number (paginacao.paginaAtual)
page_size	number	—	Items per page (paginacao.itensPorPagina)
status	string	—	Optional status filter: ATIVA \| CONCLUIDA \| REMOVIDA_PELO_USUARIO_RECEBEDOR \| REMOVIDA_PELO_PSP
to	string	yes	End date-time ISO-8601 (fim)

No output schema declared.

No examples provided.

lookup_dict_key ~93

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.

Input Output Examples

Name	Type	Req	Description
key	string	yes	DICT key — CPF, CNPJ, email, phone (+55...), or EVP UUID
payer_document	string	—	Cooperative member / end-payer CPF/CNPJ for BCB audit logging

No output schema declared.

No examples provided.

register_dict_key ~117

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

Input Output Examples

Name	Type	Req	Description
account	object	yes	Account to bind the key to
key	string	—	The key value. Omit for EVP (Sicoob generates the UUID).
key_type	string	yes	DICT key type: CPF \| CNPJ \| EMAIL \| PHONE \| EVP

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 4 Aug

Day	Score
27 Jul	46
28 Jul	24
30 Jul	46
31 Jul	21
1 Aug	21
2 Aug	68
3 Aug	69
4 Aug	69