# Mixpanel MCP MCP Server

> **Mixpanel MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Mixpanel MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/mixpanel-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Analyze product and user behavior data with Mixpanel’s MCP server. Query events, funnels, retention, trends, cohorts, and user profiles to uncover actionable product insights.

---

## Details

- Server ID: `mixpanel-mcp`
- Version: 3.3.0
- Tools: 66
- Authentication: OAuth, managed by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Mixpanel MCP has to be in the toolset
first. In order:

1. Add Mixpanel MCP to your toolset at https://mewcp.com/mcp/mixpanel-mcp
2. Connect your Mixpanel MCP account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (66)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `Get-Projects` _(read)_ — If you have not yet called Get-Business-Context this conversation, call it FIRST — it may resolve project nicknames, acronyms, or org-specific terms in the…
- `Get-Project-Token` _(read)_ — A project's Mixpanel tracking token — the value an SDK is initialized with to send events to api.mixpanel.com/track. Use it when instrumenting tracking. This…
- `Get-Live-Events` _(read)_ — Recent events streaming into a project, newest first, with event name, time, and distinct ID. Use it to confirm newly instrumented events are arriving, or to…
- `Get-Events` _(read)_ — Get events for a Mixpanel project. Two lookup modes (mutually exclusive): - event_names: Look up specific events by exact name. Lightweight server-side filter.…
- `Edit-Event` _(destructive)_ — Use contact_emails or team_contact_names for ownership. Set verified=True to verify/approve events, hidden=True to hide from UI, dropped=True to deprecate.
- `Bulk-Edit-Events` _(destructive)_ — Edit multiple events at once. Supports two modes: 1. Uniform fields (applied to ALL events): hidden, verified, dropped, tags, contact_emails,…
- `List-Properties` _(read)_ — List properties for a Mixpanel project. Returns name and type by default. Two lookup modes (mutually exclusive): - names: Look up specific properties by exact…
- `Get-Property-Values` _(read)_ — Get values for one or more properties, returned as a table. properties: one or more property names. With a single property the result is a one-column table of…
- `Edit-Property` _(destructive)_ — Set sensitive=True for PII data classification. Set example_value to populate the example shown in Lexicon.
- `Bulk-Edit-Properties` _(destructive)_ — Edit multiple properties at once. Supports two modes: 1. Uniform fields (applied to ALL properties): hidden, dropped, sensitive, tags. 2. Per-property fields…
- `Create-Custom-Property` _(write)_ — Create a formula-based custom property (a computed event or user property) in a project. Define it with a `display_formula` expression that references named…
- `Update-Custom-Property` _(write)_ — Update an existing formula-based custom property. Partial update: pass only the fields you want to change (`name`, `description`, `display_formula`,…
- `Get-Custom-Property` _(read)_ — Get a custom property by id, including its full definition (behavior or display_formula + composed_properties). Use this before Update-Custom-Property to see…
- `Get-Lookup-Table` _(read)_ — Read a lookup table by id or name, or list all lookup tables. Provide `data_group_id` or `name` to get one table's schema (columns), row count, and a capped…
- `Create-Lookup-Table` _(write)_ — Create a lookup table from rows. Pass `rows` as a list of {column: value} objects; one column is the primary key (`primary_key_column`, default "Primary Key")…
- `Update-Lookup-Table` _(destructive)_ — Update a lookup table with a row delta and/or edit name/description. Send only the cells you want to change — you do NOT need to read or resend the whole…
- `Create-Tag` _(write)_ — Create a tag for organizing events and properties in Lexicon.
- `Get-Issues` _(read)_ — Get all data quality issues for a Mixpanel project. Returns rich context with human-readable descriptions, event/property names, timestamps, and variance…
- `Dismiss-Issues` _(destructive)_ — Dismiss data quality issues matching natural criteria - no need to look up IDs first. Specify what to dismiss using event names, property names, dates, and…
- `Rename-Tag` _(write)_ — Rename an existing tag in a Mixpanel project. The new name must be unique within the project (max 175 characters). This updates all events and properties…
- `Delete-Tag` _(destructive)_ — Delete a tag from a Mixpanel project. This removes the tag from all associated events and properties. Use with caution as this operation cannot be undone.
- `Get-Lexicon-URL` _(read)_ — Return a Mixpanel Lexicon transformations detail URL for an event or property. Provide either event or property along with project_id. If workspace_id is…
- `Get-User-Replays-Data` _(read)_ — Get session replays information. Provide either a distinct_id (with from_date and to_date) to find all replays for a user, OR a list of specific replay_ids (up…
- `Get-Query-Schema` _(read)_ — Get the full instructions and JSON schema for building a full Mixpanel query. Call this to learn all available fields and options for the 'report' parameter in…
- `Get-Report` _(read)_ — Retrieve a saved report's metadata from a Mixpanel project. Optionally include the report results if it's a queryable report type. Returns report metadata (id,…
- `Run-Query` _(read)_ — Run a single analytics query and return its results directly. Use this whenever the user requests a chart, a report, a metric, explore a behavior or root…
- `Display-Query` _(read)_ — Display the interactive chart widget for a previously-run query. Takes a query_id returned by Run-Query and render results in the MCP App visualization widget.
- `Create-Dashboard` _(write)_ — Create a Mixpanel dashboard that combines multiple reports and text into a single view. Use when the user asks for a "dashboard," "board", or requests to save…
- `List-Dashboards` _(read)_ — Prefer Search-Entities with entity_types=['dashboard'] instead, it offers more flexibility and efficiency. Returns a list of all the dashboards in the project.…
- `Get-Dashboard` _(read)_ — Set include_layout=True to get full layout with cell/row IDs (needed for Update-Dashboard). Layout format: [[row_id, [[cell_id, type, extra], ...]], ...].
- `Update-Dashboard` _(destructive)_ — Call Get-Dashboard with include_layout=True first to get cell/row IDs. - To update a report cell query_id, call Run-Query first. - To add rows or cells, use…
- `Duplicate-Dashboard` _(write)_ — Create a copy of an existing dashboard with all its contents. Optionally override the title and description of the new dashboard.
- `Delete-Dashboard` _(destructive)_ — Delete a dashboard. Always confirm with the user before proceeding. Use List-Dashboards or Get-Dashboard to find the dashboard ID.
- `List-Feature-Flags` _(read)_ — List and search feature flags in a project. Filter by status, key, name, creator, or creation date. Use Get-Feature-Flag for full configuration.
- `Get-Feature-Flag` _(read)_ — Get full configuration for a specific feature flag. Returns metadata, variants, rollout rules, experiment link, and UI URL. For listing flags, use…
- `Create-Feature-Flag` _(write)_ — Create a feature flag in the current project. `project_id` and `workspace_id` are auto-injected from the caller's session — pass any int and the values you…
- `Update-Feature-Flag` _(write)_ — Update flag configuration, status, or archive state. For rollout / kill-switch / archival decisions — including the staged-rollout cadence, when to use status…
- `Get-Feature-Flag-Setup-Guidance` _(read)_ — Returns best-practice guidance for creating and configuring a Mixpanel feature flag. Call this when the user is creating, configuring, or troubleshooting a…
- `Get-Feature-Flag-Lifecycle-Guidance` _(read)_ — Returns best-practice guidance for managing a Mixpanel feature flag after creation — staged rollout, kill-switch, hygiene/cleanup, archival, exposure tracking,…
- `List-Experiments` _(read)_ — List and search experiments in a project. Filter by status, name (case-insensitive substring match), creator, creation date, or tags. Use Get-Experiment for…
- `Get-Experiment` _(read)_ — Get full experiment configuration and (optionally) fresh live results. Returns metadata, variants, metrics (with IDs, type, and direction), cached data, and UI…
- `Create-Experiment` _(write)_ — Create an experiment (in DRAFT status) in the current project. For setup decisions (hypothesis writing, metric selection, sample sizing, testing model, end…
- `Update-Experiment` _(write)_ — Update experiment configuration or manage its lifecycle. Lifecycle actions (set action param): - "launch": DRAFT→ACTIVE. Enables linked flag. - "conclude":…
- `Explain-Experiment-Health-Check` _(read)_ — Explain why an experiment's health check is firing — or confirm it isn't — and recommend a next action. Supports two checks: - `health_check_kind="srm"` —…
- `Get-Experiment-Setup-Guidance` _(read)_ — Returns best-practice guidance for designing a Mixpanel experiment before launch. Call this when the user is creating, configuring, or troubleshooting an…
- `Get-Experiment-Results-Interpretation-Guidance` _(read)_ — Returns best-practice guidance for interpreting Mixpanel experiment results and making ship/iterate/kill decisions. Call this when the user is analyzing,…
- `Run-Experiment-Pre-Launch-Checks` _(read)_ — Cross-references a draft experiment's configuration against a canonical list of pre-launch pitfalls and returns a structured PitfallReport. Call this at the…
- `Search-Prior-Experiments` _(read)_ — Search the project's experiments store for prior tests on the same feature, metric, or hypothesis. Returns up to ``max_matches`` ranked matches with similarity…
- `Describe-Cohort-Schema` _(read)_ — Return the schema for the `definition` parameter accepted by Create-Cohort and Update-Cohort. Call this before authoring a cohort definition for the first time…
- `Create-Cohort` _(write)_ — Create a new Mixpanel cohort. A cohort is a saved group of users matching a set of criteria. Pass a `definition` dict matching the CohortDefinition schema…
- `Get-Cohort` _(read)_ — Retrieve a Mixpanel cohort by ID. Returns the cohort's metadata (name, description, count, is_visible, verified, creator, updated_at) and its definition in the…
- `List-Cohorts` _(read)_ — List all cohorts in a Mixpanel project. Returns a lightweight list of cohort headers (id, name, description, count, verified). Use the optional `query`…
- `Update-Cohort` _(write)_ — Update an existing Mixpanel cohort. All fields (name, description, definition, is_visible) are optional. Only the provided fields will be updated; omitted…
- `Delete-Cohort` _(destructive)_ — Delete a Mixpanel cohort. WARNING: This action is destructive and cannot be undone. Always confirm with the user before deleting a cohort. The webapp will…
- `List-Metrics` _(read)_ — List all saved metrics in a project. Returns metric IDs, names, types, descriptions, and verified status. Use before creating experiments to find reusable…
- `Get-Metric` _(read)_ — Get full definition for a saved metric. Returns complete metric structure (events, formulas, filters, aggregation). Use to inspect, copy, or verify metric…
- `Create-Metric` _(write)_ — Create a saved metric (behavior or formula) for reuse across experiments. Types: - "metric": Single event behavior (count, unique users, DAU, etc.) -…
- `Update-Metric` _(write)_ — Update saved metric's name, definition, or description. At least one field required. Warning: affects all experiments using this metric. Consider creating new…
- `Search-Entities` _(read)_ — Search entities in a Mixpanel project: dashboards, reports, experiments, feature flags, metric trees, playlists, and heat maps. query: can be empty to browse…
- `Get-Business-Context` _(read)_ — Call this FIRST, before any other Mixpanel tool whenever ANY of these are true: 1. It is the first substantive turn of the conversation about this org or…
- `Update-Business-Context` _(destructive)_ — Update the business context at the project or organization level. This is a full replace — the new content overwrites whatever exists; there is no merge or…
- `List-Organizations` _(read)_ — Returns the organizations the current user belongs to.
- `Find-Duplicate-Groups` _(read)_ — Find groups of duplicate or near-duplicate names in a Mixpanel project — both events and event properties. Returns clusters a user might want to merge in…
- `Merge-Group` _(destructive)_ — Merge a group of duplicate names into one canonical entity in a Mixpanel project's Lexicon. Works for events and event properties. DESTRUCTIVE: source entities…
- `Dismiss-Duplicate-Group` _(write)_ — Dismiss a duplicate-group suggestion so it no longer appears in Find-Duplicate-Groups results. Works for events and event properties. Does not modify any…
- `Fill-Event-Metadata` _(destructive)_ — Use AI to fill in missing event metadata for a Mixpanel project. For every event that is missing a display name and/or description, this generates one and…

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/mixpanel-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/mixpanel-mcp/connect/chatgpt
- Grok: https://mewcp.com/mcp/mixpanel-mcp/connect/grok
- DeepSeek Harness: https://mewcp.com/mcp/mixpanel-mcp/connect/dsh
- Mistral Vibe: https://mewcp.com/mcp/mixpanel-mcp/connect/mistral-vibe
- VS Code: https://mewcp.com/mcp/mixpanel-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/mixpanel-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/mixpanel-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/mixpanel-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/mixpanel-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/mixpanel-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/mixpanel-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/mixpanel-mcp/connect/hermes
- Kimi Code: https://mewcp.com/mcp/mixpanel-mcp/connect/kimi-code
- Grok Build: https://mewcp.com/mcp/mixpanel-mcp/connect/grok-build
- Devin Desktop: https://mewcp.com/mcp/mixpanel-mcp/connect/devin-desktop
- Zed: https://mewcp.com/mcp/mixpanel-mcp/connect/zed
- Muse Code: https://mewcp.com/mcp/mixpanel-mcp/connect/muse-code
- Cline: https://mewcp.com/mcp/mixpanel-mcp/connect/cline
- Kilo Code: https://mewcp.com/mcp/mixpanel-mcp/connect/kilo-code
- Kiro: https://mewcp.com/mcp/mixpanel-mcp/connect/kiro
- Junie: https://mewcp.com/mcp/mixpanel-mcp/connect/junie
- Amp: https://mewcp.com/mcp/mixpanel-mcp/connect/amp
- Qwen Code: https://mewcp.com/mcp/mixpanel-mcp/connect/qwen-code
- Goose: https://mewcp.com/mcp/mixpanel-mcp/connect/goose
- Python: https://mewcp.com/mcp/mixpanel-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/mixpanel-mcp/connect/typescript