{"_id":"@codespar/mcp-braspag","_rev":"5-1f0310ce81657b20fa0005c376979812","name":"@codespar/mcp-braspag","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-braspag","version":"0.1.0","keywords":["mcp","braspag","cielo","payments","orchestration","token-vault","cartao-protegido","marketplace","split","recurrence","brazil"],"license":"MIT","_id":"@codespar/mcp-braspag@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-braspag":"dist/index.js"},"dist":{"shasum":"d2609f61044750a396ad8ea3a0e00fb6c9ae8b03","tarball":"https://registry.npmjs.org/@codespar/mcp-braspag/-/mcp-braspag-0.1.0.tgz","fileCount":4,"integrity":"sha512-ss3WeCftx3sqaADYHDir1DHFJWQTy8NzZfjIVN2l2ARHuNs6qWrTBOQC7numtF1YJZSAW9rmZIs2+Kl1R0Wshg==","signatures":[{"sig":"MEQCIAPoOTe6jJ1WUts3JqG6U+THmeWpav59TxirXGsVUOBjAiBJ8C2/zpAAVKxV63MBgBMXHSAJDtWUOifQ/tXOIz+bhw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32169},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"286c1445fcebf46fb88fd416a77412e331aa63a6","mcpName":"io.github.codespar/mcp-braspag","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Braspag — Cielo's enterprise orchestration, token vault (Cartão Protegido), recurrence, and marketplace split","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-braspag_0.1.0_1776991714138_0.9176611141638957","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-braspag","version":"0.2.0","keywords":["mcp","braspag","cielo","payments","orchestration","token-vault","cartao-protegido","marketplace","split","recurrence","brazil"],"license":"MIT","_id":"@codespar/mcp-braspag@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-braspag":"dist/index.js"},"dist":{"shasum":"5ee78063cb276994ac48451d0bbaab9ea9549b52","tarball":"https://registry.npmjs.org/@codespar/mcp-braspag/-/mcp-braspag-0.2.0.tgz","fileCount":4,"integrity":"sha512-DN/KxpodUc9VW/A9E6VYdmlbanqIXFOUcV2sz3ikM99lTOz+hhYTt/o50VshAdgSvJeqEtgVZrPNODmyb9gplQ==","signatures":[{"sig":"MEUCIBTyYxcw0AOtEbWTZgOArF8Cr5GJwmcRF5hQSVVbIgS/AiEAuVzNT00dEjzOPCEzFNPzhWVNfNmfS2CwFDKsxq/TxE8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52521},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ea10b1dfe82e3d4b5e84fffdfe18d44018529bfa","mcpName":"io.github.codespar/mcp-braspag","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Braspag — Cielo's enterprise orchestration, token vault (Cartão Protegido), recurrence, and marketplace split","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-braspag_0.2.0_1777064138180_0.1505525572846016","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-braspag","version":"0.2.1","keywords":["mcp","braspag","cielo","payments","orchestration","token-vault","cartao-protegido","marketplace","split","recurrence","brazil"],"license":"MIT","_id":"@codespar/mcp-braspag@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-braspag":"dist/index.js"},"dist":{"shasum":"e4942394d9842ff59985b3a0ebceb468ec070386","tarball":"https://registry.npmjs.org/@codespar/mcp-braspag/-/mcp-braspag-0.2.1.tgz","fileCount":4,"integrity":"sha512-j8ckaXTxdGv/K0gTusFqXd+CfUU5bfSwaDBa4PwlM0cfHFb7NgbbLByqE1x5h4s1kt/Y561zBMFSOZLwJjemEg==","signatures":[{"sig":"MEUCIQCa8MpadNoatSg0L9orGWCPtr0xSAAt27yYxtqHAP25wwIgHjYxKCD259E04L3j/DFkis+VVAyGHjgNupNZJb9c36E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53777},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-braspag","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Braspag — Cielo's enterprise orchestration, token vault (Cartão Protegido), recurrence, and marketplace split","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-braspag_0.2.1_1777123169990_0.6270984210675408","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-braspag","version":"0.2.2","description":"MCP server for Braspag — Cielo's enterprise orchestration, token vault (Cartão Protegido), recurrence, and marketplace split","type":"module","main":"./dist/index.js","bin":{"mcp-braspag":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","braspag","cielo","payments","orchestration","token-vault","cartao-protegido","marketplace","split","recurrence","brazil"],"mcpName":"io.github.codespar/mcp-braspag","_id":"@codespar/mcp-braspag@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-xpa5BIExLqIU2Qgi5QzgAFdLHbRO4CGKagPVnvARE2JqOLD5ex1D6oeKAF9mUzjJ7FwYPnq6S4dHTKcBX53oew==","shasum":"8763480fe95c97eabff042e40adba3d0f4719bcd","tarball":"https://registry.npmjs.org/@codespar/mcp-braspag/-/mcp-braspag-0.2.2.tgz","fileCount":4,"unpackedSize":54252,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD+IAkGzYoqCWeR/dzYIlJzC1l3kmJgpHSr6jKzGNbsGgIgUbj6B+vf2dK4ENXGktpZJ4ubmFO8J8kG2bUvebelzc8="}]},"_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-braspag_0.2.2_1782153792423_0.9567487984782623"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T00:48:34.052Z","modified":"2026-06-22T18:43:12.729Z","0.1.0":"2026-04-24T00:48:34.263Z","0.2.0":"2026-04-24T20:55:38.381Z","0.2.1":"2026-04-25T13:19:30.131Z","0.2.2":"2026-06-22T18:43:12.564Z"},"license":"MIT","keywords":["mcp","braspag","cielo","payments","orchestration","token-vault","cartao-protegido","marketplace","split","recurrence","brazil"],"description":"MCP server for Braspag — Cielo's enterprise orchestration, token vault (Cartão Protegido), recurrence, and marketplace split","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-braspag\n\n> MCP server for **Braspag** — Cielo Group's enterprise orchestration layer: multi-acquirer routing, token vault (Cartão Protegido), recurrence, marketplace split, antifraud orchestration.\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-braspag)](https://www.npmjs.com/package/@codespar/mcp-braspag)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Braspag vs. Cielo (Acquirer)\n\nCodeSpar ships **two** Cielo Group servers with different business contracts:\n\n| Server | Product | What it is | Who uses it |\n|---|---|---|---|\n| [`@codespar/mcp-cielo`](../cielo) | Cielo Acquirer | Direct card acquiring rails (credit, debit, boleto, Pix) | Any merchant taking cards through Cielo |\n| `@codespar/mcp-braspag` (this) | Braspag / Pagador | Enterprise orchestration on top of any acquirer | Enterprise BR retail (Magalu-tier): multi-acquirer routing, token vault, marketplace split |\n\nBraspag orchestrates **across** acquirers. You keep your Cielo (or Rede, or Stone) acquiring contract and layer Braspag on top for: smart routing, failover, vaulting cards once and reusing across acquirers (**Cartão Protegido**), driving recurrence, and splitting marketplace capture across sub-merchants.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"braspag\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-braspag\"],\n      \"env\": {\n        \"BRASPAG_MERCHANT_ID\": \"your-merchant-uuid\",\n        \"BRASPAG_MERCHANT_KEY\": \"your-merchant-key\",\n        \"BRASPAG_ENV\": \"sandbox\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add braspag -- npx @codespar/mcp-braspag\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"braspag\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-braspag\"],\n      \"env\": {\n        \"BRASPAG_MERCHANT_ID\": \"your-merchant-uuid\",\n        \"BRASPAG_MERCHANT_KEY\": \"your-merchant-key\",\n        \"BRASPAG_ENV\": \"sandbox\"\n      }\n    }\n  }\n}\n```\n\n## Tools (22)\n\n| Tool | Purpose |\n|---|---|\n| `create_sale` | Create a sale on the Braspag Transaction API (POST /sales). |\n| `capture_sale` | Capture a pre-authorized sale (PUT /sales/{paymentId}/capture). |\n| `void_sale` | Void / cancel a sale (PUT /sales/{paymentId}/void). |\n| `create_recurrent` | Create a recurrent payment schedule (POST /recurrentPayments). |\n| `disable_recurrent` | Deactivate a recurrent payment (PUT /recurrentPayments/{recurrentPaymentId}/Deactivate). |\n| `update_recurrent_amount` | Update the charged amount on a recurrent payment (PUT /recurrentPayments/{recurrentPaymentId}/Amount). |\n| `get_sale` | Get sale detail by PaymentId (GET /sales/{paymentId} — Query API). |\n| `get_sale_by_order_id` | Look up sale(s) by MerchantOrderId (GET /sales?merchantOrderId=X — Query API). |\n| `get_recurrent` | Get a recurrent payment's configuration and history (GET /recurrentPayments/{recurrentPaymentId} — Query API). |\n| `tokenize_card` | Tokenize a card into the Braspag vault / Cartão Protegido (POST /card). |\n| `get_card_token` | Retrieve the stored card data associated with a Cartão Protegido token (GET /card/{token}). |\n| `create_split_sale` | Create a sale with marketplace split rules (POST /sales with Payment.SplitPayments). |\n| `create_sale_3ds` | Create a 3DS-authenticated credit sale (POST /sales). |\n| `create_zero_auth` | Zero-dollar authorization / card validation (POST /zeroauth). |\n| `create_boleto_sale` | Convenience wrapper to create a Boleto sale (POST /sales with Payment.Type=Boleto). |\n| `create_pix_sale` | Convenience wrapper to create a Pix sale (POST /sales with Payment.Type=Pix). |\n| `reactivate_recurrent` | Reactivate a previously deactivated recurrent payment (PUT /recurrentPayments/{recurrentPaymentId}/Reactiva... |\n| `update_recurrent_next_payment` | Update the NextPaymentDate on a recurrent payment (PUT /recurrentPayments/{recurrentPaymentId}/NextPaymentD... |\n| `update_recurrent_payment` | Update the Payment (CreditCard + Customer) on a recurrent schedule (PUT /recurrentPayments/{recurrentPaymen... |\n| `create_antifraud_analysis` | Submit a standalone Antifraud analysis (POST /fraudanalysis) through Braspag's antifraud orchestration (Cyb... |\n| `delete_card_token` | Delete a Cartão Protegido vault token (DELETE /card/{token}). |\n| `create_split_capture` | Capture a previously authorized split sale with overridden per-sub-merchant amounts (PUT /sales/{paymentId}... |\n\n## Authentication\n\nBraspag uses `MerchantId` (UUID) and `MerchantKey` (secret) headers on both the Transaction API and the Query API.\n\n## Environments\n\n| Env | Transaction API | Query API |\n|-----|-----------------|-----------|\n| `sandbox` (default) | `https://apisandbox.braspag.com.br/v2` | `https://apiquerysandbox.braspag.com.br/v2` |\n| `production` | `https://api.braspag.com.br/v2` | `https://apiquery.braspag.com.br/v2` |\n\nSet via `BRASPAG_ENV=production` to switch.\n\n### Get your credentials\n\n1. Reach out to your Cielo / Braspag account team to enable Braspag Pagador on your merchant contract.\n2. Receive your MerchantId (UUID) and MerchantKey.\n3. Set the environment variables below.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `BRASPAG_MERCHANT_ID` | Yes | Merchant UUID |\n| `BRASPAG_MERCHANT_KEY` | Yes | Merchant secret key |\n| `BRASPAG_ENV` | No | `sandbox` (default) or `production` |\n\n## Roadmap\n\n### v0.2 (planned)\n- `create_sale_with_card_token` — convenience wrapper that uses a Cartão Protegido token\n- `delete_card_token` — revoke a vault token\n- `get_sale_antifraud` — Query API antifraud detail\n- `update_recurrent_payment` — update non-amount fields on a recurrent\n- `create_zero_auth` — zero-dollar auth for card validation\n\n### v0.3 (planned)\n- Marketplace: sub-merchant onboarding endpoints\n- Bank slip (boleto) registered-only helpers\n- Webhook verification helper\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- [Braspag Manual (Pagador)](https://braspag.github.io/manual/braspag-pagador)\n- [Cielo / Braspag Developer Portal](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-driven payments on Braspag? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds a policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}