Mixpanel

Mixpanel MCP Server for Cloudflare Workers

Available Tools

55 tools available in the Mixpanel MCP server. Each tool can be called by AI assistants to perform specific actions.

mixpanel_get_profile

Get a single user profile by distinct_id.

Args:

distinctId: The user's distinct ID

Returns: User profile with all properties.

{
  "type": "object",
  "required": [
    "distinctId"
  ],
  "properties": {
    "distinctId": {
      "type": "string",
      "description": "User distinct ID"
    }
  }
}

mixpanel_delete_annotation

Delete an annotation.

Args:

annotationId: The annotation ID to delete

Returns: Success status.

{
  "type": "object",
  "required": [
    "annotationId"
  ],
  "properties": {
    "annotationId": {
      "type": "number",
      "description": "Annotation ID to delete"
    }
  }
}

mixpanel_list_lookup_tables

List all lookup tables in the project.

Lookup tables allow you to enrich event data with additional context.

Returns: Array of lookup tables with their names and metadata.

{
  "type": "object",
  "properties": {}
}

mixpanel_get_event_names

Get a list of event names in the project.

Args:

type: Query type (general or unique)
limit: Maximum number of events to return

Returns: List of event names.

{
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "type": {
      "enum": [
        "general",
        "unique"
      ],
      "type": "string",
      "description": "Query type"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of events (default: 255)"
    }
  }
}

mixpanel_unset_group_properties

Remove properties from a group profile.

Requires X-Mixpanel-Project-Token header.

Args:

groupKey: The group key
groupId: The group ID
properties: Array of property names to remove

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "groupKey",
    "groupId",
    "properties"
  ],
  "properties": {
    "groupId": {
      "type": "string",
      "description": "Group ID"
    },
    "groupKey": {
      "type": "string",
      "description": "Group key"
    },
    "properties": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Property names to remove"
    }
  }
}

mixpanel_query_insights

Query event analytics from Mixpanel (counts, trends, breakdowns).

Args:

fromDate: Start date (YYYY-MM-DD)
toDate: End date (YYYY-MM-DD)
event: Event name to query (optional, queries all if not specified)
groupBy: Properties to group by (optional)
where: Filter expression (optional)
interval: Time interval (minute, hour, day, week, month)

Returns: Time series data with event counts grouped by the specified dimensions.

