@codespar/mcp-c6
MCP server for C6 Bank — a top Brazilian digital bank, JPMorgan-backed.
C6 ranks among the largest Brazilian digital banks by retail account base and has expanded aggressively into SMB and corporate banking. Merchants integrate directly for Pix, boleto, and account-data flows.
Status: alpha (0.1.0-alpha.1)
C6's Developer Portal is contract-gated — full OpenAPI specs for Pix, Cobrança, and account APIs are only visible to onboarded merchants. The endpoint paths in this server are best-guesses based on (a) the BACEN Pix v2 standard, (b) C6's public marketing pages, and (c) conventions shared across Itaú / Santander / Bradesco. Every unverified path is flagged TODO(verify) in the source.
Pin to exact versions during 0.1.x; paths will be corrected to match the portal spec once an onboarded merchant can validate.
| Tool | Purpose |
|---|
get_oauth_token | Mint or return a cached OAuth2 client_credentials bearer token for the C6 Developer Portal. |
create_pix_cob | Create a Pix immediate charge (cob) with QR code. |
get_pix_cob | Retrieve a Pix immediate charge (cob) by its txid. |
list_pix_cob | List Pix immediate charges (cob) registered by the merchant within a date range. |
create_pix_cobv | Create a Pix charge with due date (cobv) — used for boleto-like Pix where the payer can pay at or after a d... |
get_pix_cobv | Retrieve a Pix due-date charge (cobv) by its txid. |
resolve_dict_key | Resolve a DICT key (CPF, CNPJ, email, phone, EVP) to the owner's account data before sending a Pix. |
register_pix_key | Register a DICT key (CPF, CNPJ, email, phone, or EVP) on a C6 account owned by the merchant. |
delete_pix_key | Delete a DICT key owned by the merchant. |
create_boleto | Issue a boleto via C6 Cobrança. |
get_boleto | Retrieve a boleto by its C6 identifier (id or nosso_numero). |
cancel_boleto | Cancel (baixa) an outstanding boleto before payment. |
get_account_balance | Retrieve the current balance snapshot for a merchant account. |
get_statement | Retrieve account statement transactions for a given period. |
Install
npm install @codespar/mcp-c6@0.1.0-alpha.1
Environment
C6_CLIENT_ID="..."
C6_CLIENT_SECRET="..."
C6_CERT_PATH="/abs/path/to/client.crt"
C6_KEY_PATH="/abs/path/to/client.key"
C6_ENV="sandbox"
Authentication
Two factors are both required on every call:
- OAuth2
client_credentials — the server calls the token endpoint, caches the bearer until ~60s before expiry, and attaches Authorization: Bearer <token> to downstream calls.
- mTLS — BACEN mandates mutual TLS for Pix v2, and C6 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.
You obtain the cert + key bundle from the C6 Developer Portal after your merchant contract is signed.
Run
Caveats
- Paths are unverified. See the
TODO(verify) markers in src/index.ts. Onboarded merchants should validate against their portal-issued OpenAPI spec and open a PR.
- Sandbox host is a guess. C6 issues a sandbox subdomain per merchant; override by editing
BASE_URL if your provisioned sandbox URL differs.
Enterprise
Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
License
MIT