Documentation Index
Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Use Mixpanel as a data source for Chartcastr. Connect your project with a Service Account and Chartcastr will pull active user metrics, top events, saved funnels, cohort retention, and a custom multi-event overlay to generate charts delivered automatically to Slack or email. Chartcastr connects with read-only access to your Mixpanel project — the Service Account only needs the Analyst role.Setup
Create a Mixpanel Service Account
In Mixpanel, go to Project Settings → Service Accounts and create a new account. Grant it the Analyst role on the project. Copy the username and secret — you’ll need both.
Find your Project ID
Your numeric Project ID is in your Mixpanel URL:
https://mixpanel.com/project/<PROJECT_ID>/... (or eu.mixpanel.com for EU residency).Connect in Chartcastr
In Chartcastr, go to New Connection and select Mixpanel as a source. Pick US or EU region, paste the Service Account username + secret + Project ID, and click Test & Connect.
Region: Use US for
mixpanel.com or EU for eu.mixpanel.com. The region drives which Query API host we hit and is locked once connected — disconnect and reconnect to switch regions.Confirm your pageview event
After connecting, Chartcastr auto-detects your pageview event by looking for common names (
Page Viewed, $mp_web_page_view, Page View, etc.) in your top events. You can override it with any event from your project — pick Pick a different event in the connect modal.Select a metric
Choose a chart type. Funnel metrics ask you to pick a saved funnel; the Custom Events Overlay asks you to pick up to 5 events.
Available Metrics
Chartcastr supports 12 pre-built Mixpanel metrics across six categories.Active Users
DAU, WAU, MAU, and a combined DAU/WAU/MAU chart for engagement tracking.
Events
Total events, unique event users, and a stacked Top Events chart.
Pageviews
Total pageviews and unique pageview users using your auto-detected pageview event.
Funnels
Saved-funnel conversion rate over time and per-step user counts.
Retention
Average weekly cohort retention curve.
Custom Events Overlay
Pick up to 5 events and overlay them as lines on a single chart.
View all available charts
See the full list of Mixpanel metrics with chart types and descriptions.
Authentication
Chartcastr uses HTTP Basic auth with your Service Account username and secret. The secret is encrypted at rest with AES-256-GCM. We never store the project token — only the SA credentials, which are read-only.Rate Limits
Mixpanel’s Query API is capped at 60 queries/hour per project with a maximum of 5 concurrent queries. Chartcastr’s pulse cadence (daily/weekly) keeps you well below the cap. If you hit the limit you’ll see a clear “rate limit hit” error in the chart preview — wait an hour and try again.Custom Events Overlay
The Custom Events Overlay chart lets you pick up to 5 event names from your project and renders them as a multi-line chart on a single shared Y axis with a fixed color palette.v1 ships with a single shared Y axis. Per-event left/right axis selection is on the v2 roadmap so high-volume and low-volume events can share a chart without one squashing the other.
Next Steps
Slack destination
Deliver Mixpanel charts to your Slack channels with AI summaries in the thread.
Email destination
Schedule Mixpanel reports to any inbox or distribution list.