{
  "type": "object",
  "required": [
    "fromDate",
    "toDate"
  ],
  "properties": {
    "event": {
      "type": "string",
      "description": "Event name to query"
    },
    "where": {
      "type": "string",
      "description": "Filter expression (e.g., properties[\"country\"] == \"US"
    },
    "toDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "groupBy": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Properties to group by"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

mixpanel_query_segmentation

Query segmentation data for an event, optionally broken down by a property.

Args:

event: Event name to segment
fromDate: Start date (YYYY-MM-DD)
toDate: End date (YYYY-MM-DD)
type: Query type (general, unique, average)
unit: Time unit (minute, hour, day, week, month)
where: Filter expression
on: Property to segment by

Returns: Segmented event data over time.

{
  "type": "object",
  "required": [
    "event",
    "fromDate",
    "toDate"
  ],
  "properties": {
    "on": {
      "type": "string",
      "description": "Property to segment by (e.g., properties[\"browser\"])"
    },
    "type": {
      "enum": [
        "general",
        "unique",
        "average"
      ],
      "type": "string",
      "description": "Query type"
    },
    "unit": {
      "enum": [
        "minute",
        "hour",
        "day",
        "week",
        "month"
      ],
      "type": "string",
      "description": "Time unit"
    },
    "event": {
      "type": "string",
      "description": "Event name to segment"
    },
    "where": {
      "type": "string",
      "description": "Filter expression"
    },
    "toDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

mixpanel_query_segmentation_numeric

Query segmentation data with numeric bucketing for a property.

Args:

event: Event name
fromDate: Start date (YYYY-MM-DD)
toDate: End date (YYYY-MM-DD)
on: Numeric property to bucket
buckets: Number of buckets (optional)
type: Query type (general, unique, average)
where: Filter expression

Returns: Segmented data with numeric buckets.

{
  "type": "object",
  "required": [
    "event",
    "fromDate",
    "toDate",
    "on"
  ],
  "properties": {
    "on": {
      "type": "string",
      "description": "Numeric property to bucket"
    },
    "type": {
      "enum": [
        "general",
        "unique",
        "average"
      ],
      "type": "string",
      "description": "Query type"
    },
    "unit": {
      "enum": [
        "minute",
        "hour",
        "day",
        "week",
        "month"
      ],
      "type": "string",
      "description": "Time unit"
    },
    "event": {
      "type": "string",
      "description": "Event name"
    },
    "where": {
      "type": "string",
      "description": "Filter expression"
    },
    "toDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "buckets": {
      "type": "number",
      "description": "Number of buckets"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

mixpanel_query_segmentation_sum

Query the sum of a numeric property for an event over time.

Args:

event: Event name
fromDate: Start date (YYYY-MM-DD)
toDate: End date (YYYY-MM-DD)
on: Numeric property to sum
where: Filter expression

Returns: Sum of the property value over time.

{
  "type": "object",
  "required": [
    "event",
    "fromDate",
    "toDate",
    "on"
  ],
  "properties": {
    "on": {
      "type": "string",
      "description": "Numeric property to sum"
    },
    "unit": {
      "enum": [
        "minute",
        "hour",
        "day",
        "week",
        "month"
      ],
      "type": "string",
      "description": "Time unit"
    },
    "event": {
      "type": "string",
      "description": "Event name"
    },
    "where": {
      "type": "string",
      "description": "Filter expression"
    },
    "toDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

mixpanel_query_segmentation_average

Query the average of a numeric property for an event over time.

Args:

event: Event name
fromDate: Start date (YYYY-MM-DD)
toDate: End date (YYYY-MM-DD)
on: Numeric property to average
where: Filter expression

Returns: Average of the property value over time.

{
  "type": "object",
  "required": [
    "event",
    "fromDate",
    "toDate",
    "on"
  ],
  "properties": {
    "on": {
      "type": "string",
      "description": "Numeric property to average"
    },
    "unit": {
      "enum": [
        "minute",
        "hour",
        "day",
        "week",
        "month"
      ],
      "type": "string",
      "description": "Time unit"
    },
    "event": {
      "type": "string",
      "description": "Event name"
    },
    "where": {
      "type": "string",
      "description": "Filter expression"
    },
    "toDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

mixpanel_get_top_events

Get the top events by volume for the current day.

Args:

type: Query type (general = total, unique = unique users, average = per user)
limit: Maximum number of events to return

Returns: List of top events with counts and percent change.

{
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "type": {
      "enum": [
        "general",
        "average",
        "unique"
      ],
      "type": "string",
      "description": "Query type"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of events to return (default: 10)"
    }
  }
}

mixpanel_query_events

Query aggregate event counts over a time range.

Args:

event: Array of event names to query
fromDate: Start date (YYYY-MM-DD)
toDate: End date (YYYY-MM-DD)
type: Query type (general, unique, average)
unit: Time unit
where: Filter expression

Returns: Event counts grouped by time.

{
  "type": "object",
  "required": [
    "event",
    "fromDate",
    "toDate",
    "type"
  ],
  "properties": {
    "type": {
      "enum": [
        "general",
        "unique",
        "average"
      ],
      "type": "string",
      "description": "Query type"
    },
    "unit": {
      "enum": [
        "minute",
        "hour",
        "day",
        "week",
        "month"
      ],
      "type": "string",
      "description": "Time unit"
    },
    "event": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Event names to query"
    },
    "where": {
      "type": "string",
      "description": "Filter expression"
    },
    "toDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    },
    "interval": {
      "type": "number",
      "description": "Interval count"
    }
  }
}

mixpanel_get_event_properties

Get the top properties for an event.

Args:

eventName: Name of the event

Returns: List of property names for the event.

{
  "type": "object",
  "required": [
    "eventName"
  ],
  "properties": {
    "eventName": {
      "type": "string",
      "description": "Event name"
    }
  }
}

mixpanel_get_property_values

Get distinct values for an event property.

Args:

event: Event name
property: Property name
limit: Maximum number of values to return

Returns: List of distinct property values.

{
  "type": "object",
  "required": [
    "event",
    "property"
  ],
  "properties": {
    "event": {
      "type": "string",
      "description": "Event name"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of values (default: 100)"
    },
    "property": {
      "type": "string",
      "description": "Property name"
    }
  }
}

mixpanel_get_top_property_values

Get the top values for an event property with counts.

Args:

event: Event name
property: Property name
limit: Maximum number of values to return

Returns: List of property values with their counts.

{
  "type": "object",
  "required": [
    "event",
    "property"
  ],
  "properties": {
    "event": {
      "type": "string",
      "description": "Event name"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of values (default: 100)"
    },
    "property": {
      "type": "string",
      "description": "Property name"
    }
  }
}

mixpanel_get_data_retrieval_status

Check the status of a GDPR data retrieval request.

Requires X-Mixpanel-Project-Token header.

Args:

requestId: The retrieval request ID

Returns: Status and results (if complete).

{
  "type": "object",
  "required": [
    "requestId"
  ],
  "properties": {
    "requestId": {
      "type": "string",
      "description": "Retrieval request ID"
    }
  }
}

mixpanel_execute_jql

Execute a JQL (JavaScript Query Language) query against Mixpanel data.

JQL allows complex, custom queries using JavaScript-like syntax. See Mixpanel JQL documentation for query syntax.

Args:

script: JQL script to execute

Returns: Query results.

{
  "type": "object",
  "required": [
    "script"
  ],
  "properties": {
    "script": {
      "type": "string",
      "description": "JQL script to execute"
    }
  }
}

mixpanel_list_cohorts

List all saved cohorts in the Mixpanel project.

Cohorts are saved groups of users based on their behavior or properties.

Returns: Array of cohorts with their IDs, names, and metadata.

{
  "type": "object",
  "properties": {}
}

mixpanel_export_events

Export raw event data from Mixpanel.

Returns individual events with all properties. Useful for detailed analysis.

Args:

fromDate: Start date (YYYY-MM-DD)
toDate: End date (YYYY-MM-DD)
event: Array of event names to filter (optional)
where: Filter expression (optional)
limit: Maximum number of events to return

Returns: Array of raw events with their properties.

{
  "type": "object",
  "required": [
    "fromDate",
    "toDate"
  ],
  "properties": {
    "event": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Event names to filter"
    },
    "limit": {
      "type": "number",
      "description": "Maximum events to return"
    },
    "where": {
      "type": "string",
      "description": "Filter expression"
    },
    "toDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

mixpanel_track_event

Track a single event to Mixpanel.

Requires X-Mixpanel-Project-Token header.

Args:

event: Event name
distinctId: User distinct ID
properties: Additional event properties (optional)
time: Unix timestamp (optional, defaults to now)

Returns: Status of the tracking operation.

{
  "type": "object",
  "required": [
    "event",
    "distinctId"
  ],
  "properties": {
    "time": {
      "type": "number",
      "description": "Unix timestamp"
    },
    "event": {
      "type": "string",
      "description": "Event name"
    },
    "distinctId": {
      "type": "string",
      "description": "User distinct ID"
    },
    "properties": {
      "type": "object",
      "description": "Additional event properties"
    }
  }
}

mixpanel_track_events

Track multiple events to Mixpanel in a single request.

Requires X-Mixpanel-Project-Token header.

Args:

events: Array of events, each with:
- event: Event name
- properties: Object with distinct_id and optional properties/time

Returns: Status of the tracking operation.

{
  "type": "object",
  "required": [
    "event",
    "distinct_id"
  ],
  "properties": {
    "time": {
      "type": "number",
      "description": "Unix timestamp"
    },
    "event": {
      "type": "string",
      "description": "Event name"
    },
    "distinct_id": {
      "type": "string",
      "description": "User distinct ID"
    }
  }
}

mixpanel_import_events

Import historical events to Mixpanel.

Use this for backfilling historical data. Events must have a time property. Requires X-Mixpanel-Project-Token header.

Args:

events: Array of events, each with:
- event: Event name
- properties: Object with distinct_id, time, and optional $insert_id

Returns: Import status with count of records imported.

{
  "type": "object",
  "required": [
    "event",
    "distinct_id",
    "time"
  ],
  "properties": {
    "time": {
      "type": "number",
      "description": "Unix timestamp (required for imports)"
    },
    "event": {
      "type": "string",
      "description": "Event name"
    },
    "insert_id": {
      "type": "string",
      "description": "Unique ID for deduplication"
    },
    "distinct_id": {
      "type": "string",
      "description": "User distinct ID"
    }
  }
}

mixpanel_list_funnels

List all saved funnels in the Mixpanel project.

Returns: Array of funnels with their IDs and names.

{
  "type": "object",
  "properties": {}
}

mixpanel_get_funnel

Get conversion data for a saved funnel.

Args:

funnelId: ID of the saved funnel
fromDate: Start date (YYYY-MM-DD)
toDate: End date (YYYY-MM-DD)
interval: Time interval for grouping (day, week, month)
length: Conversion window length
lengthUnit: Conversion window unit (day, hour, minute, week)

Returns: Funnel conversion data with step-by-step metrics.

{
  "type": "object",
  "required": [
    "funnelId",
    "fromDate",
    "toDate"
  ],
  "properties": {
    "length": {
      "type": "number",
      "description": "Conversion window length"
    },
    "toDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    },
    "funnelId": {
      "type": "number",
      "description": "Funnel ID"
    },
    "interval": {
      "enum": [
        "day",
        "week",
        "month"
      ],
      "type": "string",
      "description": "Time interval"
    },
    "lengthUnit": {
      "enum": [
        "day",
        "hour",
        "minute",
        "week"
      ],
      "type": "string",
      "description": "Conversion window unit"
    }
  }
}

mixpanel_get_retention

Get retention cohort data.

Analyze how many users who performed a "born" event return to perform another event.

Args:

fromDate: Start date (YYYY-MM-DD)
toDate: End date (YYYY-MM-DD)
bornEvent: Event that defines the cohort (when users are "born")
event: Return event to track
retentionType: 'birth' (classic) or 'compounding' (rolling)
interval: Days between retention periods
intervalCount: Number of retention periods
unit: Time unit (day, week, month)

Returns: Retention data showing percent of users returning over time.

{
  "type": "object",
  "required": [
    "fromDate",
    "toDate"
  ],
  "properties": {
    "unit": {
      "enum": [
        "day",
        "week",
        "month"
      ],
      "type": "string",
      "description": "Time unit"
    },
    "event": {
      "type": "string",
      "description": "Return event to track"
    },
    "toDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    },
    "interval": {
      "type": "number",
      "description": "Days between retention periods"
    },
    "bornEvent": {
      "type": "string",
      "description": "Event that defines the cohort"
    },
    "intervalCount": {
      "type": "number",
      "description": "Number of retention periods"
    },
    "retentionType": {
      "enum": [
        "birth",
        "compounding"
      ],
      "type": "string",
      "description": "Retention type"
    }
  }
}

mixpanel_get_frequency

Get frequency analysis for an event.

Shows how often users perform an event within the time period.

Args:

fromDate: Start date (YYYY-MM-DD)
toDate: End date (YYYY-MM-DD)
event: Event name to analyze
where: Filter expression
on: Property to segment by

Returns: Frequency distribution data.

{
  "type": "object",
  "required": [
    "fromDate",
    "toDate",
    "event"
  ],
  "properties": {
    "on": {
      "type": "string",
      "description": "Property to segment by"
    },
    "event": {
      "type": "string",
      "description": "Event name to analyze"
    },
    "where": {
      "type": "string",
      "description": "Filter expression"
    },
    "toDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

mixpanel_create_data_retrieval

Create a GDPR data retrieval request.

Request an export of all data for specific users. Requires X-Mixpanel-Project-Token header.

Args:

distinctIds: Array of user distinct IDs to retrieve data for
dataType: Type of data to retrieve (events or people)
completionEmail: Email to notify when retrieval is complete

Returns: Request ID and status.

{
  "type": "object",
  "required": [
    "distinctIds"
  ],
  "properties": {
    "dataType": {
      "enum": [
        "events",
        "people"
      ],
      "type": "string",
      "description": "Data type to retrieve"
    },
    "distinctIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User distinct IDs"
    },
    "completionEmail": {
      "type": "string",
      "description": "Notification email"
    }
  }
}

mixpanel_create_data_deletion

Create a GDPR data deletion request.

Request permanent deletion of all data for specific users. This action is irreversible once processing begins. Requires X-Mixpanel-Project-Token header.

Args:

distinctIds: Array of user distinct IDs to delete data for

Returns: Request ID and status.

{
  "type": "object",
  "required": [
    "distinctIds"
  ],
  "properties": {
    "distinctIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User distinct IDs to delete"
    }
  }
}

mixpanel_get_data_deletion_status

Check the status of a GDPR data deletion request.

Requires X-Mixpanel-Project-Token header.

Args:

requestId: The deletion request ID

Returns: Status of the deletion request.

{
  "type": "object",
  "required": [
    "requestId"
  ],
  "properties": {
    "requestId": {
      "type": "string",
      "description": "Deletion request ID"
    }
  }
}

mixpanel_cancel_data_deletion

Cancel a pending GDPR data deletion request.

Can only cancel requests that haven't started processing yet. Requires X-Mixpanel-Project-Token header.

Args:

requestId: The deletion request ID to cancel

Returns: Success status.

{
  "type": "object",
  "required": [
    "requestId"
  ],
  "properties": {
    "requestId": {
      "type": "string",
      "description": "Deletion request ID to cancel"
    }
  }
}

mixpanel_set_group_properties

Set properties on a group profile.

Groups are used for B2B/account-level analytics (e.g., companies, workspaces). Requires X-Mixpanel-Project-Token header.

Args:

groupKey: The group key (e.g., "company", "workspace")
groupId: The group ID (e.g., "acme-corp")
properties: Object of properties to set

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "groupKey",
    "groupId",
    "properties"
  ],
  "properties": {
    "groupId": {
      "type": "string",
      "description": "Group ID"
    },
    "groupKey": {
      "type": "string",
      "description": "Group key (e.g., \"company"
    },
    "properties": {
      "type": "object",
      "description": "Properties to set"
    }
  }
}

mixpanel_set_group_properties_once

Set properties on a group profile only if they don't already exist.

Requires X-Mixpanel-Project-Token header.

Args:

groupKey: The group key (e.g., "company")
groupId: The group ID
properties: Object of properties to set if not existing

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "groupKey",
    "groupId",
    "properties"
  ],
  "properties": {
    "groupId": {
      "type": "string",
      "description": "Group ID"
    },
    "groupKey": {
      "type": "string",
      "description": "Group key"
    },
    "properties": {
      "type": "object",
      "description": "Properties to set if not existing"
    }
  }
}

mixpanel_delete_group

Delete a group profile entirely.

Requires X-Mixpanel-Project-Token header.

Args:

groupKey: The group key
groupId: The group ID

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "groupKey",
    "groupId"
  ],
  "properties": {
    "groupId": {
      "type": "string",
      "description": "Group ID to delete"
    },
    "groupKey": {
      "type": "string",
      "description": "Group key"
    }
  }
}

mixpanel_create_identity

Link an anonymous user ID to an identified user ID.

Use this when a user logs in or signs up to connect their anonymous activity to their identified profile. Requires X-Mixpanel-Project-Token header.

Args:

distinctId: The identified user ID (e.g., user ID from your database)
anonId: The anonymous ID (e.g., device ID before login)

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId",
    "anonId"
  ],
  "properties": {
    "anonId": {
      "type": "string",
      "description": "Anonymous user ID to link"
    },
    "distinctId": {
      "type": "string",
      "description": "Identified user ID"
    }
  }
}

mixpanel_create_alias

Create an alias for a user (legacy identity management).

Note: For new projects, use mixpanel_create_identity instead. Aliases allow you to associate multiple IDs with the same user. Requires X-Mixpanel-Project-Token header.

Args:

distinctId: The primary distinct ID
alias: The alias to create

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId",
    "alias"
  ],
  "properties": {
    "alias": {
      "type": "string",
      "description": "Alias to create"
    },
    "distinctId": {
      "type": "string",
      "description": "Primary distinct ID"
    }
  }
}

