Cielo MCP Server

Cielo uses MerchantId and MerchantKey headers for authentication. br. Set CIELO_SANDBOX=true to use it. Its 22 documented tools cover sale, recurrent, pix, with.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Cielo

before you install - you'll need

Set CIELO_MERCHANT_ID, CIELO_MERCHANT_KEY, CIELO_SANDBOX before connecting.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-cielo

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-cielo"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-cielo - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Cielo can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a credit/debit card sale in Cielo, get sale details by PaymentId, capture a pre-authorized sale, and create a recurrent (recurring) credit card payment.

Capability map

Tools grouped from the project's README - what Cielo lets an agent do.

Sale

6 tools - e.g. Create a credit/debit card sale in Cielo; Get sale details by PaymentId; Capture a pre-authorized sale

create_sale · get_sale · capture_sale · cancel_sale · create_sale_with_token · create_sale_with_3ds

Recurrent

6 tools - e.g. Create a recurrent (recurring) credit card payment; Get recurrent payment details; Update the amount of an existing recurrent payment

create_recurrent · get_recurrent · update_recurrent_amount · update_recurrent_next_date · deactivate_recurrent · reactivate_recurrent

create & write

3 tools - e.g. Create a boleto payment in Cielo; Create a debit card sale in Cielo (requires 3DS authentication); Create a digital wallet payment (Google Pay, Samsung Pay, Apple Pay)

create_boleto · create_debit · create_ewallet

auth & access

2 tools - e.g. Tokenize a credit card for future use; Zero-dollar authorization to validate a card without charging (card or CardToken)

tokenize_card · zero_auth

Pix

2 tools - e.g. Create a Pix payment in Cielo (generates QR code); Get Pix payment details and QR code by PaymentId

create_pix · get_pix

Payment

2 tools - e.g. Create a Cielo Link de Pagamento (shareable checkout URL); Get a Cielo Link de Pagamento by its id

create_payment_link · get_payment_link

read & search

1 tool - e.g. Get anti-fraud analysis details for a payment

get_antifraud

04 · Who maintains Cielo

mcp-cielo is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: finance - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-cielo (active, first published 2026-04-12 · 3 versions)
packages: npm:@codespar/mcp-cielo

06 · Cielo FAQ

Is Cielo still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Cielo do?

How do I install Cielo?

Run `npx -y @codespar/mcp-cielo`. The README documents 3 environment variables (CIELO_MERCHANT_ID, CIELO_MERCHANT_KEY, CIELO_SANDBOX) to set first. Set CIELO_MERCHANT_ID, CIELO_MERCHANT_KEY, CIELO_SANDBOX before connecting. You can also paste the ready-made client config above.

Does Cielo run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Cielo

Alternatives to Cielo

Maintained finance servers if Cielo isn't the fit.

Pairs well with

Servers that cover what Cielo doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Dlocal · Ebanx · Flow Cl · Iugu · Khipu

More JavaScript MCP servers · Culqi · Efi · see all