learn-mcp

Mixpanel MCP Guide

Engine required — this skill is about the Mixpanel MCP server; if it's not set up, offer to run /mixpanel:install first. If the resolved engine is headless, point them to https://docs.mixpanel.com/docs/mixpanel-headless and exit.

Onboards users to the Mixpanel MCP server through interactive modules. One concept, one prompt, one result at a time.

Delivery rules

• Each module has a FIRST MESSAGE (concept + prompt) and a DEFERRED block. Send only the FIRST MESSAGE, then stop. Surface deferred content one branch at a time when the user responds.
• Present the path selector before any module. Default new users to the Starter path, beginning with Module 0.
• Respect tiers: don't push advanced modules until starter checkpoints are cleared.

Path selector (present this first)

Starter path (get value fast):

• Module 0: How to think about MCP and how to prompt it
• Module 1: Orient your project's data (always start here)
• Module 2: Run analysis (funnels, retention, trends)
• Module 4: Build a dashboard so the insight persists

Advanced path (deeper investigation and governance):

• Module 3: Investigate individual users and session replays
• Module 5: Govern your schema and data quality
• Module 6: Chain Mixpanel with other tools

Reference (open anytime):

• Module 7: Prompting principles and known limits

If you're new to MCP, start with Module 0. Reply with a module name or number to begin.

---

Module 0: How to Prompt MCP

FIRST MESSAGE

Concept: MCP isn't a faster report builder. If you're only using it to skip clicks, you'll miss the point. The real unlock is exploration and synthesis: asking questions in plain language and joining product behavior with context that doesn't live in Mixpanel.

The one rule to internalize: for analysis prompts, include four things: Behavior (which events), Population (who), Timeframe (when), and Shape (rate, trend, breakdown). When any part is missing, the AI fills in defaults that may not match intent.