{"_id":"@codespar/mcp-cielo","_rev":"6-a34e6e4ea0ed52dc671bd2aa73aff013","name":"@codespar/mcp-cielo","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-cielo","version":"0.1.0","keywords":["mcp","cielo","payments","credit-card","boleto","brazil"],"license":"MIT","_id":"@codespar/mcp-cielo@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-cielo":"dist/index.js"},"dist":{"shasum":"2659ecf24945b1ddd799984bc1609745d99aed84","tarball":"https://registry.npmjs.org/@codespar/mcp-cielo/-/mcp-cielo-0.1.0.tgz","fileCount":4,"integrity":"sha512-afajvv+5IGAMOOIutML+sCGLUXVkJ08YFTOUhOR0ieSng/XCea9LeiIxcgvABZPTuXdr6IuhgIsUt9intsUvVw==","signatures":[{"sig":"MEYCIQCuGIE8QbADtI3mTI0jgXhUTFtS82uQ9dTEmVprMzWuxwIhAMGNbfnFQiMvLJCInE7lCFuMdW5OCT44gB10IMngBDkX","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26877},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ac49d04d5aa50ad5dc16233f0bba88213f917641","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Cielo — credit card, debit, boleto, recurrent payments","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-cielo_0.1.0_1774923293079_0.6442044359293473","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-cielo","version":"0.1.2","keywords":["mcp","cielo","payments","credit-card","boleto","brazil"],"license":"MIT","_id":"@codespar/mcp-cielo@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-cielo":"dist/index.js"},"dist":{"shasum":"1fff8919115851724cb269342f55b87eeab37519","tarball":"https://registry.npmjs.org/@codespar/mcp-cielo/-/mcp-cielo-0.1.2.tgz","fileCount":7,"integrity":"sha512-xc8YvbdShNLY3fD/8rC91VzTjWJyZ5dYqSemIyJ7Zzdxw+MQ/0dy8MpEM8KsjioCaUPzPPQ5nEX207gkQ5oJHg==","signatures":[{"sig":"MEUCIQDd2OeimQIrZ3CnGFbdybwcdgTB6VlyZYh2wNPw810g7gIgeWmeageboEdBzg3CB2RlZcvIBNITch+2UHdIJmtXma8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49858},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-cielo","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Cielo — credit card, debit, boleto, recurrent payments","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-cielo_0.1.2_1775953744698_0.7194839863902562","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-cielo","version":"0.2.0","keywords":["mcp","cielo","payments","credit-card","boleto","brazil"],"license":"MIT","_id":"@codespar/mcp-cielo@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-cielo":"dist/index.js"},"dist":{"shasum":"cfe962a73654ba14e729c11fce58a8ab53ae1a78","tarball":"https://registry.npmjs.org/@codespar/mcp-cielo/-/mcp-cielo-0.2.0.tgz","fileCount":7,"integrity":"sha512-Z7EjI9Ln9iNimShVDASCAEbVzY+KoE/T5teskwCkY9UPYMKQwrQ5UpuIK6GGTwYk2l+1Td+YMlRVJjUjF3THQw==","signatures":[{"sig":"MEUCIGtCD3q82pGooO+yyLfwF0GjnaJtcQxPH04ShM+aiVdnAiEA+WQi5klql8qzbm8BHpiFa8dppjflPblz10gVZemidNA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":75000},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"22f6f8b78246bf63993b872baf8cea4da0d4414f","mcpName":"io.github.codespar/mcp-cielo","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Cielo — credit card, debit, boleto, recurrent payments","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-cielo_0.2.0_1777039651757_0.4689355186731843","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-cielo","version":"0.2.1","keywords":["mcp","cielo","payments","credit-card","boleto","brazil"],"license":"MIT","_id":"@codespar/mcp-cielo@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-cielo":"dist/index.js"},"dist":{"shasum":"4f67cb4f925712ccbde3d6841446276b6713dbf6","tarball":"https://registry.npmjs.org/@codespar/mcp-cielo/-/mcp-cielo-0.2.1.tgz","fileCount":7,"integrity":"sha512-q34lRMbGsIWCX8ZElVCqhEkMz2FPi0zNC49qJ3nTgksbvsdtrYYMA8cXnZcBEVjNUjuNq9ggoXHa5rZkqKamzg==","signatures":[{"sig":"MEYCIQCz/lIwCl4DUxvyAjHaK5EfoKyr9DluzqGWeqILOoCJnQIhAKmCWX8mtcWgcEJeVFKSj2bQ7zlQ7rombScXshXemCa2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":76201},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-cielo","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Cielo — credit card, debit, boleto, recurrent payments","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-cielo_0.2.1_1777123180474_0.8147293588045754","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-cielo","version":"0.2.2","description":"MCP server for Cielo — credit card, debit, boleto, recurrent payments","type":"module","main":"./dist/index.js","bin":{"mcp-cielo":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","cielo","payments","credit-card","boleto","brazil"],"mcpName":"io.github.codespar/mcp-cielo","_id":"@codespar/mcp-cielo@0.2.2","gitHead":"8e115a5cb8aed75e812af698b03aa996ccd8d7c1","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-TYVZzQSf3SPF74F+rAOqyLGmS5r8DduFah2LcjyvT52ZkK/1kCfmcMVcYjvuyhyA/34WnFiHbId0DzkccNQB4g==","shasum":"2ea92e685e978e0bd10f9599e61aba64158c18ce","tarball":"https://registry.npmjs.org/@codespar/mcp-cielo/-/mcp-cielo-0.2.2.tgz","fileCount":7,"unpackedSize":77473,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDNJi8k8gLj0sELBanzmqHEoYXGCS5Rrgu+LhCjTEMkzwIhAMX0BK81WUQKI+R0rmdwIWex19Cxg9jyPgNnGmvDMr1b"}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-cielo_0.2.2_1782158179308_0.47277418360488954"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:14:52.994Z","modified":"2026-06-22T19:56:19.589Z","0.1.0":"2026-03-31T02:14:53.211Z","0.1.2":"2026-04-12T00:29:04.850Z","0.2.0":"2026-04-24T14:07:31.883Z","0.2.1":"2026-04-25T13:19:40.618Z","0.2.2":"2026-06-22T19:56:19.456Z"},"license":"MIT","keywords":["mcp","cielo","payments","credit-card","boleto","brazil"],"description":"MCP server for Cielo — credit card, debit, boleto, recurrent payments","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-cielo\n\n> MCP server for **Cielo** — card acquiring, boleto, and recurrent payments\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-cielo)](https://www.npmjs.com/package/@codespar/mcp-cielo)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"cielo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-cielo\"],\n      \"env\": {\n        \"CIELO_MERCHANT_ID\": \"your-merchant-id\",\n        \"CIELO_MERCHANT_KEY\": \"your-merchant-key\",\n        \"CIELO_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add cielo -- npx @codespar/mcp-cielo\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"cielo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-cielo\"],\n      \"env\": {\n        \"CIELO_MERCHANT_ID\": \"your-merchant-id\",\n        \"CIELO_MERCHANT_KEY\": \"your-merchant-key\",\n        \"CIELO_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n## Tools (22)\n\n| Tool | Purpose |\n|---|---|\n| `create_sale` | Create a credit/debit card sale in Cielo |\n| `get_sale` | Get sale details by PaymentId |\n| `capture_sale` | Capture a pre-authorized sale |\n| `cancel_sale` | Cancel/void a sale (full or partial) |\n| `create_recurrent` | Create a recurrent (recurring) credit card payment |\n| `get_recurrent` | Get recurrent payment details |\n| `tokenize_card` | Tokenize a credit card for future use |\n| `create_boleto` | Create a boleto payment in Cielo |\n| `create_pix` | Create a Pix payment in Cielo (generates QR code) |\n| `get_pix` | Get Pix payment details and QR code by PaymentId |\n| `create_debit` | Create a debit card sale in Cielo (requires 3DS authentication) |\n| `create_ewallet` | Create a digital wallet payment (Google Pay, Samsung Pay, Apple Pay) |\n| `get_antifraud` | Get anti-fraud analysis details for a payment |\n| `create_sale_with_token` | Create a credit card sale using a previously stored CardToken (avoids re-entering card data) |\n| `update_recurrent_amount` | Update the amount of an existing recurrent payment |\n| `update_recurrent_next_date` | Update the next charge date of an existing recurrent payment |\n| `deactivate_recurrent` | Deactivate (pause) a recurrent payment so it stops charging |\n| `reactivate_recurrent` | Reactivate a previously deactivated recurrent payment |\n| `create_payment_link` | Create a Cielo Link de Pagamento (shareable checkout URL) |\n| `get_payment_link` | Get a Cielo Link de Pagamento by its id |\n| `zero_auth` | Zero-dollar authorization to validate a card without charging (card or CardToken) |\n| `create_sale_with_3ds` | Create a credit card sale using 3DS 2.0 authentication data (from 3DS flow) |\n\n## Authentication\n\nCielo uses MerchantId and MerchantKey headers for authentication.\n\n## Sandbox / Testing\n\nCielo provides a sandbox at `apisandbox.cieloecommerce.cielo.com.br`. Set `CIELO_SANDBOX=true` to use it.\n\n### Get your credentials\n\n1. Go to [Cielo Developer Portal](https://developercielo.github.io)\n2. Create a developer account\n3. Get your MerchantId and MerchantKey\n4. Set the environment variables\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `CIELO_MERCHANT_ID` | Yes | Merchant ID from Cielo |\n| `CIELO_MERCHANT_KEY` | Yes | Merchant Key from Cielo |\n| `CIELO_SANDBOX` | No | Set to `\"true\"` for sandbox mode |\n\n## Roadmap\n\n### v0.2 (planned)\n- `create_pix` — Create a Pix payment\n- `get_pix` — Get Pix payment details\n- `create_debit` — Create a debit card payment\n- `create_ewallet` — Create an e-wallet payment (Apple Pay, Google Pay)\n- `get_antifraud` — Get anti-fraud analysis for a transaction\n\n### v0.3 (planned)\n- `batch_captures` — Capture multiple pre-authorized transactions\n- `velocity_rules` — Configure velocity/anti-fraud rules\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [Cielo Website](https://cielo.com.br)\n- [Cielo API Documentation](https://developercielo.github.io)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}