ChartMogul MCP Server
OfficialProvides tools for interacting with the ChartMogul API, enabling management of customer data, subscription metrics (MRR, ARR), sales opportunities, plans, contacts, and invoices.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ChartMogul MCP Server What is our current MRR and churn rate?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ChartMogul's MCP Server
Supported Tools
Account & Data Sources
retrieve_account- Get account informationlist_sources- List all data sources with optional filteringretrieve_source- Get specific data source by UUID
Customer Management
list_customers- List customers with filtering optionssearch_customers- Search customers by emailretrieve_customer- Get customer by UUIDcreate_customer- Create new customerupdate_customer- Update customer attributeslist_customer_subscriptions- Get customer's subscriptionslist_customer_activities- Get customer activitieslist_customer_attributes- Get customer attributesadd_customer_tags- Add tags to customeradd_customer_custom_attributes- Add custom attributes to customer
Contacts
list_contacts- List all contactsretrieve_contact- Get contact by UUIDcreate_contact- Create new contactupdate_contact- Update contact information
Customer Notes
list_customer_notes- List customer notes and callsretrieve_customer_note- Get specific note by UUIDcreate_customer_note- Create new note or call logupdate_customer_note- Update existing note
Sales & CRM
list_opportunities- List sales opportunitiesretrieve_opportunity- Get opportunity by UUIDcreate_opportunity- Create new opportunityupdate_opportunity- Update opportunity detailslist_tasks- List customer tasksretrieve_task- Get task by UUIDcreate_task- Create new taskupdate_task- Update task information
Plans
list_plans- List subscription plansretrieve_plan- Get plan by UUIDcreate_plan- Create new planupdate_plan- Update plan detailslist_plan_groups- List plan groupsretrieve_plan_group- Get plan group by UUIDcreate_plan_group- Create new plan groupupdate_plan_group- Update plan grouplist_plan_group_plans- List plans in a group
Analytics & Metrics
all_metrics- Get all key metrics (MRR, ARR, ARPA, ASP, customer count, churn rates, LTV)mrr_metrics- Get Monthly Recurring Revenue metricsarr_metrics- Get Annual Run Rate metricsarpa_metrics- Get Average Revenue Per Account metricsasp_metrics- Get Average Sale Price metricscustomer_count_metrics- Get customer count metricscustomer_churn_rate_metrics- Get customer churn rate metricsmrr_churn_rate_metrics- Get MRR churn rate metricsltv_metrics- Get Customer Lifetime Value metrics
Data Operations
list_subscription_events- List subscription eventscreate_subscription_event- Create new subscription eventupdate_subscription_event- Update subscription event detailslist_invoices- List invoices with filteringimport_invoices- Create new invoiceretrieve_invoice- Get invoice by UUIDlist_activities- List business activities (new_biz, expansion, churn, etc.)
Related MCP server: stripe-analytics-mcp
Usage
Open the Claude Desktop configuration file located at:
On macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonOn Windows:
%APPDATA%/Claude/claude_desktop_config.json
Add the following:
{
"mcpServers": {
"mcp-chartmogul": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/local/chartmogul-mcp-server",
"run",
"main.py"
],
"env": {
"CHARTMOGUL_TOKEN": "<YOUR-CHARTMOGUL-TOKEN>"
}
}
}
}Run
which uvto locate the command entry foruvand replace it with the absolute path to theuvexecutable.Restart Claude Desktop to apply the changes.
Development
Run
cp example.env .envin the root of the repository to create a.envfile.Update it with the following env variables.
CHARTMOGUL_TOKEN=<YOUR-CHARTMOGUL-TOKEN>Install
uvby following the instructions here.Run
uv syncto install the dependencies.Run
source .venv/bin/activateto activate the created virtual environment.Run
mcp dev main.py:cm_mcpto start the development MCP server. This command will need Node.js and npm installation.Inspect and connect to the MCP server at http://127.0.0.1:6274
Available Tools
55 toolsadd_customer_custom_attributesA
[ChartMogul API] Add custom attributes to customer. Each attribute needs: type (string: "String", "Integer", "Decimal", "Timestamp", "Boolean"), key (string: alphanumeric + underscores), value (matching type), optional source (string: defaults to "API"). Provide as array of attribute objects. Custom types details: String (max 255 characters), Integer (numeric only), Decimal (floating point), Timestamp (ISO 8601 format), Boolean (TRUE/true/t/1/FALSE/false/f/0). Returns updated custom attributes. REQUIRED: uuid (string: customer UUID), custom_attributes (array: objects like [{"type": "String", "key": "channel", "value": "Facebook", "source": "integration"}])
Inputs: uuid (required), custom_attributes (required).
add_customer_tagsA
[ChartMogul API] Add tags to customer (idempotent - no duplicates created). Provide tags as array of strings. New tags added to existing ones. Returns updated tags object. REQUIRED: uuid (string: customer UUID), tags (array: strings like ["vip", "priority"])
Inputs: uuid (required), tags (required).
all_metricsA
[ChartMogul API] Retrieve all key metrics for time period. CRITICAL: ALL MONETARY VALUES (mrr, arr, arpa, asp, ltv) ARE INTEGER CENTS - DIVIDE BY 100 FOR ACTUAL CURRENCY. Returns entries array with: date (string: YYYY-MM-DD), mrr (integer cents), mrr_percentage_change (float), arr (integer cents), arr_percentage_change (float), customer_churn_rate (float percentage), customer_churn_rate_percentage_change (float), mrr_churn_rate (float percentage), mrr_churn_rate_percentage_change (float), ltv (integer cents), ltv_percentage_change (float), customers (integer count), customers_percentage_change (float), asp (integer cents), asp_percentage_change (float), arpa (integer cents), arpa_percentage_change (float). Plus summary object with current/previous/percentage_change for each metric. REQUIRED: start_date (string: YYYY-MM-DD), end_date (string: YYYY-MM-DD), interval (string: "day", "week", "month", "quarter", "year"). OPTIONAL: geo (string: ISO 3166-1 Alpha-2 comma-separated like "US,GB,DE"), plans (string: plan names/UUIDs/external_ids comma-separated, URL-encode spaces like "Silver%20plan,Gold%20plan,pl_abc123,enterprise_plan"), filters (string: CFL-formatted expressions using tilde separators. Syntax: fieldoperatorvalueANDfieldoperatorvalue. Common fields: mrr, currency, region, customer_status, plan, tags, custom.attribute_name. Operators: ANY/ALL/NONE (sets), EQ/NOT_EQ, GT/GTE/LT/LTE (comparison), CONTAINS/NOT_CONTAINS (strings), IS/IS_NOT (nulls). Examples: "currencyANY'USD','EUR'", "mrrGT1000ANDregionANY'US'", "customer_statusANY'active'ANDtagsANY'vip'". Use get_cfl_fields tool for complete field list). Example: mrr=36981972 means $369,819.72
Inputs: start_date (required), end_date (required), interval (required), geo, +2 more.
arpa_metricsA
[ChartMogul API] Retrieve Average Revenue Per Account metrics. CRITICAL: ARPA VALUES ARE INTEGER CENTS - DIVIDE BY 100 FOR ACTUAL CURRENCY AMOUNTS. ARPA = Total MRR / Total Customers. Returns entries array with: date (string), arpa (integer cents), arpa_percentage_change (float). Plus summary object. REQUIRED: start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), interval ("day", "week", "month", "quarter", "year"). OPTIONAL: geo, plans, filters (string: CFL syntax fieldoperatorvalueAND... Use get_cfl_fields for field list). Example: arpa=84767 means $847.67 average revenue per account
Inputs: start_date (required), end_date (required), interval (required), geo, +2 more.
arr_metricsA
[ChartMogul API] Retrieve Annual Recurring Revenue metrics. CRITICAL: ARR VALUES ARE INTEGER CENTS - DIVIDE BY 100 FOR ACTUAL CURRENCY AMOUNTS. ARR = MRR × 12. Returns entries array with: date (string), arr (integer cents), arr_percentage_change (float). Plus summary object. REQUIRED: start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), interval ("day", "week", "month", "quarter", "year"). OPTIONAL: geo, plans, filters (string: CFL syntax fieldoperatorvalueAND... Use get_cfl_fields for field list). Example: arr=4076455668 means $40,764,556.68
Inputs: start_date (required), end_date (required), interval (required), geo, +2 more.
asp_metricsA
[ChartMogul API] Retrieve Average Sale Price metrics. CRITICAL: ASP VALUES ARE INTEGER CENTS - DIVIDE BY 100 FOR ACTUAL CURRENCY AMOUNTS. ASP = Average first invoice amount of new customers. Returns entries array with: date (string), asp (integer cents), asp_percentage_change (float). Plus summary object. REQUIRED: start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), interval (string: "month", "quarter", "year" ONLY - day/week NOT supported). OPTIONAL: geo, plans, filters (string: CFL syntax fieldoperatorvalueAND... Use get_cfl_fields for field list). Example: asp=152454 means $1,524.54 average sale price
Inputs: start_date (required), end_date (required), interval (required), geo, +2 more.
create_contactB
[ChartMogul API] Create new contact. REQUIRED: customer_uuid (string), data_source_uuid (string). OPTIONAL: first_name (string), last_name (string), position (integer), title (string), email (string), phone (string), linked_in (string: URL), twitter (string: URL), notes (string), custom (array: key-value objects). All fields in data dict. Returns created contact object.
Inputs: data (required).
create_customerA
[ChartMogul API] Create new customer. REQUIRED: data_source_uuid (string: ds_ prefix), external_id (string: your system ID). OPTIONAL: company (string), country (string: ISO-3166 alpha-2 like "US", "DE"), state (string: US states ISO-3166-2 like "US-CA", "US-NY"), city (string), zip (string), lead_created_at (string: ISO 8601 datetime in past), free_trial_started_at (string: ISO 8601), attributes (object with tags array and custom array), owner (string: email), primary_contact (object with first_name, last_name, email, title, phone, linked_in, twitter, notes), website_url (string). Custom attributes format: array of objects with type/key/value/source. Custom types: String (max 255 chars), Integer, Decimal, Timestamp (ISO 8601), Boolean. All fields in data dict. Returns created customer object.
Inputs: data (required).
create_customer_noteA
[ChartMogul API] Create customer note/call log. REQUIRED: customer_uuid (string), type (string: "call" or "note"). OPTIONAL: author_email (string), text (string), call_duration (integer: seconds for type "call"), created_at (string: ISO 8601). All fields in data dict. Returns created note object.
Inputs: data (required).
create_opportunityA
[ChartMogul API] Create sales opportunity. REQUIRED: customer_uuid (string), owner (string: email), pipeline (string), pipeline_stage (string), estimated_close_date (string: YYYY-MM-DD), amount_in_cents (integer: amount in cents), currency (string: "USD", "EUR", "GBP"). OPTIONAL: type (string: "recurring" or "one-time"), forecast_category (string: "pipeline", "best_case", "committed", "lost", "won"), win_likelihood (integer: 0-100), custom (object: key-value pairs). All fields in data dict. Returns created opportunity object.
Inputs: data (required).
create_planA
[ChartMogul API] Create subscription plan. REQUIRED: data_source_uuid (string), name (string), interval_count (integer >0: billing frequency), interval_unit (string: "day", "month", "year"). OPTIONAL: external_id (string). All fields in data dict. Returns created plan object.
Inputs: data (required).
create_plan_groupC
[ChartMogul API] Create plan group. REQUIRED: name (string), plans (array: plan UUIDs to include). All fields in data dict. Returns created plan group object.
Inputs: data (required).
create_subscription_eventA
[ChartMogul API] Create subscription event for Custom API data sources. Used to track subscription lifecycle changes. Provide subscription_event object with: external_id (string), customer_external_id (string), data_source_uuid (string), event_type (string: from list above), event_date (string: ISO 8601), effective_date (string: ISO 8601), subscription_external_id (string), and other event-specific fields like plan_uuid, quantity. Returns created subscription event object.
Inputs: data (required).
create_taskB
[ChartMogul API] Create CRM task. REQUIRED: customer_uuid (string), task_details (string: max 255 chars), assignee (string: email), due_date (string: ISO 8601 date). OPTIONAL: completed_at (string: ISO 8601 date). All fields in data dict. Returns created task object.
Inputs: data (required).
customer_churn_rate_metricsA
[ChartMogul API] Retrieve customer churn rate metrics as percentage. Customer Churn Rate = (Churned Customers / Total Customers at Start) × 100. Returns entries array with: date (string), customer_churn_rate (float percentage), customer_churn_rate_percentage_change (float). Plus summary object. REQUIRED: start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), interval ("day", "week", "month", "quarter", "year"). OPTIONAL: geo, plans, filters (string: CFL syntax fieldoperatorvalueAND... Use get_cfl_fields for field list). Example: customer_churn_rate=3.9 means 3.9% customer churn rate
Inputs: start_date (required), end_date (required), interval (required), geo, +2 more.
customer_count_metricsA
[ChartMogul API] Retrieve customer count metrics (total active customers over time). Returns entries array with: date (string), customers (integer count), customers_percentage_change (float). Plus summary object. REQUIRED: start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), interval ("day", "week", "month", "quarter", "year"). OPTIONAL: geo, plans, filters (string: CFL syntax fieldoperatorvalueAND... Use get_cfl_fields for field list). Example: customers=382 means 382 active customers
Inputs: start_date (required), end_date (required), interval (required), geo, +2 more.
get_cfl_fieldsA
[ChartMogul Reference] Get comprehensive list of ChartMogul Filtering Language (CFL) fields and operators. Returns complete documentation for filtering metrics endpoints. Use this tool when you need to know what fields are available for the filters parameter in metrics endpoints, their types, supported operators, and examples. Returns: CFL syntax rules, complete field-by-field reference with all operators and value formats, and practical examples.
Inputs: no named parameters.
import_invoicesA
[ChartMogul API] Import invoices for customer (add historical billing data). Provide invoices data structure with invoices array containing invoice objects: external_id (string), date (string: ISO 8601), currency (string: 3-letter code), due_date (string: ISO 8601), customer_external_id (string), data_source_uuid (string), line_items (array: objects with type ("subscription" or "one_time"), subscription_external_id, subscription_set_external_id, plan_uuid, service_period_start, service_period_end, amount_in_cents (integer), prorated (boolean), proration_type ("differential"), quantity (integer), discount_code, discount_amount_in_cents (integer), tax_amount_in_cents (integer), transaction_fees_in_cents (integer), transaction_fees_currency, discount_description), transactions (array: objects with external_id, type ("payment" or "refund"), date (ISO 8601), result ("successful" or "failed"), amount_in_cents (integer)). Use for Custom API data sources. Returns import summary with created invoices and errors. REQUIRED: data (dict), uuid (string: customer UUID)
Inputs: data (required), uuid (required).
list_activitiesA
[ChartMogul API] List customer activities across all customers (revenue movements: new subscriptions, upgrades, downgrades, churn). LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns activity objects with: id (integer), date (string: ISO 8601 datetime), activity_type (string), description (string), activity_mrr_movement (INTEGER CENTS: change amount), activity_mrr (INTEGER CENTS: total MRR after change), activity_arr (INTEGER CENTS: total ARR), subscription_external_id (string), plan_external_id (string), customer_name (string), customer_uuid (string), customer_external_id (string), billing_connector_type (string). CRITICAL: All monetary values are INTEGER CENTS - divide by 100. Example: activity_mrr_movement=5000 means $50.00 increase, activity_mrr=15000 means $150.00 total. FILTERS: start_date (ISO 8601 datetime), end_date (ISO 8601 datetime), type (string: "new_biz", "reactivation", "expansion", "contraction", "churn"), order (string: "-date" for descending, "date" for ascending). Response includes cursor/has_more.
Inputs: start_date, end_date, type, order, +1 more.
list_contactsA
[ChartMogul API] List contacts (individuals associated with customers). LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns contact objects with: uuid (string: contact UUID), customer_uuid (string), customer_external_id (string), data_source_uuid (string), first_name (string), last_name (string), position (integer: ordering), email (string), phone (string), linked_in (string: URL), twitter (string: URL), notes (string), custom (array: key-value objects). FILTERS: email (string), customer_external_id (string). Response includes cursor/has_more. Example filters: email="[email protected]", customer_external_id="cus_001"
Inputs: email, customer_external_id, limit.
list_customer_activitiesA
[ChartMogul API] List customer activities (subscription lifecycle events). LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns activity objects with: id (integer), date (ISO 8601 datetime), activity_type (string), description (string), activity_mrr_movement (INTEGER CENTS: change amount), activity_mrr (INTEGER CENTS: total MRR after change), activity_arr (INTEGER CENTS: total ARR), subscription_external_id (string), plan_external_id (string), customer_name (string), customer_uuid (string), customer_external_id (string), billing_connector_type (string). CRITICAL: All monetary values are INTEGER CENTS - divide by 100. Example: activity_mrr=5000 means $50.00. REQUIRED: uuid (string: customer UUID)
Inputs: uuid (required), limit.
list_customer_attributesB
[ChartMogul API] Retrieve customer attributes (tags and custom attributes). Returns attributes object with: tags (array of strings like ["vip", "enterprise"]), custom (object with key-value pairs containing type, key, value, source for each attribute like {"CAC": 213, "channel": "Facebook", "pro": true}), stripe (object with Stripe metadata), clearbit (object with company enrichment data). REQUIRED: uuid (string: customer UUID)
Inputs: uuid (required).
list_customer_notesA
[ChartMogul API] List customer notes and call logs. LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns note objects with: uuid (string: note UUID), customer_uuid (string), type (string: "note" or "call"), author (string), text (string), call_duration (integer: seconds for type "call"), created_at (ISO 8601 datetime), updated_at (ISO 8601 datetime). FILTERS: customer_uuid (string), type (string: "note" or "call"). Response includes cursor/has_more. Example: type="call", customer_uuid="cus_123..."
Inputs: customer_uuid, type, limit.
list_customersA
[ChartMogul API] List customers with optional filtering. LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns customer objects with: id (integer: internal ChartMogul ID), uuid (string: customer UUID with cus_ prefix), external_id (string: your system ID), name (string: customer/company name), email (string), status (string: New_Lead/Working_Lead/Qualified_Lead/Unqualified_Lead/Active/Past_Due/Cancelled), customer_since (ISO 8601 datetime), attributes (object with tags array of strings and custom object with key-value pairs), address (object with address_zip, city, state, country), data_source_uuid (string), data_source_uuids (array), external_ids (array), company (string), country (string: ISO-3166 alpha-2), state (string), city (string), zip (string), lead_created_at (ISO 8601 datetime or null), free_trial_started_at (ISO 8601 datetime or null), mrr (INTEGER CENTS - divide by 100 for actual amount), arr (INTEGER CENTS - divide by 100), billing_system_url (string), chartmogul_url (string), billing_system_type (string), currency (string), currency_sign (string). FILTERS: data_source_uuid (string), external_id (string), status (string: exact match from status values above), system (string: billing system type, case-sensitive). Response includes cursor (string) and has_more (boolean) for pagination. Example: status="Active", system="Stripe"
Inputs: data_source_uuid, external_id, status, system, +1 more.
list_customer_subscriptionsA
[ChartMogul API] List customer subscriptions. Default limit 20 (discourage >20). Returns subscription objects with: id (integer), external_id (string), plan (string: plan name), quantity (integer), uuid (string: subscription UUID), mrr (INTEGER CENTS), arr (INTEGER CENTS), status (string: "active" or "inactive"), billing_cycle (string: "day", "month", "year"), billing_cycle_count (integer), start_date (ISO 8601 datetime), end_date (ISO 8601 datetime), currency (string), currency_sign (string). CRITICAL: mrr/arr are INTEGER CENTS - divide by 100. Example: mrr=70800 means $708.00. Response includes cursor/has_more. REQUIRED: uuid (string: customer UUID)
Inputs: uuid (required), limit.
list_invoicesA
[ChartMogul API] List invoices (contain line items generating subscription revenue). LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns invoice objects with: uuid (string: invoice UUID with inv_ prefix), customer_uuid (string), external_id (string), date (string: ISO 8601), due_date (string: ISO 8601), currency (string: 3-letter code), line_items (array: line item objects with uuid, external_id, type ("subscription" or "one_time"), subscription_uuid, subscription_external_id, subscription_set_external_id, plan_uuid, prorated (boolean), service_period_start, service_period_end, amount_in_cents (integer), quantity (integer), discount_code, discount_amount_in_cents (integer), tax_amount_in_cents (integer), transaction_fees_in_cents (integer), transaction_fees_currency, discount_description, event_order (integer), account_code), transactions (array: transaction objects with uuid, external_id, type ("payment" or "refund"), date, result ("successful" or "failed"), amount_in_cents (integer)). FILTERS: data_source_uuid, external_id, customer_uuid, validation_type ("valid", "invalid", "all"). Response includes cursor/has_more.
Inputs: data_source_uuid, external_id, customer_uuid, validation_type, +1 more.
list_opportunitiesA
[ChartMogul API] List sales opportunities (CRM feature). LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns opportunity objects with: uuid (string: opportunity UUID like "39351ba6-dea0-11ee-ac96-37b2b3de29af"), customer_uuid (string), owner (string: email), pipeline (string), pipeline_stage (string), estimated_close_date (string: YYYY-MM-DD), amount_in_cents (INTEGER CENTS), currency (string), type (string: "recurring" or "one-time"), forecast_category (string: "pipeline", "best_case", "committed", "lost", "won"), win_likelihood (integer: 0-100), custom (object: key-value pairs like {"seats": 3, "product": "CRM"}), created_at (ISO 8601), updated_at (ISO 8601). CRITICAL: amount_in_cents is INTEGER CENTS - divide by 100. Example: amount_in_cents=100000 means $1,000.00. FILTERS: customer_uuid, owner (email), pipeline, pipeline_stage, estimated_close_date_on_or_after (ISO 8601 date), estimated_close_date_on_or_before
Inputs: customer_uuid, owner, pipeline, pipeline_stage, +3 more.
list_plan_group_plansA
[ChartMogul API] List plans within specific plan group. Returns plan objects belonging to the group. REQUIRED: uuid (string: plan group UUID). LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage.
Inputs: uuid, limit.
list_plan_groupsA
[ChartMogul API] List plan groups (logical groupings for reporting). LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns plan group objects with: uuid (string), name (string), plans_count (integer). Response includes cursor/has_more.
Inputs: limit.
list_plansA
[ChartMogul API] List subscription plans (pricing/billing intervals). LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns plan objects with: uuid (string: plan UUID with pl_ prefix), data_source_uuid (string), name (string), interval_count (integer), interval_unit (string: "day", "month", "year"), external_id (string). FILTERS: data_source_uuid (string), external_id (string), system (string: billing system type). Response includes cursor/has_more. Example: system="Stripe", interval_unit="month"
Inputs: data_source_uuid, external_id, system, limit.
list_sourcesA
[ChartMogul API] List data sources (billing systems connected to ChartMogul like Stripe, Recurly, Custom API). Returns array of data source objects with: uuid (string: data source UUID with ds_ prefix), name (string), created_at (ISO 8601 datetime), status (string), system (string: billing system type). FILTERS: name (string: exact match), system (string: billing system type like "Stripe", "Recurly", "Custom" - case-sensitive). Use data_source_uuid from results to filter other endpoints. Example: system="Stripe" or name="My Custom Source"
Inputs: name, system.
list_subscription_eventsA
[ChartMogul API] List subscription lifecycle events (track subscription changes). LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns subscription event objects with event details, dates, subscription/customer info. FILTERS: data_source_uuid (string), external_id (string), customer_external_id (string), subscription_external_id (string), event_type (string: "subscription_start", "subscription_start_scheduled", "scheduled_subscription_start_retracted", "subscription_cancelled", "subscription_cancellation_scheduled", "scheduled_subscription_cancellation_retracted", "subscription_updated", "subscription_update_scheduled", "scheduled_subscription_update_retracted", "subscription_event_retracted"), event_date (ISO 8601 datetime), effective_date (ISO 8601 datetime), plan_external_id (string). Response includes cursor/has_more. Example: event_type="subscription_start"
Inputs: data_source_uuid, external_id, customer_external_id, subscription_external_id, +5 more.
list_tasksA
[ChartMogul API] List CRM tasks. LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns task objects with: uuid (string: task UUID), customer_uuid (string), task_details (string: max 255 chars), assignee (string: email), due_date (string: ISO 8601 date), completed_at (string: ISO 8601 date or null), created_at (string: ISO 8601 datetime). FILTERS: customer_uuid (string), assignee (string: email), due_date_on_or_after (ISO 8601 date), estimated_close_date_on_or_before (ISO 8601 date), completed (boolean: true/false). Response includes pagination. Example: assignee="[email protected]", completed=false
Inputs: customer_uuid, assignee, due_date_on_or_after, estimated_close_date_on_or_before, +2 more.
ltv_metricsA
[ChartMogul API] Retrieve Customer Lifetime Value metrics. CRITICAL: LTV VALUES ARE INTEGER CENTS - DIVIDE BY 100 FOR ACTUAL CURRENCY AMOUNTS. LTV = Average Revenue Per User / Customer Churn Rate. Returns entries array with: date (string), ltv (integer cents), ltv_percentage_change (float). Plus summary object. REQUIRED: start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), interval (any valid value). OPTIONAL: geo, plans, filters (string: CFL syntax fieldoperatorvalueAND... Use get_cfl_fields for field list). Example: ltv=2977624 means $29,776.24 customer lifetime value
Inputs: start_date (required), end_date (required), interval (required), geo, +2 more.
mrr_churn_rate_metricsA
[ChartMogul API] Retrieve Net MRR Churn Rate metrics as percentage. Net MRR Churn = (Churned MRR + Contraction MRR - Expansion MRR) / MRR at Start × 100. IMPORTANT: Negative values indicate net negative churn (expansion > churn - EXCELLENT!). Normal range typically -10% to +10%. Values can exceed 100% or be very negative (e.g., -300% means MRR quadrupled). Returns entries array with: date (string), mrr_churn_rate (float percentage), mrr_churn_rate_percentage_change (float). Plus summary object. REQUIRED: start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), interval ("day", "week", "month", "quarter", "year"). OPTIONAL: geo, plans, filters (string: CFL syntax fieldoperatorvalueAND... Use get_cfl_fields for field list). Example: mrr_churn_rate=-5.2 means -5.2% (net negative churn - good!)
Inputs: start_date (required), end_date (required), interval (required), geo, +2 more.
mrr_metricsA
[ChartMogul API] Retrieve Monthly Recurring Revenue metrics. CRITICAL: ALL MRR VALUES ARE INTEGER CENTS - DIVIDE BY 100 FOR ACTUAL CURRENCY AMOUNTS. Returns entries array with: date (string: YYYY-MM-DD), mrr (integer cents: total MRR), percentage_change (float), mrr_new_business (integer cents: from new customers), mrr_expansion (integer cents: from upgrades), mrr_contraction (integer cents: from downgrades, negative value), mrr_churn (integer cents: from cancellations, negative value), mrr_reactivation (integer cents: from returning customers). Plus summary object. MRR components explained: new_business (new customers), expansion (upgrades), contraction (downgrades excluding cancellations), churn (cancellations), reactivation (previously cancelled returning). REQUIRED: start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), interval ("day", "week", "month", "quarter", "year"). OPTIONAL: geo, plans, filters (string: CFL syntax fieldoperatorvalueAND... Example: "mrrGT1000ANDcurrencyANY'USD'". Use get_cfl_fields for field list). Example: mrr=363819722 means $3,638,197.22, mrr_new_business=288938 means $2,889.38
Inputs: start_date (required), end_date (required), interval (required), geo, +2 more.
retrieve_accountA
[ChartMogul API] Retrieve your ChartMogul account information. Returns complete account object with: id (string: account UUID with acc_ prefix like "acc_93b06efd-30f0-2153-890f-709a64cf8292"), name (string: company name), currency (string: ISO 4217 format like "USD", "EUR"), time_zone (string: TZ identifier like "Europe/Berlin"), week_start_on (string: "monday" or "sunday"). No parameters required. Example response: {"id": "acc_93b06...", "name": "ChartMogul", "currency": "USD", "time_zone": "Europe/Berlin", "week_start_on": "monday"}
Inputs: no named parameters.
retrieve_contactA
[ChartMogul API] Retrieve specific contact by UUID. Returns complete contact object with all fields including customer associations and custom attributes array. REQUIRED: uuid (string: contact UUID)
Inputs: uuid (required).
retrieve_customerA
[ChartMogul API] Retrieve specific customer by UUID. Returns complete customer object with all fields from list_customers plus additional nested objects. Key fields: attributes.tags (array of strings like ["vip", "enterprise"]), attributes.custom (object with custom attributes like {"CAC": 213, "channel": "Facebook"}), attributes.stripe (object with Stripe metadata), attributes.clearbit (object with company data), address (object with full address details). CRITICAL: mrr/arr are INTEGER CENTS. REQUIRED: uuid (string: customer UUID with cus_ prefix like "cus_de305d54-75b4-431b-adb2-eb6b9e546012")
Inputs: uuid (required).
retrieve_customer_noteB
[ChartMogul API] Retrieve specific customer note by UUID. Returns complete note object with all details including timestamps. REQUIRED: uuid (string: note UUID)
Inputs: uuid (required).
retrieve_invoiceA
[ChartMogul API] Retrieve specific invoice by UUID. Returns complete invoice object with: uuid, customer_uuid, external_id, date, due_date, currency, line_items (array with full line item objects including uuid, external_id, type, subscription_uuid, subscription_external_id, subscription_set_external_id, plan_uuid, prorated, service_period_start, service_period_end, amount_in_cents, quantity, discount_code, discount_amount_in_cents, tax_amount_in_cents, transaction_fees_in_cents, transaction_fees_currency, discount_description, event_order, account_code), transactions (array with full transaction objects including uuid, external_id, type, date, result, amount_in_cents), customer details. Specify validation_type to control included invoices. REQUIRED: uuid (string: invoice UUID), validation_type (string: "valid", "invalid", or "all")
Inputs: uuid (required), validation_type (required).
retrieve_opportunityA
[ChartMogul API] Retrieve specific opportunity by UUID. Returns complete opportunity object with amount_in_cents (INTEGER CENTS - divide by 100), currency, custom attributes. REQUIRED: uuid (string: opportunity UUID)
Inputs: uuid (required).
retrieve_planA
[ChartMogul API] Retrieve specific plan by UUID. Returns complete plan object with uuid, data_source_uuid, name, interval_count, interval_unit, external_id. REQUIRED: uuid (string: plan UUID with pl_ prefix like "pl_eed05d54-75b4-431b-adb2-eb6b9e543206")
Inputs: uuid (required).
retrieve_plan_groupA
[ChartMogul API] Retrieve specific plan group by UUID. Returns complete plan group object with uuid, name, plans_count, associated plans. REQUIRED: uuid (string: plan group UUID)
Inputs: uuid (required).
retrieve_sourceA
[ChartMogul API] Retrieve specific data source by UUID. Returns complete data source object with: uuid (string: ds_ prefix), name (string), created_at (ISO 8601 datetime), status (string), system (string: billing system type). REQUIRED: uuid (string: data source UUID like "ds_fef05d54-47b4-431b-aed2-eb6b9e545430")
Inputs: uuid (required).
retrieve_taskA
[ChartMogul API] Retrieve specific CRM task by UUID. Returns complete task object with all details including customer associations and completion status. REQUIRED: uuid (string: task UUID)
Inputs: uuid (required).
search_customersA
[ChartMogul API] Search customers by email address. LIMIT WARNING: Default limit 20. Discourage requesting more than 20 items to avoid excessive token usage. Returns same customer object structure as list_customers. CRITICAL: mrr/arr values are INTEGER CENTS - divide by 100 for actual currency amounts. Example: mrr=3000 means $30.00. REQUIRED: email (string: exact match like "[email protected]")
Inputs: email (required), limit.
update_contactB
[ChartMogul API] Update contact information. MODIFIABLE: first_name, last_name, position, title, email, phone, linked_in, twitter, notes, custom (array of key-value objects). Custom format: [{"key": "department", "value": "Sales"}]. Provide in data dict. Returns updated contact object. REQUIRED: uuid (string), data (dict)
Inputs: uuid (required), data (required).
update_customerA
[ChartMogul API] Update customer attributes. MODIFIABLE: company, lead_created_at, free_trial_started_at, zip, city, state, country, attributes (nested tags/custom), owner, primary_contact, status, website_url. Provide updates in data dict. attributes format: {"tags": ["new", "tags"], "custom": [{"type": "String", "key": "value"}]}. Returns updated customer object with all fields. REQUIRED: uuid (string), data (dict)
Inputs: uuid (required), data (required).
update_customer_noteB
[ChartMogul API] Update customer note/call log. MODIFIABLE: author_email (string), text (string), call_duration (integer: seconds for type "call"), created_at (string: ISO 8601), updated_at (string: ISO 8601). Provide in data dict. Returns updated note object. REQUIRED: uuid (string), data (dict)
Inputs: uuid (required), data (required).
update_opportunityA
[ChartMogul API] Update sales opportunity. MODIFIABLE: owner (string: email), pipeline (string), pipeline_stage (string), estimated_close_date (string: YYYY-MM-DD), amount_in_cents (integer: amount in cents), currency (string: "USD", "EUR", "GBP"), type (string: "recurring" or "one-time"), forecast_category (string: "pipeline", "best_case", "committed", "lost", "won"), win_likelihood (integer: 0-100), custom (object: key-value pairs). Provide in data dict. Returns updated opportunity object. REQUIRED: uuid (string), data (dict)
Inputs: uuid (required), data (required).
update_planA
[ChartMogul API] Update subscription plan. MODIFIABLE: name (string), interval_count (integer >0: billing frequency multiplier, e.g. 6 for half-yearly), interval_unit (string: "day", "month", "year"). Provide in data dict. Returns updated plan object. REQUIRED: uuid (string), data (dict)
Inputs: uuid (required), data (required).
update_plan_groupB
[ChartMogul API] Update plan group. MODIFIABLE: name (string), plans (array: plan UUIDs to include like ["pl_123...", "pl_456..."]). Provide in data dict. Returns updated plan group object. REQUIRED: uuid (string), data (dict)
Inputs: uuid (required), data (required).
update_subscription_eventB
[ChartMogul API] Update existing subscription event for Custom API data sources. Provide subscription_event object with fields to update. Common updates: effective_date, plan_external_id, quantity, other event attributes. Returns updated subscription event object.
Inputs: data (required).
update_taskA
[ChartMogul API] Update CRM task. MODIFIABLE: task_details (string: max 255 chars), assignee (string: email), due_date (string: ISO 8601 date), completed_at (string: ISO 8601 date). Provide in data dict. Returns updated task object. REQUIRED: uuid (string), data (dict)
Inputs: uuid (required), data (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 55 tools
Most tools have distinct purposes targeting specific resources (e.g., customers, metrics, plans) and actions (list, create, update). However, there is some overlap between list_activities and list_customer_activities, which could cause confusion as both retrieve similar activity data but at different scopes (all vs. per-customer). The metrics tools (e.g., mrr_metrics, arr_metrics) are clearly differentiated by the metric type.
Tool names follow a highly consistent verb_noun pattern throughout, such as list_customers, create_customer, update_customer, and retrieve_contact. All tools use snake_case uniformly, with verbs like list, create, update, retrieve, add, and get applied predictably across resources. This consistency makes the set easy to navigate and understand.
With 55 tools, the count is excessive for a single server, making it overwhelming and difficult for agents to manage. While the domain (ChartMogul API) is broad, many tools could be consolidated (e.g., separate metrics tools might be combined with parameters). This high number increases complexity and risks tool misselection, indicating poor scoping.
The tool set provides comprehensive coverage of the ChartMogul domain, including full CRUD operations for customers, contacts, plans, opportunities, tasks, and more, plus extensive metrics retrieval and filtering capabilities. There are no obvious gaps; agents can perform all core workflows from data ingestion to analysis and CRM management, supported by reference tools like get_cfl_fields.
Maintenance
Related MCP Connectors
Read and manage Churnkey cancel flows, retention metrics, and payment recovery
Ask about your subscription metrics, like MRR, ARR and growth, and see the customers behind them.
Query and manage Amberflo metering & billing: customers, meters, usage, plans, invoices, prepaid.
Chargezen is the unified revenue operations platform for businesses that want to get more done. It brings digital employees, billing, influencer marketing and customer engagement into one place, replacing scattered tools so your whole stack runs on the same business and customer data. This endpoint serves the whole platform: Concierge AI agents, orders and customers, Subscriptions, CheckoutOS, rewards and Spark! creator programs, under the teammate's own permissions and OAuth scopes. Each product also has its own endpoint (Chargezen Concierge, Subscriptions, CheckoutOS and Spark!).
Related MCP Servers
AlicenseBqualityBmaintenanceEnables natural language interaction with the Zenskar billing platform, covering customers, contracts, invoices, payments, accounting, products, plans, and more.10029 npm1MIT- AlicenseAqualityDmaintenanceProvides real-time Stripe subscription analytics including MRR, churn, failed payments, and expiring trials. Enables AI assistants to answer business health questions like 'How's my business doing?'8MIT
- AlicenseBqualityBmaintenanceEnables interacting with Planhat customer data via natural language, supporting CRUD operations on companies, contacts, opportunities, notes, conversations, users, assets, issues, tickets, tasks, licenses, and invoices.60MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Chartbrew resources like teams, connections, datasets, dashboards, and charts via natural language.1MIT