Skip to main content
Glama
ChartMogul MCP Server

ChartMogul MCP Server

Official
by chartmogul

ChartMogul's MCP Server

Supported Tools

Account & Data Sources

  • retrieve_account - Get account information

  • list_sources - List all data sources with optional filtering

  • retrieve_source - Get specific data source by UUID

Customer Management

  • list_customers - List customers with filtering options

  • search_customers - Search customers by email

  • retrieve_customer - Get customer by UUID

  • create_customer - Create new customer

  • update_customer - Update customer attributes

  • list_customer_subscriptions - Get customer's subscriptions

  • list_customer_activities - Get customer activities

  • list_customer_attributes - Get customer attributes

  • add_customer_tags - Add tags to customer

  • add_customer_custom_attributes - Add custom attributes to customer

Contacts

  • list_contacts - List all contacts

  • retrieve_contact - Get contact by UUID

  • create_contact - Create new contact

  • update_contact - Update contact information

Customer Notes

  • list_customer_notes - List customer notes and calls

  • retrieve_customer_note - Get specific note by UUID

  • create_customer_note - Create new note or call log

  • update_customer_note - Update existing note

Sales & CRM

  • list_opportunities - List sales opportunities

  • retrieve_opportunity - Get opportunity by UUID

  • create_opportunity - Create new opportunity

  • update_opportunity - Update opportunity details

  • list_tasks - List customer tasks

  • retrieve_task - Get task by UUID

  • create_task - Create new task

  • update_task - Update task information

Plans

  • list_plans - List subscription plans

  • retrieve_plan - Get plan by UUID

  • create_plan - Create new plan

  • update_plan - Update plan details

  • list_plan_groups - List plan groups

  • retrieve_plan_group - Get plan group by UUID

  • create_plan_group - Create new plan group

  • update_plan_group - Update plan group

  • list_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 metrics

  • arr_metrics - Get Annual Run Rate metrics

  • arpa_metrics - Get Average Revenue Per Account metrics

  • asp_metrics - Get Average Sale Price metrics

  • customer_count_metrics - Get customer count metrics

  • customer_churn_rate_metrics - Get customer churn rate metrics

  • mrr_churn_rate_metrics - Get MRR churn rate metrics

  • ltv_metrics - Get Customer Lifetime Value metrics

Data Operations

  • list_subscription_events - List subscription events

  • create_subscription_event - Create new subscription event

  • update_subscription_event - Update subscription event details

  • list_invoices - List invoices with filtering

  • import_invoices - Create new invoice

  • retrieve_invoice - Get invoice by UUID

  • list_activities - List business activities (new_biz, expansion, churn, etc.)

Related MCP server: stripe-analytics-mcp

Usage

  1. Open the Claude Desktop configuration file located at:

    • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • On Windows: %APPDATA%/Claude/claude_desktop_config.json

  2. 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>"
      }
    }
  }
}
  1. Run which uv to locate the command entry for uv and replace it with the absolute path to the uv executable.

  2. Restart Claude Desktop to apply the changes.

Development

  1. Run cp example.env .env in the root of the repository to create a .env file.

  2. Update it with the following env variables.

CHARTMOGUL_TOKEN=<YOUR-CHARTMOGUL-TOKEN>
  1. Install uv by following the instructions here.

  2. Run uv sync to install the dependencies.

  3. Run source .venv/bin/activate to activate the created virtual environment.

  4. Run mcp dev main.py:cm_mcp to start the development MCP server. This command will need Node.js and npm installation.

  5. Inspect and connect to the MCP server at http://127.0.0.1:6274

Available Tools

55 tools
add_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

    A3.7/5.0

    Scored across 55 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables natural language interaction with the Zenskar billing platform, covering customers, contracts, invoices, payments, accounting, products, plans, and more.
      100
      29 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides 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?'
      8
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      60
      MIT