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

Tools (15)

| 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][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

| 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

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 Brasil
• 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