developer-toolsapi_key

ChartMogul

ChartMogul is a subscription analytics and revenue data platform for managing customers, billing data, metrics, and sales opportunities.

Verdict

ChartMogul tracks subscription revenue and customer lifecycle across your billing systems. In Switchy, @mention ChartMogul to pull MRR trends, churn rates, and customer cohorts directly into your workspace. Finance teams use it to answer board questions without leaving Slack threads; product managers query plan performance during roadmap reviews; support reps look up account health mid-conversation. You'll need a ChartMogul API key with read and write access — the MCP can create customers and delete records, so scope carefully if your workspace includes contractors.

Common use cases

  • Compare MRR growth across pricing tiers
  • Audit customer churn before board decks
  • Validate revenue impact of feature launches
  • Spot high-value accounts at risk
  • Track plan adoption in new markets

Integration

Vendor
ChartMogul
Category
developer-tools
Auth
API_KEY
Tools
10
Composio slug
chartmogul

Tools

  • Create Customer

    Create a customer under a ChartMogul data source using a caller-owned external ID and optional profile or lead details.

  • Delete Customer
    destructive

    Request permanent deletion of a customer and all associated ChartMogul data by UUID. ChartMogul accepts this asynchronously, so confirm disappearance with LIST_CUSTOMERS when completion matters.

  • Get Account

    Return the connected ChartMogul account's identity, reporting currency, time zone, week start, and optionally selected churn and refund settings.

  • Get Customer

    Return one customer and its identifiers, lifecycle status, revenue values, ownership, location, and attributes by ChartMogul UUID.

  • Get Key Metrics

    Return all key subscription metrics and current summaries for a date range, optionally grouped by interval and filtered by countries or plans.

  • List Activities

    Return one page of ChartMogul MRR activities for an optional date range, movement type, and date order, with a cursor when more are available.

  • List Customers

    Return one page of customers filtered by source, identifier, email, status, or billing system.

  • List Plans

    Return one page of subscription plans, optionally filtered by source, external ID, or billing system.

  • List Sources

    Return the account's billing data sources, optionally filtered by name or system and with selected source settings included.

  • Update Customer

    Update selected profile, ownership, location, timing, website, or lead-status fields on an existing ChartMogul customer. Omitted fields remain unchanged; tags and custom attributes are not replaced.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to Integrations. 2. Click 'Add MCP Integration' and select ChartMogul from the catalog. 3. Log into your ChartMogul account, go to Admin > API Keys, and generate a new key with at least read permissions (add write if your team needs to create or delete customers). 4. Paste the API key into Switchy's connection dialog and click Connect. 5. Switchy will verify the key by fetching your account details — you'll see your reporting currency and time zone if successful. 6. Open any Project, type '@ChartMogul get key metrics for the last 30 days' in a message, and send it. 7. The MCP should return MRR, churn, and other subscription metrics within seconds; if you see an auth error, regenerate your API key and reconnect.

What teammates see: by default, memories from ChartMogul are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Monthly Revenue Snapshot

@ChartMogul get key metrics for the last 90 days, grouped by month. Show MRR, ARR, customer count, and churn rate.

Customer Health Check

@ChartMogul get customer details for email user@example.com. Include MRR, status, location, and any custom attributes.

Churn Investigation

@ChartMogul list activities for the last 30 days where type is churn. Sort by date descending and show the first 20.

Plan Performance Report

@ChartMogul list all plans and then get key metrics for each plan separately over the last quarter.

New Market Analysis

@ChartMogul get key metrics for the last 6 months filtered by country code US. Break down by month and include customer counts.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@ChartMogul show me all key subscription metrics for the last 90 days, broken down by month

Output

Here's your subscription performance over the last 90 days: **January 2024:** MRR $47,320 (+8.2%), ARR $567,840, Customer count 142 (+5), ARPU $333, Churn rate 3.1% **February 2024:** MRR $51,890 (+9.7%), ARR $622,680, Customer count 156 (+14), ARPU $333, Churn rate 2.8% **March 2024:** MRR $54,210 (+4.5%), ARR $650,520, Customer count 163 (+7), ARPU $333, Churn rate 3.4% Your MRR growth accelerated in February with strong new customer acquisition, though March saw slightly elevated churn. Overall trajectory remains positive with 14.6% total MRR growth across the quarter.

Notes

This example demonstrates ChartMogul's core analytics strength: surfacing subscription health at a glance. Requires read-only API access. The date range and interval grouping are configurable; ChartMogul returns metrics in your account's reporting currency. Rate limits apply to frequent polling—cache results when building dashboards.

Prompt

@ChartMogul create a new customer with email sarah.chen@acmecorp.com under our Stripe data source, tag them as enterprise lead

Output

Customer created successfully in ChartMogul: **UUID:** cus_8f3a9b2c-4d1e-4f8a-9c2b-7e6d5a4b3c2d **Email:** sarah.chen@acmecorp.com **External ID:** Generated automatically **Data source:** Stripe Production **Status:** Lead **Tags:** enterprise This customer record is now live in your ChartMogul account. When Stripe processes their first subscription payment, ChartMogul will automatically link the billing data to this profile and transition their status from Lead to Active.

Notes

This write operation creates a customer record before billing activity exists—useful for tracking leads or manual imports. You must specify which data source (Stripe, Braintree, etc.) owns this customer. The MCP generates an external ID if you don't provide one, but supplying your own CRM ID makes cross-system reconciliation easier.