mixpanel_merge_identities

Merge two user identities into one.

All events and profile data from both IDs will be combined. This is useful when you discover two IDs belong to the same person. Requires X-Mixpanel-Project-Token header.

Args:

distinctId1: First distinct ID
distinctId2: Second distinct ID

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId1",
    "distinctId2"
  ],
  "properties": {
    "distinctId1": {
      "type": "string",
      "description": "First distinct ID"
    },
    "distinctId2": {
      "type": "string",
      "description": "Second distinct ID to merge"
    }
  }
}

mixpanel_list_annotations

List annotations in the Mixpanel project.

Annotations mark significant events like releases, campaigns, etc.

Args:

fromDate: Start date filter (YYYY-MM-DD)
toDate: End date filter (YYYY-MM-DD)

Returns: Array of annotations.

{
  "type": "object",
  "properties": {
    "toDate": {
      "type": "string",
      "description": "End date filter (YYYY-MM-DD)"
    },
    "fromDate": {
      "type": "string",
      "description": "Start date filter (YYYY-MM-DD)"
    }
  }
}

mixpanel_create_annotation

Create an annotation to mark a significant event.

Annotations appear on charts to help explain data changes.

Args:

date: Date for the annotation (YYYY-MM-DD)
description: Description of the event

Returns: The created annotation.

