Skip to main content
Glama
mixpanel

mixpanel

by dragonkhoi

Mixpanel MCP

铁匠徽章

简单的 MCP 服务器,可与 Mixpanel API 交互,让您可以从任何 MCP 客户端(例如 Cursor 或 Claude Desktop)访问 Mixpanel 事件数据。查询事件数据、留存率和漏斗数据。非常适合按需查询,例如:“2 月 1 日群组用户的周留存率是多少?”

随着时间的推移,我会添加更多关于 Mixpanel API 的覆盖范围,请让我知道您需要哪些工具,或者只需打开 PR。

安装

确保转到您的 Mixpanel 组织设置来设置Mixpanel 服务帐户,获取用户名、密码和您的项目 ID(在 Mixpanel 项目设置中)。

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 mixpanel-mcp:

npx -y @smithery/cli install @dragonkhoi/mixpanel-mcp --client claude

要为 Cursor 安装 mixpanel-mcp,请前往“设置”->“Cursor 设置”->“功能”->“MCP 服务器”->“+ 添加”

选择类型:命令并粘贴以下内容,使用来自 Mixpanel 的参数<USERNAME> <PW> <PROJECT_ID>

npx -y @smithery/cli@latest run @dragonkhoi/mixpanel-mcp --config "{\"username\":\"YOUR_SERVICE_ACCT_USERNAME\",\"password\":\"YOUR_SERVICE_ACCT_PASSWORD\",\"projectId\":\"YOUR_MIXPANEL_PROJECT_ID\"}"

克隆并在本地运行

克隆此 repo 运行npm run build将此命令粘贴到 Cursor(或任何 MCP 客户端) node /ABSOLUTE/PATH/TO/mixpanel-mcp/build/index.js YOUR_SERVICE_ACCOUNT_USERNAME YOUR_SERVICE_ACCOUNT_PASSWORD YOUR_PROJECT_ID

Related MCP server: Mixpanel MCP Connector

示例

  • 询问留存率

  • 询问事件概述

Available Tools

19 tools
aggregated_event_property_valuesB

Get unique, general, or average data for a single event and property over days, weeks, or months. Useful for analyzing how specific properties affect event performance, segmenting users, and identifying valuable user attributes.

Inputs: event (required), name (required), unit (required), from_date, +6 more.

aggregate_event_countsB

Get unique, general, or average data for a set of events over N days, weeks, or months. Useful for trend analysis, comparing event performance over time, and creating time-series visualizations.

Inputs: event (required), unit (required), from_date, interval, +3 more.

custom_jqlB

Run a custom JQL (JSON Query Language) script against your Mixpanel data. Useful for complex custom analyses, advanced data transformations, and queries that can't be handled by standard report types.

Inputs: script (required), params, project_id, workspace_id.

get_today_top_eventsB

Get today's top events from Mixpanel. Useful for quickly identifying the most active events happening today, spotting trends, and monitoring real-time user activity.

Inputs: limit, project_id, type.

get_top_eventsB

Get a list of the most common events over the last 31 days. Useful for identifying key user actions, prioritizing feature development, and understanding overall platform usage patterns.

Inputs: limit, project_id, type.

list_saved_cohortsB

Get all cohorts in a given project. Useful for discovering user segments, planning targeted analyses, and retrieving cohort IDs for filtering in other reports.

Inputs: project_id, workspace_id.

list_saved_funnelsA

Get the names and IDs of your saved funnels. Useful for discovering available funnels for analysis and retrieving funnel IDs needed for the query_funnel_report tool.

Inputs: project_id, workspace_id.

profile_event_activityB

Get data for a profile's event activity. Useful for understanding individual user journeys, troubleshooting user-specific issues, and analyzing behavior patterns of specific users.

Inputs: distinct_ids (required), from_date (required), to_date (required), project_id, +1 more.

query_frequency_reportC

Get data for frequency of actions over time. Useful for analyzing how often users perform specific actions, identifying patterns of behavior, and tracking user engagement over time.

Inputs: addiction_unit (required), from_date (required), to_date (required), unit (required), +6 more.

query_funnel_reportA

