New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates

  • Release Notes

Getting Started

  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee

  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

Agentic AI

  • Chargebee Copilot
  • MCP Servers
    • Knowledge Base MCP Server
    • Data Lookup MCP Server
    • Onboarding MCP Server
    • Custom MCP Server

Developer Resources

  • Developer Resources Overview
  • API Explorer
  • Articles and FAQ

Product Catalog

  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions

  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers

  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements

  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing

  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Prepaid credits
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ

  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes

  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes

  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities

  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration

  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity

  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions

  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics

  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations

  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • eInvoicing
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security

  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations

  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  3. Agentic AI
  5. MCP Servers
  6. Custom MCP Server
  1. Billing
  3. Agentic AI
  5. MCP Servers
  6. Custom MCP Server

Custom MCP Server

Overview

Custom MCP servers let you combine tools from Chargebee's full tool catalog into a server tailored to your use case—for example, an invoice lookup server that exposes only the subscription and invoice tools your AI client needs. For an overview of Chargebee MCP servers, see Chargebee MCP Servers.

Unlike the predefined Knowledge Base, Data Lookup, and Onboarding MCP servers, custom servers let you pick any combination of available tools.

Custom MCP servers require Latest Product Catalog. They are not available on sites using Legacy Product Catalog.

Note

Custom MCP servers are available only for test and sandbox sites. They are not available for live sites.

Create a custom MCP server

  1. Log in to Chargebee Billing.
  2. Navigate to Settings > Configure Chargebee > Agentic AI > MCP Servers.
    Agentic AI menu
  3. In the Custom MCP servers section, click + Create custom server.
    MCP Servers page with Custom MCP servers section
  4. In the Create MCP server dialog, enter a Server name and Description, then click Create.
    Create MCP server dialog
  5. You are redirected to the new server's Toolsets tab. The Add tools sidebar opens automatically.
  6. Search or browse toolsets, select the tools you need, then click Add tools.
    Add tools sidebar with toolset list
  7. Selected tools appear grouped by toolset on the Toolsets tab.

Manage tools

To add more tools later, click + Add tools on the Toolsets tab and repeat the selection flow.

Toolsets tab with Add tools control

Turn on or turn off individual tools using the toggle next to each tool.

Custom MCP server toolsets with per-tool toggles

Access and authentication

Under the Access & Authentication tab, turn on the MCP Access toggle to allow external AI clients to access this server via MCP.

Custom MCP server access and authentication

Server URLs

Under MCP Server URL, you'll find the server URL for this MCP server for your Chargebee site. The URL slug is derived from the server name you provided—for example, a server named invoice lookup mcp server uses the slug invoice_lookup_mcp_server. Depending on your site's data center, you will see a URL in one of the following formats:

US data center

https://YOUR-CHARGEBEE-SUBDOMAIN.mcp.chargebee.com/YOUR-CUSTOM-SERVER-SLUG

EU data center

https://YOUR-CHARGEBEE-SUBDOMAIN.mcp.eu.chargebee.com/YOUR-CUSTOM-SERVER-SLUG

AU data center

https://YOUR-CHARGEBEE-SUBDOMAIN.mcp.au.chargebee.com/YOUR-CUSTOM-SERVER-SLUG

Authentication

Choose how external AI clients authenticate with this MCP server. The tools available may vary depending on the selected authentication method.

Best practices

  • Enable only the servers and toolsets your organization needs
  • Rotate keys and OAuth credentials periodically
  • Ensure that systems accessing the MCP servers have appropriate customer data protection measures in place

API Key

The API Key method grants access to all enabled tools in this server and is best suited for:

  • Server-to-server integrations
  • Internal automations
  • Trusted development environments

You can create up to 5 API keys for this server.

Authentication API key

Clients authenticate by sending the API key in request headers:

Authorization: Bearer YOUR-API-KEY

Configuration code snippets for API key are available for some of the commonly used AI clients.

OAuth

The OAuth method provides user-based access. Among the enabled toolsets for the MCP server, the tool access is further limited by the signed-in Chargebee user's access level in Chargebee. OAuth is best suited for:

  • User-facing AI clients
  • Shared developer tools
  • Integrations where access should reflect your user's access level in Chargebee
Authentication OAuth

Configuration code snippets for OAuth are available for some of the commonly used AI clients.

Use the same OAuth client ID for users of the same MCP client. For example, if you have 100 Claude Code users, you can generate one OAuth client ID and share it with all 100 users. Claude Code (or any other MCP client) will then direct them to the Chargebee Billing login page. Once signed in, they will be redirected back to the MCP client, and their MCP access will be limited by their Chargebee user access level.

See also

  • Chargebee Knowledge Base MCP Server: Answer questions using Chargebee docs and API references.
  • Chargebee Data Lookup MCP Server: Retrieve customer, subscription, invoice, and payment data from your Chargebee site.
  • Onboarding MCP Server: Create product catalogs and generate demo data for test and sandbox sites.

Was this article helpful?