{"_id":"@codespar/mcp-asaas","_rev":"6-23a56cb3629c500c204e838b9e87497f","name":"@codespar/mcp-asaas","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.0":{"name":"@codespar/mcp-asaas","version":"0.1.0","keywords":["mcp","asaas","payments","pix","boleto","brazil"],"license":"MIT","_id":"@codespar/mcp-asaas@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-asaas":"dist/index.js"},"dist":{"shasum":"271bbd9bedf11d0bd21249a882e67e6c6b832796","tarball":"https://registry.npmjs.org/@codespar/mcp-asaas/-/mcp-asaas-0.1.0.tgz","fileCount":4,"integrity":"sha512-fcoOjw5EQBBIL5WtOvvgnx5NrGVoxuzzAUHn3y0z9+NkVg2PNKtwBuzhYpaI6vMMtQwhG9elbF4V83lKqh4ngA==","signatures":[{"sig":"MEUCICOGjxRIss/z0GOcD35vRHl+PPliuhA70WUBNtJac+RLAiEAvPSLHfH8GjCsSfTqLROrLIt3CjGdRBt5rFVz03cmX18=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20678},"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 Asaas — billing automation, Pix, boleto, credit card, subscriptions","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-asaas_0.1.0_1774923289152_0.4485630163024126","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-asaas","version":"0.1.2","keywords":["mcp","asaas","payments","pix","boleto","brazil"],"license":"MIT","_id":"@codespar/mcp-asaas@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-asaas":"dist/index.js"},"dist":{"shasum":"54a852bfa291c889262e87d697f4e70f9b2094ab","tarball":"https://registry.npmjs.org/@codespar/mcp-asaas/-/mcp-asaas-0.1.2.tgz","fileCount":7,"integrity":"sha512-HfXjEF3JxrvmO+MWiqSMJd6S0HG/LDYULKsPHbCT0/ml3anxe0TS9nGF37ekt8pjQe6Ft765yduix8tcHDC5Sw==","signatures":[{"sig":"MEQCIEZ1+vVDI5gF1iN9BQxmZxEXo24F7YiJk7557Jt8fovyAiAMjBoCKfL/7J8TlAtdYxPiqqCyvaWc4YKkcGkwt6nIvQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51269},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-asaas","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Asaas — billing automation, Pix, boleto, credit card, subscriptions","directories":{},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-asaas_0.1.2_1775953735519_0.6509960312796947","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@codespar/mcp-asaas","version":"0.1.3","keywords":["mcp","asaas","payments","pix","boleto","brazil"],"license":"MIT","_id":"@codespar/mcp-asaas@0.1.3","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-asaas":"dist/index.js"},"dist":{"shasum":"8b453e2754437349aab335b5e048a905534f7f91","tarball":"https://registry.npmjs.org/@codespar/mcp-asaas/-/mcp-asaas-0.1.3.tgz","fileCount":7,"integrity":"sha512-DByGG+VH1smyj7IaSuCP4enbwycElb0KYRjCSLlPFJd0M+wxNBIJ+Ws5Z8ncvV/2yM1rUGpldMEtF5bk42CvDQ==","signatures":[{"sig":"MEUCIQChL14j1gBPEBzm1aP7s0J2oMXtA2CwGa6f9rOaryqKewIgYjLszWLtUt68oB8vBKO5yA6u4+uen3pn3RZY/wX6c0M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":70842},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-asaas","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Asaas — billing automation, Pix, boleto, credit card, subscriptions","directories":{},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-asaas_0.1.3_1777123163503_0.5691812757562098","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-asaas","version":"0.2.0","keywords":["mcp","asaas","payments","pix","boleto","brazil"],"license":"MIT","_id":"@codespar/mcp-asaas@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-asaas":"dist/index.js"},"dist":{"shasum":"2729bfd38d666701900b264934367b1e3b1ebe08","tarball":"https://registry.npmjs.org/@codespar/mcp-asaas/-/mcp-asaas-0.2.0.tgz","fileCount":8,"integrity":"sha512-Q8DICRYObpaqIhjqZS7cYYfTZ9jOMMvFLmD4LCSSrM5OQ1gEZJsU4Ap+nMQEX4GhhtK/i6u95YfqYXpXH4TreQ==","signatures":[{"sig":"MEYCIQDQV3QnZoAZ6/qyvDQyyZx1KzvCiTE/IzUgJc/MINqdfAIhAOjLlMNXSKDp822HzmWajIHg2sZ+L3+O91oJwFpzdHJE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92771},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"63e992be685fa073f7d9fba6a1aec227e567e6fa","mcpName":"io.github.codespar/mcp-asaas","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"10.9.7","description":"MCP server for Asaas — billing automation, Pix, boleto, credit card, subscriptions","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-asaas_0.2.0_1779144361115_0.6763266392332079","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-asaas","version":"0.2.1","description":"MCP server for Asaas — billing automation, Pix, boleto, credit card, subscriptions","type":"module","main":"./dist/index.js","bin":{"mcp-asaas":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","asaas","payments","pix","boleto","brazil"],"mcpName":"io.github.codespar/mcp-asaas","_id":"@codespar/mcp-asaas@0.2.1","gitHead":"776ee260ec81f40a78c5f23f4ae78d64b475c0fa","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-RVoV4kUkBXt+dENHsKKfQXjp5Igg4rULsOBJvrP0Ih6594jQsTNSrzPRFaAAs2dAdRo326oNmu55ADhSelDEBw==","shasum":"7c78596c129f10382a12a57a9445a8b9e54e9cbc","tarball":"https://registry.npmjs.org/@codespar/mcp-asaas/-/mcp-asaas-0.2.1.tgz","fileCount":8,"unpackedSize":93739,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIE3TssBngk6XOn3FX5jxqvNhjutfa/7LJKSSxV9a3fkgAiEAo+x/9lIisMjBvx/jPdQYGj3dH8ujTEgAJ7JwTgxQo64="}]},"_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-asaas_0.2.1_1782149702362_0.5743737844501053"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:14:49.065Z","modified":"2026-06-22T17:35:02.664Z","0.1.0":"2026-03-31T02:14:49.294Z","0.1.2":"2026-04-12T00:28:55.658Z","0.1.3":"2026-04-25T13:19:23.652Z","0.2.0":"2026-05-18T22:46:01.258Z","0.2.1":"2026-06-22T17:35:02.504Z"},"license":"MIT","keywords":["mcp","asaas","payments","pix","boleto","brazil"],"description":"MCP server for Asaas — billing automation, Pix, boleto, credit card, subscriptions","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-asaas\n\n> MCP server for **Asaas** — billing automation with Pix, boleto, and credit card payments\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-asaas)](https://www.npmjs.com/package/@codespar/mcp-asaas)\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    \"asaas\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-asaas\"],\n      \"env\": {\n        \"ASAAS_API_KEY\": \"your-key\",\n        \"ASAAS_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add asaas -- npx @codespar/mcp-asaas\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"asaas\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-asaas\"],\n      \"env\": {\n        \"ASAAS_API_KEY\": \"your-key\",\n        \"ASAAS_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n## Tools (24)\n\n| Tool | Purpose |\n|---|---|\n| `create_payment` | Create a payment in Asaas (Pix, boleto, or credit card); pass `installments` (>=2) with `billingType: CREDIT_CARD` to split into equal monthly installments |\n| `get_payment` | Get payment details by ID |\n| `list_payments` | List payments with optional filters |\n| `get_pix_qrcode` | Get Pix QR code for a payment (returns payload and image) |\n| `get_boleto` | Get boleto digitable line and barcode for a payment |\n| `create_customer` | Create a customer in Asaas |\n| `list_customers` | List customers with optional filters |\n| `create_subscription` | Create a recurring subscription |\n| `get_balance` | Get current account balance |\n| `list_subscriptions` | List subscriptions with optional filters |\n| `cancel_subscription` | Cancel a subscription by ID |\n| `get_webhook_events` | List webhook events (payment confirmations, transfers, etc.) |\n| `create_subaccount` | Create a subaccount for payment splitting |\n| `get_installments` | Get installment details for an existing payment by `id`, OR preview a hypothetical schedule by passing `value` + `installments` without an `id` |\n| `create_transfer` | Create a bank transfer (Pix out or TED) |\n| `create_pix_qrcode` | Generate a static PIX QR code for receiving payments |\n| `list_transfers` | List transfers with optional filters |\n| `create_notification` | Create a webhook notification configuration |\n| `list_notifications` | List webhook notification configurations |\n| `get_customer` | Get customer details by ID |\n| `update_payment` | Update a pending payment |\n| `delete_payment` | Delete a payment by ID |\n| `refund_payment` | Refund a received payment |\n| `get_subscription` | Get subscription details by ID |\n\n## Authentication\n\nAsaas uses an API key passed via the `access_token` header. You can generate your key from the Asaas dashboard.\n\n## Sandbox / Testing\n\nAsaas provides a full sandbox environment at `sandbox.asaas.com`. Set `ASAAS_SANDBOX=true` to use it.\n\n### Get your credentials\n\n1. Go to [Asaas](https://www.asaas.com)\n2. Create an account or sign up for sandbox at [sandbox.asaas.com](https://sandbox.asaas.com)\n3. Navigate to **Integracoes > API** and generate your API key\n4. Set the `ASAAS_API_KEY` environment variable\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `ASAAS_API_KEY` | Yes (unless in demo mode) | API key from Asaas dashboard |\n| `ASAAS_SANDBOX` | No | Set to `\"true\"` for sandbox mode |\n| `MCP_DEMO` | No | Set to `\"true\"` (equivalent to passing `--demo` on the command line) for stateful demo-mode fixtures — no API key required |\n\n## Demo mode\n\nPass the `--demo` flag (or set `MCP_DEMO=true`) to make every tool\nreturn deterministic fixture responses instead of calling the real\nAsaas API. Useful for building and testing agents without burning\nsandbox credentials.\n\nThe demo handlers for `create_payment` and `get_installments` are\nstateful: `create_payment` issues distinct ids per call\n(`pay_demo_001`, `pay_demo_002`, ...) and, when called with\n`billingType: CREDIT_CARD` + `installments >= 2` + `value > 0`,\nrecords the installment schedule in an in-process ledger. A\nsubsequent `get_installments({ id })` against that id echoes the\nrecorded schedule back. `get_installments` also supports a preview\npath — pass `value` + `installments` without an `id` and it returns\na hypothetical schedule (`status: \"PREVIEW\"`, `preview: true`)\nwithout creating a payment. Other tools return static fixture\npayloads.\n\n```bash\n# Start the server in demo mode (no key required):\nnpx -y @codespar/mcp-asaas --demo\n```\n\n## Roadmap\n\n### v0.2 (planned)\n- `list_subscriptions` — List all recurring subscriptions with filters\n- `cancel_subscription` — Cancel an active subscription\n- `get_webhook_events` — List webhook events for debugging integrations\n- `create_subaccount` — Create a subaccount for marketplace splits\n- `get_installments` — Get installment details for a payment\n\n### v0.3 (planned)\n- `create_anticipation` — Request anticipation of receivables\n- `get_fiscal_info` — Get fiscal/tax information for payments\n- `batch_payments` — Create multiple payments in a single request\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- [Asaas Website](https://www.asaas.com)\n- [Asaas API Documentation](https://docs.asaas.com)\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"}