Jake Shore e4a40298e4 Full cleanup: 65 servers compile clean, 15 new builds, TSC fixes across all existing servers

- Built from scratch: apollo, chargebee, datadog, greenhouse, lever, loom, pandadoc, salesloft, sendgrid, supabase, typeform, webflow, zoho-crm, twilio, reonomy
- TSC fixes: brevo, google-console, housecall-pro, meta-ads, rippling, bamboohr, close, fieldedge, freshdesk, helpscout, toast, touchbistro, hubspot, notion, quickbooks, airtable, gusto, intercom, linear, monday, salesforce, shopify, square, wave, xero
- Entry points added: close, touchbistro
- All 65 active servers compile with 0 TypeScript errors
- 4 specialty servers skipped (competitor-research, compliance-grc, n8n-apps, product-analytics)

2026-02-14 04:37:01 -05:00

4.3 KiB

Raw Blame History

Chargebee MCP Server

MCP server for the Chargebee subscription billing platform, providing comprehensive tools for managing subscriptions, customers, invoices, plans, coupons, and credit notes.

Features

Subscription Management - Create, update, cancel, and reactivate subscriptions
Customer Database - Manage customer records and billing information
Invoice Handling - Generate invoices, track payments, and manage billing
Plan & Addon Management - Browse and configure pricing plans
Coupon System - Create and manage promotional discounts
Credit Notes - Issue refunds and account credits

Installation

npm install
npm run build

Configuration

Set your Chargebee credentials as environment variables:

export CHARGEBEE_SITE_NAME="your-site-name"
export CHARGEBEE_API_KEY="your_api_key_here"

Usage

Run the server:

npm start
# or
node dist/index.js

Available Tools (24 total)

Subscriptions (6 tools)

list_subscriptions - Browse all subscriptions with pagination
get_subscription - Get detailed subscription information
create_subscription - Start new customer subscriptions
update_subscription - Modify existing subscriptions
cancel_subscription - Cancel subscriptions (immediate or end-of-term)
reactivate_subscription - Restore cancelled subscriptions

Customers (5 tools)

list_customers - Browse customer database
get_customer - Get detailed customer information
create_customer - Add new customers
update_customer - Modify customer details
delete_customer - Remove customers (GDPR compliance)

Invoices (3 tools)

list_invoices - Browse invoice history
get_invoice - Get detailed invoice with line items
create_invoice - Generate one-time invoices

Plans & Addons (4 tools)

list_plans - Browse subscription plans
get_plan - Get detailed plan configuration
list_addons - Browse available add-ons
get_addon - Get detailed add-on information

Coupons (3 tools)

list_coupons - Browse promotional codes
get_coupon - Get coupon details and usage stats
create_coupon - Create new discount coupons

Credit Notes (3 tools)

list_credit_notes - Browse refunds and credits
get_credit_note - Get detailed credit note information
create_credit_note - Issue refunds or account credits

API Coverage Manifest

Total Chargebee API Endpoints: ~200+
Implemented in this server: 24
Coverage: ~12%

Covered Areas:

✅ Core subscription lifecycle
✅ Customer management
✅ Invoice generation and tracking
✅ Plan and addon configuration
✅ Coupon management
✅ Credit note issuance

Not Yet Implemented:

⏳ Payment sources and gateways
⏳ Hosted pages configuration
⏳ Quotes and estimates
⏳ Unbilled charges
⏳ Promotional credits
⏳ Transactions and refunds
⏳ Events and webhooks
⏳ Tax configuration
⏳ Dunning management
⏳ Reports and analytics
⏳ Import/export operations
⏳ Portal sessions
⏳ Gift subscriptions
⏳ Item prices (Product Catalog 2.0)

Architecture

chargebee/
├── src/
│   ├── index.ts                    # MCP server entry point
│   ├── client/
│   │   └── chargebee-client.ts    # API client with rate limiting
│   ├── tools/
│   │   ├── subscriptions.ts       # Subscription tools
│   │   ├── customers.ts           # Customer tools
│   │   ├── invoices.ts            # Invoice tools
│   │   ├── plans.ts               # Plan & addon tools
│   │   ├── coupons.ts             # Coupon tools
│   │   └── credit_notes.ts        # Credit note tools
│   └── types/
│       └── index.ts               # TypeScript interfaces
├── package.json
├── tsconfig.json
└── README.md

Rate Limiting

The client implements automatic rate limiting:

Max 10 concurrent requests
Minimum 100ms between requests
Automatic retry on 429 responses

Error Handling

The server provides detailed error messages for:

Authentication failures (401)
Payment required (402)
Permission issues (403)
Resource not found (404)
Bad request/validation (400)
Rate limit exceeded (429)
Server errors (500+)

License

MIT

4.3 KiB Raw Blame History