{
  "type": "object",
  "required": [
    "date",
    "description"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Date (YYYY-MM-DD)"
    },
    "description": {
      "type": "string",
      "description": "Annotation description"
    }
  }
}

mixpanel_get_annotation

Get a specific annotation by ID.

Args:

annotationId: The annotation ID

Returns: The annotation details.

{
  "type": "object",
  "required": [
    "annotationId"
  ],
  "properties": {
    "annotationId": {
      "type": "number",
      "description": "Annotation ID"
    }
  }
}

mixpanel_update_annotation

Update an existing annotation.

Args:

annotationId: The annotation ID
date: New date (YYYY-MM-DD, optional)
description: New description (optional)

Returns: The updated annotation.

{
  "type": "object",
  "required": [
    "annotationId"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "New date (YYYY-MM-DD)"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "annotationId": {
      "type": "number",
      "description": "Annotation ID"
    }
  }
}

mixpanel_create_lookup_table

Create or replace a lookup table.

Lookup tables enrich event data with additional context. The first column is used as the join key.

Args:

tableName: Name of the lookup table
data: Array of objects representing table rows

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "tableName",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of row objects"
    },
    "tableName": {
      "type": "string",
      "description": "Lookup table name"
    }
  }
}

mixpanel_list_schemas

List data schemas (Lexicon) in the project.

