Cielo Acquirer

v0.2.0API Key

Brazil's largest card acquirer — authorization, capture, boleto, and recurrent payments on Cielo's rails. For enterprise orchestration, tokenization vault, and marketplace onboarding, use Braspag (Cielo's orchestration arm) separately.

22 tools1 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-cielo

Quickstart

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

claude_desktop_config.json

{
  "mcpServers": {
    "cielo": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-cielo"
      ],
      "env": {
        "CIELO_API_KEY": "<your_cielo_api_key>"
      }
    }
  }
}

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

Environment variables · 1

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

CIELO_API_KEY

requiredsecret

API key for cielo

Available tools · 22

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

WRITEcreate_sale

Create a credit/debit card sale in Cielo

READget_sale

Get sale details by PaymentId

WRITEcapture_sale

Capture a pre-authorized sale

DELETEcancel_sale

Cancel/void a sale (full or partial)

WRITEcreate_recurrent

Create a recurrent (recurring) credit card payment

READget_recurrent

Get recurrent payment details

WRITEtokenize_card

Tokenize a credit card for future use

WRITEcreate_boleto

Create a boleto payment in Cielo

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.