# Mixpanel MCP

> Mixpanel (Event Analytics & Insights) gives your AI client direct access to deep product usage data. Query event trends, track conversion funnels, and audit user cohorts using natural language. Stop building dashboards; start asking questions about how users actually behave in your app.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** product-analytics, user-behavior, conversion-funnels, event-tracking, retention-metrics, cohort-analysis

## Description

It lets you talk directly to your product data. Instead of manually running reports or clicking through dozens of tabs, you simply ask your AI client what you want to know—like, 'Why are people dropping off after the payment screen?' Mixpanel's tools let you analyze user behavior and track conversion rates without ever seeing a line of SQL code. You can check if certain features correlate with higher retention or segment users based on their plan type for granular insights. These capabilities are all housed in Vinkius, giving you access to this data source right alongside thousands of others. It’s about getting immediate answers—understanding feature adoption and spotting bottlenecks in your user journey through simple conversation.

## Tools

### list_cohorts
Retrieves a list of saved behavioral groups or 'cohorts' within your project.

### list_funnels
Displays all the conversion funnel definitions you have already set up in Mixpanel.

### query_retention
Calculates and returns user retention curves for a specified group of users over time.

### query_top_events
Identifies the top 20 most frequently triggered events in your entire project data set.

### query_events
Queries and aggregates event counts, showing how certain actions occurred over a specific period.

### export_events
Extracts the raw logs of all events. Note that this action is rate-limited to 60 requests per hour.

### query_funnel
Fetches detailed conversion data and drop-off metrics for a single, specific funnel configuration.

### query_insights
Runs complex, pre-built dashboard insights to give you high-level performance summaries.

### query_profiles
Searches for specific user accounts and retrieves detailed metadata using property filters like plan type.

### query_segmentation
Breaks down event data by specific attributes, allowing you to isolate trends based on device or region.

## Prompt Examples

**Prompt:** 
```
Show me the top 5 events by volume in my project for the last 7 days
```

**Response:** 
```
Retrieving top events… I've identified the highest volume triggers: 1) 'Session Start' (45k), 2) 'Page View' (38k), 3) 'Button Click' (12k), 4) 'Search Query' (8k), and 5) 'Checkout Success' (2k). Would you like to segment 'Checkout Success' by region?
```

**Prompt:** 
```
Query retention from 'User Signup' to 'App Open' for Feb 2026
```

**Response:** 
```
Computing retention curve… For the February cohort, Day 1 retention was 45%, dropping to 18% by Day 7 and stabilizing at 12% by Day 30. This is 5% higher than your January cohort. Would you like me to check the retention for 'Pro' users specifically?
```

**Prompt:** 
```
List all active user cohorts in my project
```

**Response:** 
```
I've retrieved 4 behavioral cohorts: 'Power Users' (Size: 1,250), 'Trial Expired' (Size: 4,500), 'Recent Churn' (Size: 890), and 'iOS Users' (Size: 12,450). Which cohort would you like to query profile traits for?
```

## Capabilities

### Check overall event activity
Determine the volume and frequency of specific actions across your entire user base over time.

### Analyze conversion funnels
Measure step-by-step completion rates for key processes, identifying exactly where users get stuck.

### Model long-term user stickiness
Calculate how many users come back over time and track cohort behavior to measure product value.

### Segment data by attributes
Break down event metrics based on specific properties, like device type or geographical region.

### Audit user profiles
Search for detailed information about individual users using complex property filters.

## Use Cases

### Diagnosing a sudden drop in premium signups
A Growth Lead notices conversion rates dipped last week. They ask their agent, 'What happened to the funnel from free trial to paid upgrade?' The MCP uses `query_funnel` and immediately identifies that users are failing at the payment details screen for specific regions.

### Comparing performance between device types
A Product Manager needs to know if iOS or Android users behave differently. They ask, 'Segment all checkout success events by device.' The MCP uses `query_segmentation` and returns a breakdown showing that desktop users convert at 15% higher rates.

### Investigating churn among specific user types
A Data Analyst wants to know if the 'Trial Expired' cohort is behaving differently than others. They ask, 'What was the retention curve for the Trial Expired cohort?' The MCP runs `query_retention` and provides a clear visualization of the drop-off rate.

### Gathering raw data for external reporting
A Data Analyst needs to feed event logs into an internal machine learning model. They use `export_events` to pull atomic log records, ensuring they have the literal chronological fidelity needed for training.

## Benefits

- Instantly identify performance bottlenecks by running `query_funnel` to check step-by-step drop-offs, eliminating the need for manual funnel report generation.
- Understand long-term product value by using `query_retention`, which calculates user retention curves and shows if your users are sticking around past the initial signup period.
- Get deep context on who is doing what. Use `query_segmentation` to slice any event data by attributes like device or region, turning general trends into actionable insights.
- Rapidly audit customer status using `query_profiles`, letting you search for specific user accounts and pull metadata (like plan type) instantly via natural conversation.
- Get the full picture of feature adoption. Run `query_top_events` to see which actions are most popular, or use `list_cohorts` to check the size of your high-value 'Power User' segment.

## How It Works

The bottom line is you get conversational access to highly structured product analytics that usually requires dedicated data engineering time.

1. Subscribe to this MCP and provide your Mixpanel Service Account credentials and Project ID.
2. Connect the MCP to your preferred AI client (Claude, Cursor, etc.).
3. Ask your agent a question like, 'Show me the retention curve for users who signed up last month.' The tool runs the query and returns the data directly.

## Frequently Asked Questions

**Does Mixpanel (Event Analytics & Insights) MCP handle real-time data?**
The tool queries historical and aggregated event data. While it runs fast, the results reflect the time window you specify in your query, not a live feed of current user actions.

**Can I use Mixpanel (Event Analytics & Insights) MCP to see revenue?**
No. This MCP is dedicated solely to event analytics and user behavior tracking within Mixpanel. For financial data, you need a different connector like one for Stripe or QuickBooks.

**How do I check if my users are returning with the Mixpanel (Event Analytics & Insights) MCP?**
You use `query_retention`. This tool calculates user retention curves, letting you see how many people come back over time and measure product stickiness.

**What is the difference between using `list_cohorts` and `query_profiles`?**
`list_cohorts` shows you pre-saved groups of users (like 'Power Users'). `query_profiles` lets you search for specific individual user accounts using detailed criteria.

**Can I use Mixpanel (Event Analytics & Insights) MCP to find conversion issues?**
Yes. You run `query_funnel`. This tool provides step-by-step conversion data and pinpoints exactly where users are dropping off in your user journey.