Schemas define the structure and metadata for events, profiles, and groups.

Args:

entityType: Type of schema (event, profile, group, lookup_table)

Returns: Array of schemas.

{
  "type": "object",
  "properties": {}
}

mixpanel_get_schema

Get a specific schema definition.

Args:

entityType: Type of schema (event, profile, group, lookup_table)
name: Name of the schema

Returns: The schema definition.

{
  "type": "object",
  "required": [
    "entityType",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Schema name"
    },
    "entityType": {
      "enum": [
        "event",
        "profile",
        "group",
        "lookup_table"
      ],
      "type": "string",
      "description": "Schema type"
    }
  }
}

mixpanel_create_schema

Create or update a schema definition.

Schemas help document and validate your tracking plan.

Args:

entityType: Type of schema (event, profile, group, lookup_table)
name: Name of the schema
schemaJson: Schema definition object

Returns: Success status.

{
  "type": "object",
  "required": [
    "entityType",
    "name",
    "schemaJson"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Schema name"
    },
    "entityType": {
      "enum": [
        "event",
        "profile",
        "group",
        "lookup_table"
      ],
      "type": "string",
      "description": "Schema type"
    },
    "schemaJson": {
      "type": "object",
      "description": "Schema definition"
    }
  }
}

mixpanel_delete_schema

