Skip to main content
CE

Celcoin

v0.2.1API 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

What your agent can do

Celcoin gives your agent 18 tools it calls directly β€” pick the ones it needs, in Claude, Cursor, or any MCP client.

  • 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
Example call
// Your agent calls a tool directly β€” no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_pix_payment", { /* ... */ });

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

Run `npx -y @codespar/mcp-celcoin` and add the config block above to your MCP client β€” Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Celcoin β€” MCP server Β· 18 tools | CodeSpar