Get data for a funnel based on a funnel_id. Useful for analyzing user conversion paths, identifying drop-off points in user journeys, and optimizing multi-step processes. Funnel IDs should be retrieved using the list_saved_funnels tool.

Inputs: from_date (required), funnel_id (required), to_date (required), interval, +5 more.

query_insights_reportB

Get data from your Insights reports. Useful for accessing saved analyses, sharing standardized metrics across teams, and retrieving complex pre-configured visualizations.

Inputs: bookmark_id (required), project_id, workspace_id.

query_profilesB

Query Mixpanel user profiles with filtering options. Useful for retrieving detailed user profiles, filtering by specific properties, and analyzing user behavior across different dimensions.

Inputs: as_of_timestamp, behaviors, data_group_id, distinct_id, +9 more.

query_retention_reportB

Get data from your Retention reports. Useful for analyzing user engagement over time, measuring product stickiness, and understanding how well your product retains users after specific actions. Only use params interval or unit, not both.

Inputs: from_date (required), to_date (required), born_event, born_where, +10 more.

query_segmentation_averageB

Averages an expression for events per unit time. Useful for calculating average values like purchase amounts, session durations, or any numeric metric, and tracking how these averages change over time.

Inputs: event (required), from_date (required), on (required), to_date (required), +4 more.

query_segmentation_bucketB

Get data for an event, segmented and filtered by properties, with values placed into numeric buckets. Useful for analyzing distributions of numeric values, creating histograms, and understanding the range of quantitative metrics.

Inputs: event (required), from_date (required), on (required), to_date (required), +5 more.

query_segmentation_reportB

Get data for an event, segmented and filtered by properties. Useful for breaking down event data by user attributes, comparing performance across segments, and identifying which user groups perform specific actions.

Inputs: event (required), from_date (required), to_date (required), where (required), +8 more.

query_segmentation_sumB

Sum a numeric expression for events over time. Useful for calculating revenue metrics, aggregating quantitative values, and tracking cumulative totals across different time periods.

Inputs: event (required), from_date (required), on (required), to_date (required), +4 more.

top_event_propertiesB

Get the top property names for an event. Useful for discovering which properties are most commonly associated with an event, prioritizing which dimensions to analyze, and understanding event structure.

Inputs: event (required), limit, project_id, workspace_id.

top_event_property_valuesB

Get the top values for a property. Useful for understanding the distribution of values for a specific property, identifying the most common categories or segments, and planning further targeted analyses.

Inputs: event (required), name (required), limit, project_id, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 19 tools

    Disambiguation4/5

    Most tools have distinct purposes with clear boundaries, such as query_funnel_report for funnel analysis versus query_retention_report for retention metrics. However, there is some overlap between aggregated_event_property_values and aggregate_event_counts, as both handle aggregated event data but differ in scope (single vs. multiple events), which could cause minor confusion for agents.

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout, such as list_saved_cohorts, query_funnel_report, and get_top_events. All tools use snake_case uniformly, with clear and predictable naming conventions that enhance readability and predictability for agents.

    Tool Count3/5

    With 19 tools, the count is borderline high for an analytics server, potentially overwhelming for agents to navigate efficiently. While the tools cover a broad range of Mixpanel functionalities, the number approaches the upper limit of what is manageable without clear categorization or grouping.

    Completeness5/5

    The tool set provides comprehensive coverage of Mixpanel's core analytics capabilities, including event analysis, segmentation, funnels, retention, and user profiling. There are no obvious gaps; tools like custom_jql even allow for advanced custom queries, ensuring agents can handle a wide variety of data analysis tasks without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A server that interfaces with the Mixpanel API, allowing users to query events data, retention, and funnels through natural language from any MCP client like Cursor or Claude Desktop.
      13
      36 npm
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables ChatGPT to query and analyze Mixpanel analytics data in real-time. Provides live access to event segmentation and detailed analytics data from your Mixpanel project through natural language.
      -
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that provides access to the Mixpanel REST API, enabling AI agents to query events, funnels, retention data, and user profiles. It allows users to perform complex analytics tasks and export raw event data through natural language prompts.
      16
      MIT