Delete a schema definition.

Args:

entityType: Type of schema (event, profile, group, lookup_table)
name: Name of the schema to delete

Returns: Success status.

{
  "type": "object",
  "required": [
    "entityType",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Schema name to delete"
    },
    "entityType": {
      "enum": [
        "event",
        "profile",
        "group",
        "lookup_table"
      ],
      "type": "string",
      "description": "Schema type"
    }
  }
}

mixpanel_query_profiles

Query user profiles from Mixpanel.

Args:

where: Filter expression (e.g., properties["$country_code"] == "US")
sessionId: Session ID for pagination (from previous response)
page: Page number for pagination
outputProperties: List of properties to include in response

Returns: Paginated list of user profiles with their properties.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "where": {
      "type": "string",
      "description": "Filter expression"
    },
    "sessionId": {
      "type": "string",
      "description": "Session ID for pagination"
    },
    "outputProperties": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Properties to include"
    }
  }
}

mixpanel_get_profile_activity

Get recent event activity for a user profile.

Args:

distinctId: The user's distinct ID
limit: Maximum number of events to return
from: Unix timestamp for start of range
to: Unix timestamp for end of range

Returns: List of recent events for the user.

{
  "type": "object",
  "required": [
    "distinctId"
  ],
  "properties": {
    "to": {
      "type": "number",
      "description": "End timestamp (Unix)"
    },
    "from": {
      "type": "number",
      "description": "Start timestamp (Unix)"
    },
    "limit": {
      "type": "number",
      "description": "Maximum events to return"
    },
    "distinctId": {
      "type": "string",
      "description": "User distinct ID"
    }
  }
}

