@codespar/mcp-celcoin

@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:

{
  "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

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

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.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

Tool	Description
create_pix_payment	Create a Pix payment via Celcoin
get_pix_payment	Get Pix payment details by transaction ID
create_boleto	Create a boleto payment via Celcoin
get_boleto	Get boleto details by transaction 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-api.celcoin.com.br. 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.

Links

• Celcoin Website
• Celcoin API Documentation
• MCP Dev Brasil
• Landing Page

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