io.github.codespar/mcp-celcoin MCP Server

MCP server for Celcoin, focused on BaaS infrastructure covering Pix, boleto, transfers, and top-ups. It is published as @codespar/mcp-celcoin and distributed under the MIT license, with npm availability for developer installation and configuration.

🛠️ Key Features

Celcoin BaaS for Pix
Boleto support
Transfers
Bill payments and top-ups
Tagged for model-context-protocol (MCP) and payments workflows

🚀 Use Cases

Integrate Pix payments into LLM-enabled applications
Handle boleto transactions and related payment flows
Execute or orchestrate transfers
Perform top-ups and bill payment actions via Celcoin services

⚡ Developer Benefits

Works with MCP via supported tooling (model context protocol)
Installable from npm (@codespar/mcp-celcoin)
Open source under MIT license

⚠️ Limitations

Provided excerpt includes quick-start configuration context for Claude Desktop, but does not describe specific MCP tools or capabilities beyond payment-related domains.

@codespar/mcp-celcoin

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

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)

Tool	Purpose
`create_pix_payment`	Create a Pix payment via Celcoin
`get_pix_payment`	Get Pix payment details by transaction ID
`create_pix_cob`	Create a Pix immediate charge (cob) — generates QR code / copia-e-cola for payer
`get_pix_cob`	Get a Pix immediate charge by transactionId or txid
`create_pix_cobv`	Create a Pix due charge (cobv) — boleto-like Pix with due date
`lookup_pix_dict`	Lookup a Pix DICT key — resolves a Pix key to account holder + bank info
`create_pix_devolution`	Create a Pix devolução (refund) — refund a received Pix transaction
`cancel_boleto`	Cancel a boleto issued via the bill-issuance product by id
`read_barcode`	Authorize (consult) a boleto / concessionária barcode before paying — returns transactionId, amount, totalUpdated, dueDate
`pay_bill`	Confirm payment of a previously authorized bill — pass the read_barcode transactionId as transactionIdAuthorize
`get_statement`	Get account statement (extrato) for a date range
`list_topup_providers`	List telecom top-up providers (operadoras) available for recargas
`create_boleto`	Issue a boleto via the bill-issuance product
`get_boleto`	Get an issued boleto's details by id
`create_transfer`	Create a bank transfer (TED/DOC) via Celcoin
`get_balance`	Get account balance at Celcoin
`list_banks`	List available banks in Brazil (ISPB codes)
`create_topup`	Create 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.

Get your credentials

Go to Celcoin Documentation
Create a developer account
Register an application to get OAuth2 credentials
Set the environment variables

Environment Variables

Variable	Required	Description
`CELCOIN_CLIENT_ID`	Yes	OAuth2 client ID
`CELCOIN_CLIENT_SECRET`	Yes	OAuth2 client secret
`CELCOIN_SANDBOX`	No	Set to `"true"` for sandbox mode

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.

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

io.github.codespar/mcp-celcoin