mixpanel_set_profile_properties

Set properties on a user profile. Overwrites existing values.

Requires X-Mixpanel-Project-Token header.

Args:

distinctId: The user's distinct ID
properties: Object of properties to set

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId",
    "properties"
  ],
  "properties": {
    "distinctId": {
      "type": "string",
      "description": "User distinct ID"
    },
    "properties": {
      "type": "object",
      "description": "Properties to set"
    }
  }
}

mixpanel_set_profile_properties_once

Set properties on a user profile only if they don't already exist.

Useful for setting properties like "First Seen" or "Sign Up Date". Requires X-Mixpanel-Project-Token header.

Args:

distinctId: The user's distinct ID
properties: Object of properties to set (only if not already set)

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId",
    "properties"
  ],
  "properties": {
    "distinctId": {
      "type": "string",
      "description": "User distinct ID"
    },
    "properties": {
      "type": "object",
      "description": "Properties to set if not existing"
    }
  }
}

mixpanel_increment_profile_properties

Increment numeric properties on a user profile.

Useful for counters like "Login Count" or "Purchase Count". Requires X-Mixpanel-Project-Token header.

Args:

distinctId: The user's distinct ID
properties: Object of numeric properties to increment

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId",
    "properties"
  ],
  "properties": {
    "distinctId": {
      "type": "string",
      "description": "User distinct ID"
    },
    "properties": {
      "type": "object",
      "description": "Properties to increment (property: amount)"
    }
  }
}

mixpanel_append_to_profile_list

Append values to a list property on a user profile.

Requires X-Mixpanel-Project-Token header.

Args:

distinctId: The user's distinct ID
property: Name of the list property
values: Array of values to append

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId",
    "property",
    "values"
  ],
  "properties": {
    "values": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Values to append"
    },
    "property": {
      "type": "string",
      "description": "List property name"
    },
    "distinctId": {
      "type": "string",
      "description": "User distinct ID"
    }
  }
}

mixpanel_remove_from_profile_list

Remove values from a list property on a user profile.

Requires X-Mixpanel-Project-Token header.

Args:

distinctId: The user's distinct ID
property: Name of the list property
values: Array of values to remove

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId",
    "property",
    "values"
  ],
  "properties": {
    "values": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Values to remove"
    },
    "property": {
      "type": "string",
      "description": "List property name"
    },
    "distinctId": {
      "type": "string",
      "description": "User distinct ID"
    }
  }
}

mixpanel_union_to_profile_list

Add values to list properties only if they don't already exist (set union).

Requires X-Mixpanel-Project-Token header.

Args:

distinctId: The user's distinct ID
properties: Object mapping list property names to arrays of values

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId",
    "properties"
  ],
  "properties": {
    "distinctId": {
      "type": "string",
      "description": "User distinct ID"
    },
    "properties": {
      "type": "object",
      "description": "Properties with values to union"
    }
  }
}

mixpanel_unset_profile_properties

Remove properties from a user profile.

Requires X-Mixpanel-Project-Token header.

Args:

distinctId: The user's distinct ID
properties: Array of property names to remove

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId",
    "properties"
  ],
  "properties": {
    "distinctId": {
      "type": "string",
      "description": "User distinct ID"
    },
    "properties": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Property names to remove"
    }
  }
}

mixpanel_delete_profile

Delete a user profile entirely.

This permanently removes the profile and all its properties. Requires X-Mixpanel-Project-Token header.

Args:

distinctId: The user's distinct ID

Returns: Status of the operation.

{
  "type": "object",
  "required": [
    "distinctId"
  ],
  "properties": {
    "distinctId": {
      "type": "string",
      "description": "User distinct ID to delete"
    }
  }
}