Mcp Chargebee

io.github.codesparPublished by GitHub account codesparv0.1.2Updated Oct 24, 2026

MCP server for Chargebee — global subscription billing, recurring revenue orchestration

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

A local MCP server that lets an assistant manage Chargebee subscription billing: subscriptions, customers, invoices, payment sources and webhook events.

What you can do
Create, retrieve, update, cancel, reactivate and list subscriptions, including filtering by status or plan via Chargebee filter syntax. Create, retrieve, update and list customers. Retrieve and list invoices with optional filters such as customer or status. Attach a payment source using a gateway token, or delete a payment source. List webhook events.
When to use it
Useful when you work with Chargebee as your SaaS subscription billing layer and want an assistant to look up or change subscriptions, customers, invoices or payment sources without opening the dashboard. Start against the free test site before touching live billing data.
Requirements
Runs locally via npx from the npm package @codespar/mcp-chargebee, so Node.js is needed. Requires the environment variables CHARGEBEE_SITE (site subdomain) and CHARGEBEE_API_KEY (full-access or restricted key from Settings > API Keys). Network access to Chargebee's API.
Before you install
The API key grants access to billing data; a full-access key can create, update, cancel and reactivate subscriptions and attach or delete payment sources, which affects real customers and charges. Prefer a read-only or restricted key and the test site for development. The key is passed in plain environment variables in client config files. Payment source tokens are handled by the server.

Installation

In SourceWeft

  1. Open Mcp Chargebee in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@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:

json
{  "mcpServers": {    "chargebee": {      "command": "npx",      "args": ["-y", "@codespar/mcp-chargebee"],      "env": {        "CHARGEBEE_SITE": "your-site",        "CHARGEBEE_API_KEY": "your-api-key"      }    }  }}

Claude Code

bash
claude mcp add chargebee -- npx @codespar/mcp-chargebee

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "chargebee": {      "command": "npx",      "args": ["-y", "@codespar/mcp-chargebee"],      "env": {        "CHARGEBEE_SITE": "your-site",        "CHARGEBEE_API_KEY": "your-api-key"      }    }  }}

Tools (15)

ToolPurpose
create_subscriptionCreate a new subscription in Chargebee.
retrieve_subscriptionRetrieve a subscription by ID
update_subscriptionUpdate a subscription.
cancel_subscriptionCancel a subscription.
reactivate_subscriptionReactivate a cancelled or paused subscription
list_subscriptionsList subscriptions.
create_customerCreate a customer in Chargebee.
retrieve_customerRetrieve a customer by ID
update_customerUpdate a customer.
list_customersList customers.
retrieve_invoiceRetrieve an invoice by ID
list_invoicesList invoices with optional filters
create_payment_source_using_tokenAttach a payment source to a customer using a gateway token (e.g.
delete_payment_sourceDelete a payment source
list_eventsList 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:

json
{  "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

VariableRequiredDescription
CHARGEBEE_SITEYesSite subdomain, e.g. acme-test for acme-test.chargebee.com
CHARGEBEE_API_KEYYesAPI 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

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

Source: packages/payments/chargebee/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts