@codespar/mcp-chargebee
MCP server for Chargebee — global subscription billing orchestration
Why Chargebee in the CodeSpar catalog?
Chargebee 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.
The 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.
Quick Start
Claude Desktop
Add to ~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"chargebee": {
"command": "npx",
"args": ["-y", "@codespar/mcp-chargebee"],
"env": {
"CHARGEBEE_SITE": "your-site",
"CHARGEBEE_API_KEY": "your-api-key"
}
}
}
}
Claude Code
claude mcp add chargebee -- npx @codespar/mcp-chargebee
Cursor / VS Code
Add to .cursor/mcp.json or .vscode/mcp.json:
{
"servers": {
"chargebee": {
"command": "npx",
"args": ["-y", "@codespar/mcp-chargebee"],
"env": {
"CHARGEBEE_SITE": "your-site",
"CHARGEBEE_API_KEY": "your-api-key"
}
}
}
}
| Tool | Purpose |
|---|
create_subscription | Create a new subscription in Chargebee. |
retrieve_subscription | Retrieve a subscription by ID |
update_subscription | Update a subscription. |
cancel_subscription | Cancel a subscription. |
reactivate_subscription | Reactivate a cancelled or paused subscription |
list_subscriptions | List subscriptions. |
create_customer | Create a customer in Chargebee. |
retrieve_customer | Retrieve a customer by ID |
update_customer | Update a customer. |
list_customers | List customers. |
retrieve_invoice | Retrieve an invoice by ID |
list_invoices | List invoices with optional filters |
create_payment_source_using_token | Attach a payment source to a customer using a gateway token (e.g. |
delete_payment_source | Delete a payment source |
list_events | List webhook events. |
Authentication
Chargebee API v2 uses HTTP Basic with your API key as username and empty password. This package handles it automatically — just set CHARGEBEE_API_KEY.
Request 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.
Filter syntax
Chargebee uses field[operator]=value for list filters, e.g. status[is]=active, email[is]=foo@bar.com, occurred_at[after]=1700000000.
Pass these via the filters object on any list_* tool:
{
"filters": {
"status[is]": "active",
"plan_id[is]": "pro-monthly"
}
}
Common list filters are also exposed as top-level conveniences (e.g. list_invoices accepts customer_id, status directly).
Environment Variables
| Variable | Required | Description |
|---|
CHARGEBEE_SITE | Yes | Site subdomain, e.g. acme-test for acme-test.chargebee.com |
CHARGEBEE_API_KEY | Yes | API key from Settings > API Keys (full-access or restricted) |
Sandbox / Testing
Every Chargebee account includes a free test site (<your-site>-test.chargebee.com). Use its API key for development — no charges flow to real gateways.
Get your credentials
- Sign up at chargebee.com
- Your test site is created automatically (
<name>-test)
- Go to Settings > API Keys and create a Full-Access or Read-Only key
- Set
CHARGEBEE_SITE and CHARGEBEE_API_KEY
Roadmap
v0.2 (planned)
create_invoice — charge a customer outside of a subscriptionrecord_payment — record offline paymentscreate_coupon / list_couponscreate_plan / list_plans / create_addonlist_transactions
v0.3 (planned)
create_hosted_page_checkout — generate Chargebee hosted checkout URLsretrieve_quote / convert_quote- Revenue reporting helpers
Want a tool sooner? Open an issue or PR.
Links
Enterprise
Need governance, budget limits, and audit trails for agent-initiated subscription changes? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
License
MIT