Skip to main content
C

Chargebee

@codespar/mcp-chargebee Β· v0.1.2

🌐 GlobalPaymentsAuth · API Keybeta15 tools2 env vars

Global subscription-billing orchestration used by LatAm SaaS (Platzi, Truora). Stripe-style subscription logic on top of local gateways. Zero overlap with Vindi/Iugu β€” this is the global-SaaS pattern.

Get started Β· freeView docs

MIT Β· runs locally with your own credentials

Package
@codespar/mcp-chargebee
Version
0.1.2
npm dist-tag
latest
Category
Payments
Auth
API Key
Country
🌐 Global
License
MIT
Transport
stdio Β· streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables2 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 15 tools. Try create_subscription first.
terminal
# Claude Code claude mcp add chargebee -e CHARGEBEE_API_KEY=… -e CHARGEBEE_SITE=… -- npx -y @codespar/mcp-chargebee@0.1.2 # then: /mcp to confirm the server is connected
Environment variables2 variables
CHARGEBEE_API_KEYChargebee API key (full-access or restricted) from Settings > API Keysrequiredsecret
CHARGEBEE_SITEChargebee site subdomain (e.g. 'acme' for acme.chargebee.com, 'acme-test' for test site)required

Names read from the package code (@codespar/mcp-chargebee@0.1.2). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call democreate_subscription

"Create a new subscription in Chargebee. Provide either a nested `customer` object"

tools/callcreate_subscriptionresult returned

Tools

What your agent can call.

15 tools, as the package's tools/list returns them.

create_subscription

Create a new subscription in Chargebee. Provide either a nested `customer` object (with email/first_name/last_name) for a new customer, or pass an existing `customer_id` via nested customer or top-level field.

retrieve_subscription

Retrieve a subscription by ID

update_subscription

Update a subscription. Accepts any Chargebee subscription fields (plan_id, plan_quantity, coupon_ids, addons, billing_cycles, etc.)

cancel_subscription

Cancel a subscription. By default cancels immediately; set end_of_term=true to cancel at period end.

reactivate_subscription

Reactivate a cancelled or paused subscription

list_subscriptions

List subscriptions. Pass filters as a free-form object using Chargebee's field[operator]=value format, e.g. { "status[is]": "active", "customer_id[is]": "cust_123" }.

create_customer

Create a customer in Chargebee. At least one of email, first_name, or last_name is required.

retrieve_customer

Retrieve a customer by ID

update_customer

Update a customer. Accepts any customer fields.

list_customers

List customers. Pass filters in Chargebee's field[operator]=value format.

retrieve_invoice

Retrieve an invoice by ID

list_invoices

List invoices with optional filters

Names and descriptions come from the package's tools/list (@codespar/mcp-chargebee@0.1.2). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

The CodeSpar runtime does not route this server. Mount it in your client over stdio Β· streamable-http.

Protocol

Any MCP client

stdio Β· streamable-http

Questions

Before you install.

How do I install the Chargebee MCP server?

Run npx -y @codespar/mcp-chargebee@0.1.2 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Chargebee?

Chargebee exposes 15 tools for payments. Your agent calls them directly; the full list is above.

How does Chargebee authenticate, and how are credentials stored?

Chargebee uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Chargebee handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.1.2, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Chargebee open source? How do I report a bug?

Yes. Chargebee is MIT-licensed and published on npm as @codespar/mcp-chargebee, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
Chargebee β€” MCP server Β· 15 tools | CodeSpar