Prompt

@ChartMogul pull the last 50 MRR movement activities and summarize what's driving our revenue changes this month

Output

I retrieved 50 recent MRR activities from ChartMogul. Here's what's driving your revenue movement: **Primary growth drivers (68% of positive movements):** - 12 new subscriptions adding $4,840 MRR (mostly Pro plan at $99/mo) - 8 expansion upgrades adding $1,920 MRR (Standard→Pro transitions) **Contraction factors (32% of negative movements):** - 5 cancellations removing $1,495 MRR - 3 downgrades removing $570 MRR (Pro→Standard) **Net impact:** +$4,695 MRR this month. Your new customer acquisition is outpacing churn 2.4:1, and expansion revenue from upgrades is partially offsetting downgrades. The Pro plan is your strongest conversion target right now.

Notes

This synthesis example pairs ChartMogul's activity stream with AI reasoning to extract business insights. The MRR activities API returns granular movement records (new, expansion, contraction, churn, reactivation) with timestamps and amounts. Cursor-based pagination means you can fetch more than 50 if needed, but watch rate limits on large historical pulls.

Use-case deep-dives

Monthly board deck prep

When ChartMogul MCP beats exporting CSVs for investor updates

A 6-person SaaS team sends monthly board decks with MRR movement, churn, and plan breakdowns. Before this MCP, the founder exported three CSVs from ChartMogul, pasted them into Google Sheets, then copied tables into Notion. Now the team prompts Switchy to pull Get Key Metrics for the trailing 30 days, group by week, and draft the revenue narrative in their deck template. The MCP handles currency conversion and timezone math that the founder used to fix by hand. This works cleanly when your ChartMogul account has under 500 active customers—above that threshold, the List Activities cursor pagination gets tedious and you're better off scheduling a nightly export. If you send board decks more than once a quarter, wire this MCP into your shared workspace and reclaim two hours a month.

Customer success handoff lookup

Why Get Customer beats switching tabs during onboarding calls

A 3-person customer success team onboards new enterprise trials over Zoom. Mid-call, a rep needs to confirm the customer's lifecycle stage, MRR, and billing system ID to decide whether to route them to self-serve docs or schedule implementation help. Switching to ChartMogul's web UI breaks flow and the rep loses 20 seconds finding the UUID. With this MCP in Switchy, the rep types the customer email into the shared chat, Switchy calls List Customers by email then Get Customer by UUID, and surfaces the profile in 4 seconds without leaving the call window. The trade-off: if your team juggles more than two billing systems (Stripe, Recurly, Chargebee), the external ID mapping gets ambiguous and you'll want a custom Zapier lookup instead. For teams under 10 reps using one or two billing sources, this MCP cuts context-switching during the highest-value customer touchpoint.

Churn cohort analysis for pricing tests

When List Activities wins for post-mortem sprint retros

A 5-person product team ships a new pricing tier in March and wants to measure whether April churn spiked among customers who downgraded from the old tier. The PM used to export MRR movement logs, filter by contraction type in Excel, then manually tag which customers were on the deprecated plan. Now the team prompts Switchy to call List Activities filtered by contraction movements in April, cross-reference each customer UUID with Get Customer to check their current plan, and summarize how many came from the old tier. The MCP returns raw activity records, so Switchy does the grouping logic—this works when you're analyzing under 200 churn events in a month. Above that volume, ChartMogul's Segmentation UI is faster because it pre-aggregates. If your pricing experiments run quarterly and involve fewer than 50 affected customers per test, this MCP turns a 90-minute spreadsheet exercise into a 5-minute prompt.

Frequently asked

What does the ChartMogul MCP let me do in Switchy?

It pulls subscription metrics, customer data, and MRR activities from your ChartMogul account into Switchy conversations. You can query churn rates, filter customers by lifecycle stage, list plans, and create or delete customer records without opening the ChartMogul dashboard. Useful when your team discusses revenue trends or needs to look up a specific subscriber mid-conversation.

Do I need admin access to connect ChartMogul?

You need an API key with read and write permissions. ChartMogul generates these under Account Settings → API Keys. Any team member with access to that page can create a key, but you should treat it like a password—whoever connects it in Switchy controls customer creation and deletion. If your ChartMogul account restricts API key generation to admins, you'll need one of them to set it up.

Can this MCP update subscription invoices or import billing data?

No. The MCP reads metrics and manages customer records, but it doesn't touch invoices, subscriptions, or raw billing imports. If you need to push transactions into ChartMogul, use their Import API directly or connect your billing system (Stripe, Recurly, etc.) through ChartMogul's native integrations. This MCP is for querying and light customer admin, not data ingestion.

How is this different from just logging into ChartMogul?

It saves context switching when you're already working in Switchy. Instead of opening ChartMogul, filtering customers, copying UUIDs, and pasting them into a conversation, you ask the AI to fetch the data inline. The trade-off: you lose ChartMogul's visual dashboards and cohort charts. Use this for quick lookups and metric pulls; use the web app for deep analysis.

Who on my team should connect this integration?

Whoever owns your revenue reporting or customer success workflows. The API key grants full read-write access to customers and metrics, so don't hand it to someone who shouldn't delete records. If multiple people need ChartMogul data in Switchy, one person connects it and the whole workspace inherits access. It doesn't count against user seats or ChartMogul plan limits.

More developer tools MCPs

See all developer tools MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.