@codespar/mcp-cielo

@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

Tool	Description
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

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

• Go to Cielo Developer Portal
• Create a developer account
• Get your MerchantId and MerchantKey
• 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