{"_id":"@codespar/mcp-sicoob","_rev":"5-e099218f9027bccdf2c8474bdcdfa0f4","name":"@codespar/mcp-sicoob","dist-tags":{"alpha":"0.1.0-alpha.2","latest":"0.1.0-alpha.4"},"versions":{"0.1.0-alpha.1":{"name":"@codespar/mcp-sicoob","version":"0.1.0-alpha.1","keywords":["mcp","sicoob","banking","cooperative","pix","boleto","cobranca","spb","brazil"],"license":"MIT","_id":"@codespar/mcp-sicoob@0.1.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-sicoob":"dist/index.js"},"dist":{"shasum":"5e7aaa7ea04b3c9990935fe09544e4c1592da67c","tarball":"https://registry.npmjs.org/@codespar/mcp-sicoob/-/mcp-sicoob-0.1.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-OWUEhsTYg9u97+iLFN3LYKjpDDcXqao1qOEX/PO1OvrvpTx0+E8zofp02Au2SrASIuFnFjK1tWv/ntepm/f/1Q==","signatures":[{"sig":"MEUCIQCM/F+G6W8tFXjKmxeFyuZOjJLSs88fpLMiJPgJoZOljQIgDZUJK3yU7LWnaefaTpHISE6lt0eujRp47layxmlvM+c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61445},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"abceab06a74a933da6920cfb3b1735adcf271566","mcpName":"io.github.codespar/sicoob","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Sicoob — Brazil's largest cooperative bank network (top 4 in Pix volume). Pix (cob, cobv, DICT), Cobrança (boleto), and SPB via Sicoob's Developers Portal APIs (OAuth2 + mTLS).","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-sicoob_0.1.0-alpha.1_1777119846881_0.919360488860008","host":"s3://npm-registry-packages-npm-production"}},"0.1.0-alpha.2":{"name":"@codespar/mcp-sicoob","version":"0.1.0-alpha.2","keywords":["mcp","sicoob","banking","cooperative","pix","boleto","cobranca","spb","brazil"],"license":"MIT","_id":"@codespar/mcp-sicoob@0.1.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-sicoob":"dist/index.js"},"dist":{"shasum":"25ea543dcda895963314a1d7fe3186cb16a587ad","tarball":"https://registry.npmjs.org/@codespar/mcp-sicoob/-/mcp-sicoob-0.1.0-alpha.2.tgz","fileCount":6,"integrity":"sha512-oX/qeBFvd11A0by/TXKZ0exQuFg6kywJnlqwAfCrtnUiIWN7fnYivmp1x6n3IEQUutgJUcSzD2Zhq5O3g3mVxw==","signatures":[{"sig":"MEQCIAcll7ph6dlL5oxq1bfBT1rzDjxUgeIv60X2ReWLVariAiBjI3BVydl72LrBKtKzMT4lTXhx96R4UnooGhV/JKaTXA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61922},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b8f7e5b70db9046319ed757225e0eae8f2dc4451","mcpName":"io.github.codespar/sicoob","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Sicoob — Brazil's largest cooperative bank network (top 4 in Pix volume). Pix (cob, cobv, DICT), Cobrança (boleto), and SPB via Sicoob's Developers Portal APIs (OAuth2 + mTLS).","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-sicoob_0.1.0-alpha.2_1777122942329_0.4553903429285846","host":"s3://npm-registry-packages-npm-production"}},"0.1.0-alpha.3":{"name":"@codespar/mcp-sicoob","version":"0.1.0-alpha.3","keywords":["mcp","sicoob","banking","cooperative","pix","boleto","cobranca","spb","brazil"],"license":"MIT","_id":"@codespar/mcp-sicoob@0.1.0-alpha.3","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"bin":{"mcp-sicoob":"dist/index.js"},"dist":{"shasum":"45839f2e892e5f7a5c1ee638b3cb8dad8f30706c","tarball":"https://registry.npmjs.org/@codespar/mcp-sicoob/-/mcp-sicoob-0.1.0-alpha.3.tgz","fileCount":6,"integrity":"sha512-C0kU5odchh1j5mPPt+4TuWzLke/7xtxos9rKdpUVUHQa/CQ65ieqszZbg7LAVBTRB2qYTyO+PLIvXT/7Gt6uBg==","signatures":[{"sig":"MEUCIQCESNFFPntPNmJPJNZHkCQODgSlSwW0VbJhd2PP1MmZvwIgaWHgIqQqmS0r8AKbErNPSaSUWZtDJVQ/IXjCSf4t4iw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62353},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"a121ea567035fa095d42b603f244273e3a34cc90","mcpName":"io.github.codespar/mcp-sicoob","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"10.9.8","description":"MCP server for Sicoob — Brazil's largest cooperative bank network (top 4 in Pix volume). Pix (cob, cobv, DICT), Cobrança (boleto), and SPB via Sicoob's Developers Portal APIs (OAuth2 + mTLS).","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-sicoob_0.1.0-alpha.3_1781995347037_0.753072291763752","host":"s3://npm-registry-packages-npm-production"}},"0.1.0-alpha.4":{"name":"@codespar/mcp-sicoob","version":"0.1.0-alpha.4","description":"MCP server for Sicoob — Brazil's largest cooperative bank network (top 4 in Pix volume). Pix (cob, cobv, DICT), Cobrança (boleto), and SPB via Sicoob's Developers Portal APIs (OAuth2 + mTLS).","type":"module","main":"./dist/index.js","bin":{"mcp-sicoob":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","sicoob","banking","cooperative","pix","boleto","cobranca","spb","brazil"],"mcpName":"io.github.codespar/mcp-sicoob","_id":"@codespar/mcp-sicoob@0.1.0-alpha.4","gitHead":"8e115a5cb8aed75e812af698b03aa996ccd8d7c1","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-qBTs7+1bzh837T36MFg8TXyro0DObjGHbRMdquAasN1JylnS4lZYSJ3HHWOwpLn6GvHqii4BWoieQ8+dMZ8G7A==","shasum":"41f69676f14ef76e3a8f3029ae541c279e6fe534","tarball":"https://registry.npmjs.org/@codespar/mcp-sicoob/-/mcp-sicoob-0.1.0-alpha.4.tgz","fileCount":6,"unpackedSize":63328,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCMxGJB2wHAJ8uwsCiVOe+O4bgKIxMDd+vC8khziUGBWAIgU0NVNKKwgIq5/PsgdwzwZDuTBm0aC5Gz9+1cDWRNlDs="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-sicoob_0.1.0-alpha.4_1782158096633_0.2846554012189053"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-25T12:24:06.829Z","modified":"2026-06-22T19:54:56.946Z","0.1.0-alpha.1":"2026-04-25T12:24:07.064Z","0.1.0-alpha.2":"2026-04-25T13:15:42.461Z","0.1.0-alpha.3":"2026-06-20T22:42:27.187Z","0.1.0-alpha.4":"2026-06-22T19:54:56.789Z"},"license":"MIT","keywords":["mcp","sicoob","banking","cooperative","pix","boleto","cobranca","spb","brazil"],"description":"MCP server for Sicoob — Brazil's largest cooperative bank network (top 4 in Pix volume). Pix (cob, cobv, DICT), Cobrança (boleto), and SPB via Sicoob's Developers Portal APIs (OAuth2 + mTLS).","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-sicoob\n\nMCP server for [Sicoob](https://developers.sicoob.com.br) — Brazil's largest cooperative bank network.\n\nSicoob is consistently a top-4 PSP by Pix volume in Brazil. The Sistema de Cooperativas de Crédito do Brasil aggregates hundreds of regional cooperatives behind a single Developers Portal exposing Pix, Cobrança (boleto), and SPB APIs.\n\n## Status: alpha (`0.1.0-alpha.1`)\n\nSicoob's Developers Portal is gated by cooperative onboarding. The endpoint paths in this server are best-guesses based on (a) BACEN Pix v2 standard paths, (b) Sicoob's public documentation snippets, and (c) conventions shared across Itaú / Bradesco / BB. Every unverified path is flagged `TODO(verify)` in the source.\n\nPin to exact versions during `0.1.x`; paths will be corrected to match the portal spec once an onboarded cooperative member can validate.\n\n## Tools (13)\n\n| Tool | Purpose |\n|---|---|\n| `get_oauth_token` | Mint or return a cached OAuth2 client_credentials bearer token for the Sicoob Developers Portal. |\n| `create_pix_cob` | Create an immediate Pix charge (cob) with QR code. |\n| `get_pix_cob` | Retrieve an immediate Pix charge by its txid. |\n| `list_pix_cob` | List immediate Pix charges (cob) registered by the merchant within a date range. |\n| `create_pix_cobv` | Create a Pix charge with due date (cobv) — boleto-like Pix payable on or after a due date with optional fin... |\n| `get_pix_cobv` | Retrieve a due-date Pix charge (cobv) by its txid. |\n| `lookup_dict_key` | Resolve a DICT key (CPF, CNPJ, email, phone, EVP) to the owner's account data before sending a Pix. |\n| `register_dict_key` | Register a DICT key (CPF, CNPJ, email, phone, or EVP) on a Sicoob account owned by the cooperative member. |\n| `delete_dict_key` | Delete a DICT key owned by the cooperative member. |\n| `create_boleto` | Issue a boleto via Sicoob Cobrança. |\n| `get_boleto` | Retrieve a boleto by its Sicoob identifier (id or nosso_numero). |\n| `cancel_boleto` | Cancel (baixa) an outstanding boleto before payment. |\n| `get_account_balance` | Query the merchant cooperative account balance via Sicoob SPB. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-sicoob@0.1.0-alpha.1\n```\n\n## Environment\n\n```bash\nSICOOB_CLIENT_ID=\"...\"       # OAuth client_id from Sicoob's Developers Portal\nSICOOB_CLIENT_SECRET=\"...\"   # OAuth client_secret\nSICOOB_CERT_PATH=\"/abs/path/to/client.crt\"   # mTLS client certificate\nSICOOB_KEY_PATH=\"/abs/path/to/client.key\"    # mTLS private key\nSICOOB_ENV=\"sandbox\"                          # or \"production\" (default: sandbox)\n```\n\n## Authentication\n\nTwo factors are **both** required on every call:\n\n1. **OAuth2 `client_credentials`** — the server calls the token endpoint, caches the bearer until ~60s before expiry, and attaches `Authorization: Bearer <token>` to downstream calls.\n2. **mTLS** — BACEN mandates mutual TLS for Pix v2, and Sicoob enforces it across product families. The server loads the client certificate and private key from the paths you set, builds a Node `https.Agent`, and routes every request through it.\n\nThe cert + key bundle is issued by Sicoob's Developers Portal after cooperative onboarding and is distinct from the OAuth credentials.\n\n## Run\n\n```bash\n# stdio (default)\nnpx @codespar/mcp-sicoob\n\n# HTTP transport\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-sicoob\n```\n\n## Caveats\n\n- **Paths are unverified.** See the `TODO(verify)` markers in `src/index.ts`. Onboarded cooperatives should validate against their portal-issued OpenAPI spec and open a PR.\n- **Sandbox host is a guess.** Sicoob issues a sandbox subdomain per cooperative; override by editing `BASE_URL` if your provisioned sandbox URL differs.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}