Mixpanel

Get a single user profile by distinct_id. Args: - distinctId: The user's distinct ID Returns: User profile with all properties.

Delete an annotation. Args: - annotationId: The annotation ID to delete Returns: Success status.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Get the top properties for an event. Args: - eventName: Name of the event Returns: List of property names for the event.

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.

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.

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).

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.

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.

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.

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.

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.

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.

List all saved funnels in the Mixpanel project. Returns: Array of funnels with their IDs and names.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Get a specific annotation by ID. Args: - annotationId: The annotation ID Returns: The annotation details.

Update an existing annotation. Args: - annotationId: The annotation ID - date: New date (YYYY-MM-DD, optional) - description: New description (optional) Returns: The updated annotation.

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.

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.

Get a specific schema definition. Args: - entityType: Type of schema (event, profile, group, lookup_table) - name: Name of the schema Returns: The schema definition.

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.

Delete a schema definition. Args: - entityType: Type of schema (event, profile, group, lookup_table) - name: Name of the schema to delete Returns: Success status.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.