Mcp Celcoin

io.github.codesparPublished by GitHub account codesparv0.2.4Updated Oct 24, 2026

MCP server for Celcoin — Pix, boleto, transfers, bill payments, top-ups

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server that lets an assistant run Celcoin banking operations: Pix charges and refunds, boleto issuance and payment, transfers, balance, statements…

What you can do
  • Create and inspect Pix charges, including immediate (cob) and due-date (cobv) charges with QR codes, plus Pix payments and refunds
  • Resolve Pix DICT keys to account holder and bank details
  • Issue, read and cancel boletos, and authorize then pay barcode bills
  • Create TED/DOC transfers and list Brazilian banks by ISPB code
  • Read account balance and statements for a date range
  • List telecom top-up providers and create mobile or service top-ups
When to use it
Useful when you want an assistant to handle Brazilian payment workflows through Celcoin — issuing Pix charges, paying bills by barcode, sending transfers, or checking balances and statements — especially while testing against the Celcoin sandbox.
Requirements
Runs locally via npx from the npm package, so Node.js is needed. Requires a Celcoin developer account and OAuth2 credentials in CELCOIN_CLIENT_ID and CELCOIN_CLIENT_SECRET; CELCOIN_SANDBOX=true selects the sandbox and CELCOIN_BASE_URL overrides the host. Production calls need mTLS and pre-registered IPs, so a proxy is required.
Before you install
These tools move real money: transfers, bill payments, Pix refunds and top-ups are irreversible once confirmed. Credentials are secrets and should not be shared. Production requires mTLS with a Celcoin-issued certificate and registered IPs, which this server does not present, so direct production calls fail; point CELCOIN_BASE_URL at a proxy that terminates mTLS. Test in sandbox first.

Installation

In SourceWeft

  1. Open Mcp Celcoin in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-celcoin

MCP server for Celcoin — BaaS infrastructure for Pix, boleto, transfers, and top-ups

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "celcoin": {      "command": "npx",      "args": ["-y", "@codespar/mcp-celcoin"],      "env": {        "CELCOIN_CLIENT_ID": "your-client-id",        "CELCOIN_CLIENT_SECRET": "your-client-secret",        "CELCOIN_SANDBOX": "true"      }    }  }}

Claude Code

bash
claude mcp add celcoin -- npx @codespar/mcp-celcoin

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "celcoin": {      "command": "npx",      "args": ["-y", "@codespar/mcp-celcoin"],      "env": {        "CELCOIN_CLIENT_ID": "your-client-id",        "CELCOIN_CLIENT_SECRET": "your-client-secret",        "CELCOIN_SANDBOX": "true"      }    }  }}

Tools (18)

ToolPurpose
create_pix_paymentCreate a Pix payment via Celcoin
get_pix_paymentGet Pix payment details by transaction ID
create_pix_cobCreate a Pix immediate charge (cob) — generates QR code / copia-e-cola for payer
get_pix_cobGet a Pix immediate charge by transactionId or txid
create_pix_cobvCreate a Pix due charge (cobv) — boleto-like Pix with due date
lookup_pix_dictLookup a Pix DICT key — resolves a Pix key to account holder + bank info
create_pix_devolutionCreate a Pix devolução (refund) — refund a received Pix transaction
cancel_boletoCancel a boleto issued via the bill-issuance product by id
read_barcodeAuthorize (consult) a boleto / concessionária barcode before paying — returns transactionId, amount, totalUpdated, dueDate
pay_billConfirm payment of a previously authorized bill — pass the read_barcode transactionId as transactionIdAuthorize
get_statementGet account statement (extrato) for a date range
list_topup_providersList telecom top-up providers (operadoras) available for recargas
create_boletoIssue a boleto via the bill-issuance product
get_boletoGet an issued boleto's details by id
create_transferCreate a bank transfer (TED/DOC) via Celcoin
get_balanceGet account balance at Celcoin
list_banksList available banks in Brazil (ISPB codes)
create_topupCreate a mobile/service top-up (recarga) via Celcoin

Authentication

Celcoin uses OAuth2 client credentials. The server automatically manages token refresh.

Sandbox / Testing

Celcoin provides a sandbox at sandbox.openfinance.celcoin.dev. Set CELCOIN_SANDBOX=true to use it.

Without CELCOIN_SANDBOX, the server calls Celcoin production at api.openfinance.celcoin.com.br (up to 0.2.3 the default was api-sec.celcoin.com.br, a host that does not exist). Celcoin accepts production calls only over mTLS, with a certificate Celcoin issues, and only from IPs you registered with them in advance (Celcoin docs). From any other IP the token call answers 401 "O seu IP ou certificado digital nao foi reconhecido". This server does not present a client certificate, so in production point CELCOIN_BASE_URL at a proxy that holds the certificate and terminates the mTLS; called directly, production answers that 401.

Get your credentials

  1. Go to Celcoin Documentation
  2. Create a developer account
  3. Register an application to get OAuth2 credentials
  4. Set the environment variables

Environment Variables

VariableRequiredDescription
CELCOIN_CLIENT_IDYesOAuth2 client ID
CELCOIN_CLIENT_SECRETYesOAuth2 client secret
CELCOIN_SANDBOXNoSet to "true" for sandbox mode
CELCOIN_BASE_URLNoOverride the API host. Defaults: https://api.openfinance.celcoin.com.br (production), https://sandbox.openfinance.celcoin.dev (sandbox)

Roadmap

v0.2 (planned)

  • get_pix_key — Get Pix key details (DICT lookup)
  • create_bill_payment — Create a bill/utility payment
  • get_bill_payment — Get bill payment details
  • create_scheduled_transfer — Create a scheduled transfer
  • list_providers — List available service providers

v0.3 (planned)

  • batch_topups — Process multiple mobile top-ups
  • detailed_reports — Generate detailed transaction reports

Want to contribute? Open a PR or request a tool.

Links

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

Source: packages/payments/celcoin/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.2.4LatestSep 27, 2026
  2. v0.2.3Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts