Mixpanel MCP by usefulapi

Working · 416 ms

io.usefulapi/mixpanelv1.17.0 Domain verified

Query Mixpanel events, funnels, retention, segmentation and insights (JQL).

Data & Databases

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://mixpanel.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

mixpanel_jql

Run a custom JQL (JavaScript Query Language) script for arbitrary analysis. Power-user escape hatch. Script must define main(). Query API: POST /jql. (Upstream maintenance mode; 2-min timeout, 5GB/query limit.)

scriptstring, required

JQL script defining function main(){ ... } that returns rows.

paramsstring

Optional JSON string exposed to the script as the `params` global.

Tools (7)

mixpanel_jql

read-only

Argument	Type	Description
params	string	Optional JSON string exposed to the script as the `params` global.
script*	string	JQL script defining function main(){ ... } that returns rows.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "script"
  ],
  "properties": {
    "params": {
      "type": "string",
      "description": "Optional JSON string exposed to the script as the `params` global."
    },
    "script": {
      "type": "string",
      "description": "JQL script defining function main(){ ... } that returns rows."
    }
  }
}

mixpanel_list_funnels

Get the funnel_id and name of every saved funnel in the project. Query API: GET /funnels/list.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

mixpanel_query_funnel

Get conversion data for a saved funnel (use mixpanel_list_funnels to find funnel_id). Query API: GET /funnels.

read-only

Argument	Type	Description
unit	string	Bucketing unit.
limit	integer	Limit on segmentation breakdown.
length	integer	Conversion window length.
to_date*	string	End date yyyy-mm-dd (inclusive).
interval	integer	Number of days per bucket.
from_date*	string	Start date yyyy-mm-dd (inclusive).
funnel_id*	integer	Saved funnel id (from mixpanel_list_funnels).
length_unit	string	Unit for `length`.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "funnel_id",
    "from_date",
    "to_date"
  ],
  "properties": {
    "unit": {
      "enum": [
        "day",
        "week",
        "month"
      ],
      "type": "string",
      "description": "Bucketing unit."
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Limit on segmentation breakdown.",
      "exclusiveMinimum": 0
    },
    "length": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Conversion window length.",
      "exclusiveMinimum": 0
    },
    "to_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End date yyyy-mm-dd (inclusive)."
    },
    "interval": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Number of days per bucket.",
      "exclusiveMinimum": 0
    },
    "from_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date yyyy-mm-dd (inclusive)."
    },
    "funnel_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Saved funnel id (from mixpanel_list_funnels)."
    },
    "length_unit": {
      "enum": [
        "day",
        "hour",
        "minute",
        "second",
        "week",
        "month"
      ],
      "type": "string",
      "description": "Unit for `length`."
    }
  }
}

mixpanel_query_insights

Fetch the computed data behind a saved Insights report by bookmark_id (the report id in the board URL). Mixpanel's recommended, non-deprecated path for programmatic reporting. Query API: GET /insights.

read-only

Argument	Type	Description
bookmark_id*	integer	Insights report id (bookmark_id) from the report URL.
workspace_id	integer	Workspace id, if applicable.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "bookmark_id"
  ],
  "properties": {
    "bookmark_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Insights report id (bookmark_id) from the report URL."
    },
    "workspace_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Workspace id, if applicable."
    }
  }
}

mixpanel_retention

Cohort retention: of users who did `born_event`, how many came back and did `event` over subsequent intervals. Query API: GET /retention.

read-only

Argument	Type	Description
unit	string	Interval unit. Default day.
event	string	Returning event to measure. If omitted, any event counts.
where	string	Filter expression applied to the returning event.
to_date*	string	End date yyyy-mm-dd (inclusive).
interval	integer	Units per bucket (<=90 if days). Default 1.
from_date*	string	Start date yyyy-mm-dd (inclusive).
born_event	string	The defining first event for a birth cohort. Required when retention_type=birth.
born_where	string	Filter expression applied to born_event.
interval_count	integer

mixpanel_segmentation

Count/segment/filter a single event over a date range. e.g. 'Signed up' by country last week. Params `on`/`where` use Mixpanel segmentation expressions like properties["$country_code"]. Query API: GET /segmentation. (Upstream maintenance mode — for saved reports prefer mixpanel_query_insights.)

read-only

Argument	Type	Description
on	string	Property expression to segment on, e.g. properties["$city"].
type	string	general \| unique \| average. Default general.
unit	string	Bucket size. Default day.
event*	string	Single event name to analyze (not an array).
limit	integer	Top N property values (only if `on` set). Default 60.
where	string	Filter expression, e.g. properties["$os"]=="iOS".
to_date*	string	End date yyyy-mm-dd (inclusive).
from_date*	string	Start date yyyy-mm-dd (inclusive).

mixpanel_top_events

List today's top events with counts and % change vs yesterday. Good first call to discover what events a project tracks. Query API: GET /events/top.

read-only

Argument	Type	Description
type	string	general (totals), unique (per-user), or average. Default general.
limit	integer	Max events to return. Default 100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "type": {
      "enum": [
        "general",
        "unique",
        "average"
      ],
      "type": "string",
      "description": "general (totals), unique (per-user), or average. Default general."
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Max events to return. Default 100.",
      "exclusiveMinimum": 0
    }
  }
}