Accessing RevenueCat charts
Use the following two tools of the RevenueCat MCP:
- : To understand the available options for each chart, including date resolution, segments, filters, and other selectors
- : To retrieve data for a chart
In general, to avoid clogging the context, start with defined timeframes and larger resolution, then narrow down.
Interpreting metrics
Subscription apps are driven by four forces:
Acquisition - how many new customers are arriving to the app
Conversion - how many of those customers are converting into trials or paid paid plans
Retention - how long do those customers retain
Reactivation - how can you bring back old users
The net movement of an apps revenue will be the result of the combination of these forces. When giving advice, always use benchmark data to make sure you aren't incorrectly diagnosing an issue.
Acquisition
- Use the New Customers chart to understand how much top of funnel the app is driving.
- Segmenting New Customers by Country, or Apple Search Ads dimensions can be helpful in informing acquisition
Conversion
The definition of conversion may vary depending on what model the app is using. They may be converting to a trial, that then converts into a subscription. Or they may be sending users directly to a subscription.
- Use the Initial Conversion chart to see how many trial or subscriptions are started.
- You can then further determine if they are using free trials by comparing that to the New Trials chart
- The Trial Conversion Rate chart is a helpful chart for understanding the performance of just that trial conversion
Retention
- The Churn chart will tell you the % of the active subscriber base that is lost each period. It can be difficult to interpret or benchmark because it is a blend of different periods.
- When you want to understand the long term retention of different products, look at the Subscription Retention chart
Reactivation
- The only real way to understand Reactivation is looking at the MRR Movement chart and the Resubscription MRR
Dashboard URL Format
IMPORTANT: Use this exact structure:
https://app.revenuecat.com/projects/{project_id}/charts/{chart_name}?range={range_value}
- — The short hex ID (e.g., ), NOT the full
- — Chart name like , , , etc.
- Project ID goes in the path, not as a query parameter
Correct example:
https://app.revenuecat.com/projects/56965ae1/charts/revenue?range=Last+90+days%3A2025-11-16%3A2026-02-13
WRONG — do not use:
https://app.revenuecat.com/charts/revenue?project=proj56965ae1&chart_start=...&chart_end=...
Query Parameters
Date Range () — REQUIRED
The
parameter controls the date range. Format:
{preset}:{start_date}:{end_date}
You must use this format — do NOT use
,
,
, or
params.
| Preset | Encoded Value |
|---|
| Last 7 days | range=Last+7+days%3A2026-02-06%3A2026-02-13
|
| Last 28 days | range=Last+28+days%3A2026-01-16%3A2026-02-13
|
| Last 90 days | range=Last+90+days%3A2025-11-16%3A2026-02-13
|
| Last 365 days | range=Last+365+days%3A2025-02-13%3A2026-02-13
|
| Custom | range=Custom%3A2025-01-01%3A2025-12-31
|
Note: The
between parts must be URL-encoded as
. Spaces become
.
Resolution ()
| Value | Meaning |
|---|
| Daily granularity |
| Weekly granularity |
| Monthly granularity |
| Quarterly granularity |
| Yearly granularity |
Segment ()
Dimension to break down the data by. Common values:
- — by country
- — by app store (App Store, Play Store, etc.)
- — by product identifier
- — by platform (iOS, Android, etc.)
- — by offering
Filters
Filters are passed as individual query params with the filter name as key:
| Filter | Example |
|---|
| |
| |
| product_identifier=premium_monthly
|
| |
Multiple values for the same filter:
country=US&country=DE&country=JP
Chart-Specific Selectors
Some charts have special selectors:
Conversion/Retention charts:
Workflow charts:
- — workflow path filter
workflows_customer_lifetime
Constructing a Link
To generate a dashboard link:
- Start with base:
https://app.revenuecat.com/projects/{project_id}/charts/{chart_name}
- Add param with date range
- Add any filters as query params
- Add if segmenting
- Add chart-specific selectors as needed
- URL-encode all values (spaces → , colons → , etc.)
API to Dashboard Parameter Mapping
When translating from API parameters to dashboard URLs:
| API Parameter | Dashboard Parameter |
|---|
| + | range=Custom%3A{start}%3A{end}
|
| |
| (JSON array) | Individual query params |
| (JSON object) | Individual query params |
Note: Do NOT pass
as a numeric value. The resolution is typically implied by the range preset or omitted.
Example: Building a Link
User wants: "Revenue chart for last 90 days, segmented by country, filtered to US and Germany"
Calculate dates: if today is 2026-02-13, then 90 days ago is 2025-11-16.
https://app.revenuecat.com/projects/56965ae1/charts/revenue?range=Last+90+days%3A2025-11-16%3A2026-02-13&segment_by=country&country=US&country=DE
User wants: "Churn chart from August 2025 to now"
Use the
preset for arbitrary date ranges:
https://app.revenuecat.com/projects/56965ae1/charts/churn?range=Custom%3A2025-08-01%3A2026-02-13
Getting Project ID
The project ID can be found via the API:
- — lists all projects with their IDs
- API returns IDs like
- For dashboard URLs, strip the prefix — use just in the path