@codespar/mcp-cielo

MCP server for Cielo — card acquiring, boleto, and recurrent payments

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cielo": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-cielo"],
      "env": {
        "CIELO_MERCHANT_ID": "your-merchant-id",
        "CIELO_MERCHANT_KEY": "your-merchant-key",
        "CIELO_SANDBOX": "true"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "cielo": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-cielo"],
      "env": {
        "CIELO_MERCHANT_ID": "your-merchant-id",
        "CIELO_MERCHANT_KEY": "your-merchant-key",
        "CIELO_SANDBOX": "true"
      }
    }
  }
}

Tools (22)

| Tool | Purpose | |---|---| | create_sale | Create a credit/debit card sale in Cielo | | get_sale | Get sale details by PaymentId | | capture_sale | Capture a pre-authorized sale | | cancel_sale | Cancel/void a sale (full or partial) | | create_recurrent | Create a recurrent (recurring) credit card payment | | get_recurrent | Get recurrent payment details | | tokenize_card | Tokenize a credit card for future use | | create_boleto | Create a boleto payment in Cielo | | create_pix | Create a Pix payment in Cielo (generates QR code) | | get_pix | Get Pix payment details and QR code by PaymentId | | create_debit | Create a debit card sale in Cielo (requires 3DS authentication) | | create_ewallet | Create a digital wallet payment (Google Pay, Samsung Pay, Apple Pay) | | get_antifraud | Get anti-fraud analysis details for a payment | | create_sale_with_token | Create a credit card sale using a previously stored CardToken (avoids re-entering card data) | | update_recurrent_amount | Update the amount of an existing recurrent payment | | update_recurrent_next_date | Update the next charge date of an existing recurrent payment | | deactivate_recurrent | Deactivate (pause) a recurrent payment so it stops charging | | reactivate_recurrent | Reactivate a previously deactivated recurrent payment | | create_payment_link | Create a Cielo Link de Pagamento (shareable checkout URL) | | get_payment_link | Get a Cielo Link de Pagamento by its id | | zero_auth | Zero-dollar authorization to validate a card without charging (card or CardToken) | | create_sale_with_3ds | Create a credit card sale using 3DS 2.0 authentication data (from 3DS flow) |

Authentication

Cielo uses MerchantId and MerchantKey headers for authentication.

Sandbox / Testing

Cielo provides a sandbox at apisandbox.cieloecommerce.cielo.com.br. Set CIELO_SANDBOX=true to use it.

Get your credentials

1. Go to Cielo Developer Portal
2. Create a developer account
3. Get your MerchantId and MerchantKey
4. Set the environment variables

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CIELO_MERCHANT_ID | Yes | Merchant ID from Cielo | | CIELO_MERCHANT_KEY | Yes | Merchant Key from Cielo | | CIELO_SANDBOX | No | Set to "true" for sandbox mode |

Roadmap

v0.2 (planned)

• create_pix — Create a Pix payment
• get_pix — Get Pix payment details
• create_debit — Create a debit card payment
• create_ewallet — Create an e-wallet payment (Apple Pay, Google Pay)
• get_antifraud — Get anti-fraud analysis for a transaction

v0.3 (planned)

• batch_captures — Capture multiple pre-authorized transactions
• velocity_rules — Configure velocity/anti-fraud rules

Want to contribute? Open a PR or request a tool.

Links

• Cielo Website
• Cielo 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