Celcoin

v0.2.0API Key

Pix, boleto, TED, bill payments, and mobile top-ups. Your agent processes utility payments and moves funds across Brazilian banks.

18 tools1 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-celcoin

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "celcoin": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-celcoin"
      ],
      "env": {
        "CELCOIN_CLIENT_SECRET": "<your_celcoin_client_secret>"
      }
    }
  }
}

After restart, your agent can call any of the 18 tools below — try create_pix_payment first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

CELCOIN_CLIENT_SECRET

requiredsecret

API key for celcoin

Available tools · 18

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEcreate_pix_payment

Create a Pix payment via Celcoin

WRITEget_pix_payment

Get Pix payment details by transaction ID

WRITEcreate_pix_cob

Create a Pix immediate charge (cob) — generates QR code / copia-e-cola for payer

READget_pix_cob

Get a Pix immediate charge by transactionId or txid

WRITEcreate_pix_cobv

Create a Pix due charge (cobv) — boleto-like Pix with due date

READlookup_pix_dict

Lookup a Pix DICT key — resolves a Pix key to account holder + bank info

WRITEcreate_pix_devolution

Create a Pix devolução (refund) — refund a received Pix transaction

DELETEcancel_boleto

Cancel an issued boleto by transactionId

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.