Hosting

remote

Transport

Not documented

Endpoint

Local process; no hosted endpoint documented

Authentication

Interactive OAuth using each user's Mixpanel login; alternatively service-account header auth is documented as beta. Existing project roles apply. Service-account secrets are only shown once and must be stored as secrets, not pasted into chat.

Requirements

• Mixpanel account with access to the intended project
• Organization admin must enable MCP under Settings ? Org ? Overview except newer Free/Growth accounts created after 2026-08-01, where enabled by default; changes may take up to 15 minutes
• For service-account auth, Owner/Admin creates a service account and grants required project access
• Some capabilities are beta or account-gated

Setup steps

1. Choose the regional endpoint for the data region.
2. Have an organization admin enable MCP when required.
3. Add the hosted endpoint in the client as a remote Streamable HTTP MCP server and complete OAuth in the browser.
4. For Codex CLI, add [mcp_servers.mixpanel] url = "<regional MCP endpoint>" to ~/.codex/config.toml, then run codex mcp login mixpanel. For Codex UI, add a Streamable HTTP server in Settings ? MCP Servers.
5. For Claude Code, official command is claude mcp add --transport http mixpanel <regional endpoint>; run /mcp and complete browser OAuth.
6. Verify using a harmless project/event discovery query. Do not use destructive or modifying tools as a connection test.
7. Optional beta service-account auth uses Authorization: Bearer Basic <base64 credentials>; keep secret in environment/secret manager. Notion Agent does not support service-account custom headers.

The official current MCP reference enumerates 64 tools. Tool availability is account/project permission scoped; experiments and feature flags are open beta, while audit log is limited beta and requires an organization admin/owner. Mixpanel records write actions in its audit log.

• Run-Query

  Execute insights, funnels, flows, and retention queries.

  01
• Get-Query-Schema

  Get JSON schema for a query.

  02
• Get-Report

  Retrieve a saved report and optionally results.

  03
• Display-Query

  Display an interactive chart for a previously run query.

  04
• Create-Dashboard

  Create a dashboard with text cards and reports.

  05
• List-Dashboards

  Browse dashboards in a project.

  06
• Get-Dashboard

  Retrieve dashboard metadata, cards and reports.

  07
• Update-Dashboard

  Modify dashboard metadata, rows and layout.

  08
• Duplicate-Dashboard

  Copy an existing dashboard.

  09
• Delete-Dashboard

  Delete a dashboard.

  10
• Get-Business-Context

  Read organization/project business context and query instructions.

  11
• Get-Projects

  List accessible projects and workspaces.

  12
• List-Organizations

  List organizations for the current user.

  13
• Get-Events

  Browse/search project events and metadata.

  14
• List-Properties

  List/search event or user properties.

  15
• Get-Property-Values

  Discover values for a property.

  16
• Search-Entities

  Search dashboards, reports, experiments, feature flags and other entities.

  17
• Get-Issues

  Get data quality issues.

  18
• Get-Lexicon-URL

  Get a direct Lexicon link.

  19
• Edit-Event

  Update event description, display name, tags or visibility.

  20
• Edit-Property

  Update property description, display name, hidden status or PII classification.

  21
• Bulk-Edit-Events

  Edit multiple events.

  22
• Bulk-Edit-Properties

  Edit multiple properties.

  23
• Create-Tag

  Create a Lexicon tag.

  24
• Rename-Tag

  Rename a tag across associated entities.

  25
• Delete-Tag

  Remove a project tag.

  26
• Dismiss-Issues

  Bulk-dismiss data quality issues.

  27
• Update-Business-Context

  Update project or organization business context.

  28
• Find-Duplicate-Groups

  Find duplicate or near-duplicate names for events/properties.

  29
• Dismiss-Duplicate-Group

  Dismiss a duplicate suggestion.

  30
• Merge-Group

  Merge duplicate-named entities.

  31
• Create-Custom-Property

  Create a custom property.

  32
• Get-Custom-Property

  Read custom property definition.

  33
• Update-Custom-Property

  Update custom property definition.

  34
• Create-Cohort

  Create a cohort.

  35
• Get-Cohort

  Read cohort metadata and definition.

  36
• Update-Cohort

  Update a cohort.

  37
• Delete-Cohort

  Delete a cohort.

  38
• List-Cohorts

  List project cohorts.

  39
• Describe-Cohort-Schema

  Read cohort definition schema guidance.

  40
• Create-Lookup-Table

  Create a lookup table.

  41
• Get-Lookup-Table

  Read lookup schema, row count and sample.

  42
• Update-Lookup-Table

  Update a lookup table.

  43
• Create-Metric

  Create a saved metric.

  44
• Get-Metric

  Read saved metric definition.

  45
• List-Metrics

  List saved project metrics.

  46
• Update-Metric

  Update a metric.

  47
• Get-User-Replays-Data

  Analyze an individual user's replays alongside event data.

  48
• List-Experiments

  List/search project experiments.

  49
• Get-Experiment

  Read experiment details, config and results.

  50
• Create-Experiment

  Create an experiment.

  51
• Update-Experiment

  Update experiment config or lifecycle.

  52
• Get-Experiment-Setup-Guidance

  Get experiment design guidance.

  53
• Get-Experiment-Results-Interpretation-Guidance

  Get results interpretation guidance.

  54
• Explain-Experiment-Health-Check

  Explain experiment health status.

  55
• Run-Experiment-Pre-Launch-Checks

  Check draft experiment against launch best practices.

  56
• Search-Prior-Experiments

  Search prior experiments.

  57
• List-Feature-Flags

  List/search feature flags.

  58
• Get-Feature-Flag

  Read flag details and targeting rules.

  59
• Create-Feature-Flag

  Create a feature flag.

  60
• Update-Feature-Flag

  Modify feature flag config or targeting.

  61
• Get-Feature-Flag-Setup-Guidance

  Get setup guidance.

  62
• Get-Feature-Flag-Lifecycle-Guidance

  Get rollout/kill-switch/cleanup guidance.

  63
• Get-Audit-Log

  Query organization audit history (limited beta access).

  64

• MCP access is scoped to each user's existing project permissions; it does not elevate access.
• The connected AI provider receives Mixpanel data; admins should review downstream provider data handling.
• Mixpanel states the MCP is not currently HIPAA-supported and is not covered by its BAA.
• Experiments and feature-flag tools are beta; audience targeting and cohort editing are not supported in those beta tools.
• Audit Log tool is limited beta access.
• New Free/Growth accounts created after 2026-08-01 have MCP enabled by default, but Free plans can have Query API access limits.
• Separate docs-only MCP at https://docs.mixpanel.com/mcp is not this product-analytics server.

• official complete tool reference

  Current Mixpanel reference enumerates 64 tools and documents regional endpoints, OAuth, account permission scoping, beta tool eligibility, rate limits, write behavior, and unsupported query features.

• official product page

  Mixpanel describes analytics and write capabilities for its official MCP server.

Documentation checked 2026-10-28T14:10:00.000Z. Connection has not been runtime tested.