{"_id":"@codespar/mcp-celcoin","_rev":"7-ebf6b7ed4c20e2feff94127110a028e2","name":"@codespar/mcp-celcoin","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.0":{"name":"@codespar/mcp-celcoin","version":"0.1.0","keywords":["mcp","celcoin","pix","boleto","payments","brazil"],"license":"MIT","_id":"@codespar/mcp-celcoin@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-celcoin":"dist/index.js"},"dist":{"shasum":"6788d789326da62c2f1ab119e0af00fee2d8bac0","tarball":"https://registry.npmjs.org/@codespar/mcp-celcoin/-/mcp-celcoin-0.1.0.tgz","fileCount":4,"integrity":"sha512-bSAgKOgd+yoy/YNeOzkwOBdL9i0cWCz87eGOeuj0HI9XvAZ5onYn0Y8cepX/BisWg3ImpeJUKIR3Q2jo6fonIg==","signatures":[{"sig":"MEUCIQCGygwD4WQ8x5KfOWzZOK6i4YRYPIleaqTbxWM3pJavOAIgDexbus4QLYxaBEuEm2lYr+W9BUC9Ep/60KK4TdpYapE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21669},"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 Celcoin — Pix, boleto, transfers, bill payments, top-ups","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-celcoin_0.1.0_1774923291009_0.2708172421274482","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-celcoin","version":"0.1.2","keywords":["mcp","celcoin","pix","boleto","payments","brazil"],"license":"MIT","_id":"@codespar/mcp-celcoin@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-celcoin":"dist/index.js"},"dist":{"shasum":"91cbd7576bd9b56de9b1cba4da22de55df9f45da","tarball":"https://registry.npmjs.org/@codespar/mcp-celcoin/-/mcp-celcoin-0.1.2.tgz","fileCount":7,"integrity":"sha512-Z+peJkd4Lu+spKQIZcUxEVG5o43uMdTxFdjPNh+re3Xl0Q0I2MoNiBbTtxoeEno/yLV2leoi0ZKD/+is3qr+tg==","signatures":[{"sig":"MEUCIQDq5Asd7hxjsUZNNhgZKsJ2sBLs6L2q1UiCjs+OlP1jogIgOiPrihOZVK5+LzDKdW9AvA2kw8s3eXu/b+QuzX6jnq0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32385},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-celcoin","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Celcoin — Pix, boleto, transfers, bill payments, top-ups","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-celcoin_0.1.2_1775953739682_0.013955985000745352","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-celcoin","version":"0.2.0","keywords":["mcp","celcoin","pix","boleto","payments","brazil"],"license":"MIT","_id":"@codespar/mcp-celcoin@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-celcoin":"dist/index.js"},"dist":{"shasum":"31ab29d9207b66a8aa9acd5180f84b1b4e3a47a9","tarball":"https://registry.npmjs.org/@codespar/mcp-celcoin/-/mcp-celcoin-0.2.0.tgz","fileCount":7,"integrity":"sha512-bAmwVahI3Lf5qZ8nUkB/JxLkPxEPv6xb6/AI3KrbMatSjDzOs+nzHkdlQ/MDmVVrTHfjrXNyNAtnE7OEIPhh7A==","signatures":[{"sig":"MEUCIHqwmfXvoqPyoBq2IdcLSO594hUOT6ZbnESJjtYLnbTPAiEA7+DmmOcfx8TyBYPgtVfv+qrJqLBTuzM0WGmBFwBP1B8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52733},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"4d61b23e069b421d30d91b4b27c118ae36267449","mcpName":"io.github.codespar/mcp-celcoin","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Celcoin — Pix, boleto, transfers, bill payments, top-ups","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-celcoin_0.2.0_1777115022235_0.040094618273631255","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-celcoin","version":"0.2.1","keywords":["mcp","celcoin","pix","boleto","payments","brazil"],"license":"MIT","_id":"@codespar/mcp-celcoin@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-celcoin":"dist/index.js"},"dist":{"shasum":"fad90617312a3fb85a618faa9ef22a17e86b9539","tarball":"https://registry.npmjs.org/@codespar/mcp-celcoin/-/mcp-celcoin-0.2.1.tgz","fileCount":7,"integrity":"sha512-CE4AVaZbDoWLLJDXVl4qDITucYtXaOXoS4Vjg8OFNrQe3V+23Rl7w+80giq8S+6wgKIrUwU/+vbDE29+Z+5X9Q==","signatures":[{"sig":"MEUCIFmqnUHZYOE29Wf8N6j3sqHyfpPgBf8CKMYn1/DYwiloAiEAnxXVwMFpuz0iK/tS+toJAEalWEP9cH1CRpK+zsWVtWs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53635},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-celcoin","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Celcoin — Pix, boleto, transfers, bill payments, top-ups","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-celcoin_0.2.1_1777123172896_0.5142802581592283","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-celcoin","version":"0.2.2","keywords":["mcp","celcoin","pix","boleto","payments","brazil"],"license":"MIT","_id":"@codespar/mcp-celcoin@0.2.2","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"bin":{"mcp-celcoin":"dist/index.js"},"dist":{"shasum":"6603064f1abf272bfa82631a96b09100f25a9a70","tarball":"https://registry.npmjs.org/@codespar/mcp-celcoin/-/mcp-celcoin-0.2.2.tgz","fileCount":7,"integrity":"sha512-J/EIVodkseV3vtQola0A2nz7QYXQcPuXiE0l72ch1PcxTMzQFBGlDSCkEbRgYrEb1wqvBXZ1m6tJMeLtlWD2Ow==","signatures":[{"sig":"MEUCIFnK3IQedgmVxM30z6ttfdCVTT/wRwSatVaNXeyxGvmnAiEAupoy8aZWahRxbI4BBoWJEh1BPphbKtwqfmkedxXoSDk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54916},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","mcpName":"io.github.codespar/mcp-celcoin","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"_npmVersion":"10.9.8","description":"MCP server for Celcoin — Pix, boleto, transfers, bill payments, top-ups","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-celcoin_0.2.2_1782153799768_0.17539500453640344","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@codespar/mcp-celcoin","version":"0.2.3","description":"MCP server for Celcoin — Pix, boleto, transfers, bill payments, top-ups","type":"module","main":"./dist/index.js","bin":{"mcp-celcoin":"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","celcoin","pix","boleto","payments","brazil"],"mcpName":"io.github.codespar/mcp-celcoin","_id":"@codespar/mcp-celcoin@0.2.3","gitHead":"66c6cef40fda3d575fcc512d27d0f51e5c527ada","types":"./dist/index.d.ts","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-3apy4dwbUArrgWz/kM/74V7R0C6FwaZ1jdaZMX53/SmlizGVq3BMzFlVi9I+jgVTRp+KH8qFRsRGqz1TpbKheA==","shasum":"0fb265ed046d5b93854e75ce88b66ae1a092c7fc","tarball":"https://registry.npmjs.org/@codespar/mcp-celcoin/-/mcp-celcoin-0.2.3.tgz","fileCount":8,"unpackedSize":71660,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGig73JU1cWvw4FrFgV9crhe2+ugLO1vNzUmzjPDdJE6AiEA/xL5NxHGFVLh6Hxro7mt+Ip/dYzb6rT7z3k/uC0MdwY="}]},"_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-celcoin_0.2.3_1783230191681_0.541155785198693"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:14:50.914Z","modified":"2026-07-05T05:43:11.947Z","0.1.0":"2026-03-31T02:14:51.151Z","0.1.2":"2026-04-12T00:28:59.816Z","0.2.0":"2026-04-25T11:03:42.390Z","0.2.1":"2026-04-25T13:19:33.039Z","0.2.2":"2026-06-22T18:43:19.926Z","0.2.3":"2026-07-05T05:43:11.811Z"},"license":"MIT","keywords":["mcp","celcoin","pix","boleto","payments","brazil"],"description":"MCP server for Celcoin — Pix, boleto, transfers, bill payments, top-ups","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-celcoin\n\n> MCP server for **Celcoin** — BaaS infrastructure for Pix, boleto, transfers, and top-ups\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-celcoin)](https://www.npmjs.com/package/@codespar/mcp-celcoin)\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    \"celcoin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-celcoin\"],\n      \"env\": {\n        \"CELCOIN_CLIENT_ID\": \"your-client-id\",\n        \"CELCOIN_CLIENT_SECRET\": \"your-client-secret\",\n        \"CELCOIN_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add celcoin -- npx @codespar/mcp-celcoin\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"celcoin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-celcoin\"],\n      \"env\": {\n        \"CELCOIN_CLIENT_ID\": \"your-client-id\",\n        \"CELCOIN_CLIENT_SECRET\": \"your-client-secret\",\n        \"CELCOIN_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n## Tools (18)\n\n| Tool | Purpose |\n|---|---|\n| `create_pix_payment` | Create a Pix payment via Celcoin |\n| `get_pix_payment` | Get Pix payment details by transaction ID |\n| `create_pix_cob` | Create a Pix immediate charge (cob) — generates QR code / copia-e-cola for payer |\n| `get_pix_cob` | Get a Pix immediate charge by transactionId or txid |\n| `create_pix_cobv` | Create a Pix due charge (cobv) — boleto-like Pix with due date |\n| `lookup_pix_dict` | Lookup a Pix DICT key — resolves a Pix key to account holder + bank info |\n| `create_pix_devolution` | Create a Pix devolução (refund) — refund a received Pix transaction |\n| `cancel_boleto` | Cancel a boleto issued via the bill-issuance product by id |\n| `read_barcode` | Authorize (consult) a boleto / concessionária barcode before paying — returns transactionId, amount, totalUpdated, dueDate |\n| `pay_bill` | Confirm payment of a previously authorized bill — pass the read_barcode transactionId as transactionIdAuthorize |\n| `get_statement` | Get account statement (extrato) for a date range |\n| `list_topup_providers` | List telecom top-up providers (operadoras) available for recargas |\n| `create_boleto` | Issue a boleto via the bill-issuance product |\n| `get_boleto` | Get an issued boleto's details by id |\n| `create_transfer` | Create a bank transfer (TED/DOC) via Celcoin |\n| `get_balance` | Get account balance at Celcoin |\n| `list_banks` | List available banks in Brazil (ISPB codes) |\n| `create_topup` | Create a mobile/service top-up (recarga) via Celcoin |\n\n## Authentication\n\nCelcoin uses OAuth2 client credentials. The server automatically manages token refresh.\n\n## Sandbox / Testing\n\nCelcoin provides a sandbox at `sandbox.openfinance.celcoin.dev`. Set `CELCOIN_SANDBOX=true` to use it.\n\n### Get your credentials\n\n1. Go to [Celcoin Documentation](https://docs.celcoin.com.br)\n2. Create a developer account\n3. Register an application to get OAuth2 credentials\n4. Set the environment variables\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `CELCOIN_CLIENT_ID` | Yes | OAuth2 client ID |\n| `CELCOIN_CLIENT_SECRET` | Yes | OAuth2 client secret |\n| `CELCOIN_SANDBOX` | No | Set to `\"true\"` for sandbox mode |\n\n## Roadmap\n\n### v0.2 (planned)\n- `get_pix_key` — Get Pix key details (DICT lookup)\n- `create_bill_payment` — Create a bill/utility payment\n- `get_bill_payment` — Get bill payment details\n- `create_scheduled_transfer` — Create a scheduled transfer\n- `list_providers` — List available service providers\n\n### v0.3 (planned)\n- `batch_topups` — Process multiple mobile top-ups\n- `detailed_reports` — Generate detailed transaction reports\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- [Celcoin Website](https://celcoin.com.br)\n- [Celcoin API Documentation](https://docs.celcoin.com.br)\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"}