Mcp Chargebee

@codespar/mcp-chargebee

MCP server for Chargebee — global subscription billing orchestration

[npm] [License: MIT]

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"      }    }  }}

Tools (15)

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][email protected], 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

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

1. Sign up at chargebee.com
2. Your test site is created automatically (<name>-test)
3. Go to Settings > API Keys and create a Full-Access or Read-Only key
4. Set CHARGEBEE_SITE and CHARGEBEE_API_KEY

Roadmap

v0.2 (planned)

• create_invoice — charge a customer outside of a subscription
• record_payment — record offline payments
• create_coupon / list_coupons
• create_plan / list_plans / create_addon
• list_transactions

v0.3 (planned)

• create_hosted_page_checkout — generate Chargebee hosted checkout URLs
• retrieve_quote / convert_quote
• Revenue reporting helpers

Want a tool sooner? Open an issue or PR.

Links

• Chargebee website
• Chargebee API docs
• MCP Dev LATAM
• Landing page

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