{"_id":"@codespar/mcp-chargebee","_rev":"4-c9a25e589f7026b265855026c1fef29a","name":"@codespar/mcp-chargebee","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-chargebee","version":"0.1.0","keywords":["mcp","chargebee","payments","subscriptions","billing","saas","recurring"],"license":"MIT","_id":"@codespar/mcp-chargebee@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-chargebee":"dist/index.js"},"dist":{"shasum":"40bdf1f34cf970dbda3653222449b57e0e0bd939","tarball":"https://registry.npmjs.org/@codespar/mcp-chargebee/-/mcp-chargebee-0.1.0.tgz","fileCount":6,"integrity":"sha512-SwOs7R9UPSDIuPWwIt+AefMti0lp4Q8qJFyC48AqpklnCKoXE1Wskq0NAdIKLJWbUAk+BiT/qZd/an3dbbHy/w==","signatures":[{"sig":"MEUCIA9HAgnjnZEW02zpYd9Yte4oej/C7zArh1UUoWW8xqLlAiEA883qa2CKbF85Ls0yBrgQCQB/mfBjSzs77KrgeXy48DY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46042},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"286c1445fcebf46fb88fd416a77412e331aa63a6","mcpName":"io.github.codespar/mcp-chargebee","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Chargebee — global subscription billing, recurring revenue orchestration","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-chargebee_0.1.0_1776991710684_0.0746654404519489","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@codespar/mcp-chargebee","version":"0.1.1","keywords":["mcp","chargebee","payments","subscriptions","billing","saas","recurring"],"license":"MIT","_id":"@codespar/mcp-chargebee@0.1.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-chargebee":"dist/index.js"},"dist":{"shasum":"d8cd551efd5e82c243388c2f1eba4da995a62636","tarball":"https://registry.npmjs.org/@codespar/mcp-chargebee/-/mcp-chargebee-0.1.1.tgz","fileCount":6,"integrity":"sha512-BOjvoSaFTbTQDIDaPDHHj5Mc0bLU7S7BwKVqleSqfIerq+SpNBHfwwJW8jLYIjA9kZj8GF7298R3NslEJqlhcQ==","signatures":[{"sig":"MEUCIALB/OvOnDSsmhl5VvSKIjxxy5rDNAdWfzZDjjJyeHMPAiEAmExoPqhu1awW4horNTw9qMic8SaSPzGK8oRVGJh1k74=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45721},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-chargebee","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Chargebee — global subscription billing, recurring revenue orchestration","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-chargebee_0.1.1_1777123176788_0.7034551324203311","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-chargebee","version":"0.1.2","description":"MCP server for Chargebee — global subscription billing, recurring revenue orchestration","type":"module","main":"./dist/index.js","bin":{"mcp-chargebee":"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","chargebee","payments","subscriptions","billing","saas","recurring"],"mcpName":"io.github.codespar/mcp-chargebee","_id":"@codespar/mcp-chargebee@0.1.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-3YTeEYr025gMfW/rVuWroDQm04bpH4BnXguK39yVMrVwCVlGluWJvsmEioetZYN1JWElSMz3BbcH64bUuNbzwg==","shasum":"c83a2a7b7e62e258cb969360efaca1eaaf4d4498","tarball":"https://registry.npmjs.org/@codespar/mcp-chargebee/-/mcp-chargebee-0.1.2.tgz","fileCount":6,"unpackedSize":46993,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIALVxG7zmy/zsVS0l/CHi1+2poBDnmmoOhqPoGlZg4EtAiEAy1zFMFb/wprt7oNPkZ/w1PsC3vmTo7/vcJlMTDc4fR8="}]},"_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-chargebee_0.1.2_1782153807116_0.965837820296368"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T00:48:30.594Z","modified":"2026-06-22T18:43:27.628Z","0.1.0":"2026-04-24T00:48:30.880Z","0.1.1":"2026-04-25T13:19:36.919Z","0.1.2":"2026-06-22T18:43:27.325Z"},"license":"MIT","keywords":["mcp","chargebee","payments","subscriptions","billing","saas","recurring"],"description":"MCP server for Chargebee — global subscription billing, recurring revenue orchestration","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-chargebee\n\n> MCP server for **Chargebee** — global subscription billing orchestration\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-chargebee)](https://www.npmjs.com/package/@codespar/mcp-chargebee)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Why Chargebee in the CodeSpar catalog?\n\nChargebee is **subscription-billing orchestration on top of** payment gateways (Stripe, Adyen, Braintree, local LatAm acquirers). It handles plans, proration, dunning, tax, and revenue recognition — the SaaS monetization layer, not the card-processing layer.\n\nThe CodeSpar catalog already ships **Vindi** and **Iugu** for Brazil-native recurring billing. Chargebee complements (not overlaps) those: it is the global-SaaS pattern used by Platzi, Truora, and most US SaaS selling into LatAm. Zero feature overlap, different market.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"chargebee\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-chargebee\"],\n      \"env\": {\n        \"CHARGEBEE_SITE\": \"your-site\",\n        \"CHARGEBEE_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add chargebee -- npx @codespar/mcp-chargebee\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"chargebee\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-chargebee\"],\n      \"env\": {\n        \"CHARGEBEE_SITE\": \"your-site\",\n        \"CHARGEBEE_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Tools (15)\n\n| Tool | Purpose |\n|---|---|\n| `create_subscription` | Create a new subscription in Chargebee. |\n| `retrieve_subscription` | Retrieve a subscription by ID |\n| `update_subscription` | Update a subscription. |\n| `cancel_subscription` | Cancel a subscription. |\n| `reactivate_subscription` | Reactivate a cancelled or paused subscription |\n| `list_subscriptions` | List subscriptions. |\n| `create_customer` | Create a customer in Chargebee. |\n| `retrieve_customer` | Retrieve a customer by ID |\n| `update_customer` | Update a customer. |\n| `list_customers` | List customers. |\n| `retrieve_invoice` | Retrieve an invoice by ID |\n| `list_invoices` | List invoices with optional filters |\n| `create_payment_source_using_token` | Attach a payment source to a customer using a gateway token (e.g. |\n| `delete_payment_source` | Delete a payment source |\n| `list_events` | List webhook events. |\n\n## Authentication\n\nChargebee API v2 uses HTTP Basic with your API key as username and empty password. This package handles it automatically — just set `CHARGEBEE_API_KEY`.\n\nRequest bodies are sent as `application/x-www-form-urlencoded` (Chargebee's v2 convention). Nested objects and arrays are flattened to `parent[child]=value` / `parent[0][child]=value`.\n\n## Filter syntax\n\nChargebee uses `field[operator]=value` for list filters, e.g. `status[is]=active`, `email[is]=foo@bar.com`, `occurred_at[after]=1700000000`.\n\nPass these via the `filters` object on any `list_*` tool:\n\n```json\n{\n  \"filters\": {\n    \"status[is]\": \"active\",\n    \"plan_id[is]\": \"pro-monthly\"\n  }\n}\n```\n\nCommon list filters are also exposed as top-level conveniences (e.g. `list_invoices` accepts `customer_id`, `status` directly).\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `CHARGEBEE_SITE` | Yes | Site subdomain, e.g. `acme-test` for `acme-test.chargebee.com` |\n| `CHARGEBEE_API_KEY` | Yes | API key from Settings > API Keys (full-access or restricted) |\n\n## Sandbox / Testing\n\nEvery Chargebee account includes a free **test site** (`<your-site>-test.chargebee.com`). Use its API key for development — no charges flow to real gateways.\n\n### Get your credentials\n\n1. Sign up at [chargebee.com](https://www.chargebee.com)\n2. Your test site is created automatically (`<name>-test`)\n3. Go to Settings > API Keys and create a Full-Access or Read-Only key\n4. Set `CHARGEBEE_SITE` and `CHARGEBEE_API_KEY`\n\n## Roadmap\n\n### v0.2 (planned)\n- `create_invoice` — charge a customer outside of a subscription\n- `record_payment` — record offline payments\n- `create_coupon` / `list_coupons`\n- `create_plan` / `list_plans` / `create_addon`\n- `list_transactions`\n\n### v0.3 (planned)\n- `create_hosted_page_checkout` — generate Chargebee hosted checkout URLs\n- `retrieve_quote` / `convert_quote`\n- Revenue reporting helpers\n\nWant a tool sooner? [Open an issue](https://github.com/codespar/mcp-dev-latam/issues) or [PR](https://github.com/codespar/mcp-dev-latam).\n\n## Links\n\n- [Chargebee website](https://www.chargebee.com)\n- [Chargebee API docs](https://apidocs.chargebee.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-initiated subscription changes? [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"}