Mixpanel

Live 54 Actions

Mixpanel Integration for AI Agents

Connect your AI agent to 54 Mixpanel actions via MCP, A2A, or SDK, with agent authentication, tool-calling execution, and security built-in.

Start Free Book Demo Mixpanel MCP Server

Mixpanel AI Agent Actions

54 production-ready actions for your agent to do more on Mixpanel.

Read the Mixpanel docs

54 Actions

List Annotations - Retrieve all annotations within a date range for the Mixpanel project via GET /api/app/projects/{projectId}/annotations. Annotations are visual markers on Mixpanel charts that denote significant events such as product releases, marketing campaigns, or infrastructure changes.

Get Annotation - Retrieve a single annotation by its numeric ID via GET /api/app/projects/{projectId}/annotations/{annotationId}. Returns the annotation's date, description, and associated tags.

Create Annotation - Create a new annotation via POST /api/app/projects/{projectId}/annotations to mark a significant event on Mixpanel charts. Accepts a date in YYYY-MM-DD HH:MM:SS format, a descriptive label, and optional tag IDs for categorization.

Patch Annotation - Partially update an existing annotation via PATCH /api/app/projects/{projectId}/annotations/{annotationId}. Supports modifying the description text and tag associations without replacing the entire annotation.

Delete Annotation - Permanently delete an annotation from the project via DELETE /api/app/projects/{projectId}/annotations/{annotationId}. This action is irreversible and removes the visual marker from all Mixpanel charts.

List Annotation Tags - Retrieve all annotation tags defined in the project via GET /api/app/projects/{projectId}/annotations/tags. Tags are reusable labels that can be attached to annotations for categorization and filtering.

Create Annotation Tag - Create a new reusable annotation tag via POST /api/app/projects/{projectId}/annotations/tags. Tags can then be attached to annotations via create_annotation or patch_annotation to categorize chart markers.

List Cohorts - Retrieve all saved cohorts in the Mixpanel project via POST /api/query/cohorts/list. Returns cohort metadata including IDs, names, and creation dates, which can then be used with query_cohort_members to retrieve the users belonging to each cohort.

Query Cohort Members - Retrieve user profiles belonging to a specific cohort via the Engage API (POST /api/query/engage) using filter_by_cohort. Supports pagination with session_id and page parameters, property projection with output_properties, and additional filtering with where expressions.

Import Events - Bulk-import historical or server-side events into Mixpanel via POST /import, supporting up to 2000 events per batch (10MB max). Provide events as a structured JSON array of event objects (not a stringified array). Each event requires a past timestamp, distinct_id, and $insert_id for deduplication; future timestamps are rejected with a 400 error. Use strict=1 to receive per-event validation errors. A response of data=1 means the whole batch was accepted (it is not a per-event count). Always call this action to import the events. Provide each event's time as a Unix timestamp in seconds or milliseconds, converting any described date and clock time (including relative dates and times) into a past Unix timestamp yourself.

Export Events - Export raw event data from Mixpanel via GET /api/2.0/export for a specified date range, returned as newline-delimited JSON (JSONL). Rate limited to 60 queries per hour with max 5 concurrent queries. Supports filtering by event name and property expressions, with a maximum of 100,000 events per request.

Set Group Properties - Set properties on a group profile (e.g. accounts, companies, workspaces) via POST /groups with the $set operation. Creates the group profile if it does not exist, and overwrites each property's full value — including setting a list-valued property to the exact list provided (the previous list is replaced, not merged). This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty". Requires Group Analytics to be enabled in the Mixpanel project.

Delete Group - Permanently delete a group profile and all stored properties from Mixpanel via POST /groups with the $delete operation. This action is irreversible and removes all data associated with the specified group_key and group_id combination. Delete directly by group_key and group_id — do NOT query, search, or look up the group first; pass them straight to this action even when the request asks to validate or confirm the deletion. The response returns a status confirming the deletion. This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Set Group Properties Once - Set properties on a group profile via POST /groups with the $set_once operation, only writing values for properties that do not already exist. Ideal for immutable group attributes like "Created Date" or "Original Plan" that should never be overwritten. This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Union To Group List Property - Add unique values to a list property on a group profile via POST /groups with the $union operation; existing list items are preserved and duplicate values are ignored — it extends a list, it does not replace the property's value. Initialises the list property with the given values when it does not yet exist. This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Remove From Group List Property - Remove specific values from list properties on a group profile via POST /groups with the $remove operation. Silently skips values not present in the list. This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Unset Group Properties - Permanently remove specified property keys and their values from a group profile via POST /groups with the $unset operation. Unlike $remove (which targets values within lists), $unset deletes entire properties from the group profile. This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Get Unified Credentials - Return the authenticated identity, auth type, and connection metadata for the current Mixpanel Service Account, mapped to the IAM unified credentials schema. Mixpanel Service Accounts are machine identities — auth_type is pinned to "service_user".

List Unified Groups - List all teams in the Mixpanel organization mapped to the IAM unified group schema. Each team includes its stable id and name; members are exposed via unified_list_resource_users with resource_type=team.

Get Unified Group - Retrieve a single Mixpanel team by numeric id, mapped to the IAM unified group schema. Team members are exposed via unified_list_resource_users with resource_type=team.

List Unified Organizations - Returns the single Mixpanel organization that the Service Account is bound to. Synthesized from credentials.orgId — the Service Account API does not expose a list-organizations endpoint.

Get Unified Organization - Retrieve the single Mixpanel organization the Service Account is bound to. The id must match credentials.orgId; any other id returns a 404.

List Unified Resource Types - List the resource types Mixpanel supports for resource-scoped IAM queries. Mixpanel exposes "team" — teams expose member lists via the org teams endpoint.

List Unified Resource Users - List the members of a specific Mixpanel team (resource_type=team), with each member carrying a resource-scoped IamRole pinning them to that team.

List Unified Roles - Return the three workspace-level IAM roles for Mixpanel (owner, admin, member) synthesized from Mixpanel's organization roles. The set is closed; role ids match the role keys embedded in IamUser.roles[] on this connector.

Get Unified Role - Retrieve a single synthesized Mixpanel IAM role by its stable key (owner, admin, or member). The role namespace is closed to Mixpanel organization roles.

List Unified Users - List all users in the Mixpanel organization mapped to the IAM unified user schema. Pass expand=["roles"] and/or expand=["groups"] to inline each user's synthesized workspace role and team memberships.

Get Unified User - Retrieve a single Mixpanel organization user by numeric id, mapped to the IAM unified user schema. Pass expand=["roles"] and/or expand=["groups"] to inline the user's synthesized workspace role and team memberships.

Create Identity - Link an anonymous user ID to a known user ID via the $identify event on POST /track for identity resolution. This operation is irreversible and merges all historical events from the anonymous ID onto the identified user. Works with all Mixpanel ID management systems.

Merge Identities - Merge two distinct_ids into a single identity cluster via the $merge event on POST /import. This operation is irreversible and only works with projects using the Original ID Merge system. Requires exactly 2 distinct_ids in the array.

Create Alias - Create an alias linking one distinct_id to another via the $create_alias event on POST /track. Only compatible with Original ID Merge and Legacy ID Management systems. Each alias maps to exactly one distinct_id and cannot be reassigned once created.

List Lookup Tables - Retrieve all lookup tables in the Mixpanel project via GET /lookup-tables. Lookup tables map property values to additional dimensions (e.g. mapping product IDs to product names, categories, and prices) for richer analysis in reports and queries.

Replace Lookup Table - Replace all data in an existing lookup table via PUT /lookup-tables/{lookupTableId} with new CSV-formatted content. The first row must be column headers and the first column serves as the join key. This fully overwrites the existing table data.

Query User Profiles - Query user profiles from the Mixpanel Engage API using filters, cohort membership, behavioral selectors, or specific distinct_ids. Returns paginated profile data with support for property projection via output_properties to reduce response size.

Set User Profile Properties - Set properties on a user profile via POST /engage with the $set operation, creating the profile if it does not exist and overwriting each property's full value — including setting a list-valued property to the exact list provided (the previous list is replaced, not merged). This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty". The API returns HTTP 200 even when a record fails validation, so enable strict=1 and verbose=1 to detect errors in the response body.

Set User Profile Properties Once - Set properties on a user profile via POST /engage with the $set_once operation, only writing values for properties that do not already exist on the profile. Ideal for immutable attributes like "First Login Date" or "Original Source" that should never be overwritten. This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Increment User Profile Properties - Atomically increment or decrement numeric properties on a user profile via POST /engage with the $add operation. Use positive values to increment and negative values to decrement; ideal for counters like login count, purchase total, or points balance. This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Delete User Profile - Permanently delete a user profile and all stored properties from Mixpanel via POST /engage with the $delete operation. This action is irreversible. Delete directly by distinct_id — do NOT query, search, or look up the profile first; pass the distinct_id straight to this action even when the request asks to validate or confirm the deletion. The response returns a status confirming the deletion (set strict=1 to validate the request before it is processed). Set ignore_alias=true when the distinct_id is an alias to avoid accidentally deleting the canonical profile. This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Union To List Property - Add unique values to a list property on a user profile via POST /engage with the $union operation; existing list items are preserved and duplicate values are ignored — it extends a list, it does not replace the property's value. Initialises the list property with the given values when it does not yet exist. Useful for maintaining sets like "Favorite Categories" or "Completed Features". This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Append To List Property - Append values to list properties on a user profile via POST /engage with the $append operation, allowing duplicates unlike $union. Creates the list property if it does not exist. Useful for ordered logs like "Pages Visited" or "Items Added to Cart". This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Remove From List Property - Remove specific values from list properties on a user profile via POST /engage with the $remove operation. Silently skips values that do not exist in the list. Use this to maintain list properties by removing outdated or revoked items. This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Delete Profile Properties - Permanently remove specified properties and their values from a user profile via POST /engage with the $unset operation. Unlike $remove (which targets list values), $unset deletes entire property keys from the profile. This action sends the connection's Project Token as the ingestion $token, so a Project Token must be provided when connecting the account; without it the request fails with "$token, missing or empty".

Query Insights - Query a saved Insights report by bookmark ID via GET /api/query/insights, returning the computed time-series data for the report's configured events and filters. Rate limited to 60 queries per hour with max 5 concurrent queries. The bookmark_id is found in the Mixpanel URL as "report-BOOKMARK_ID".

Query Funnels - Query a saved Funnel report by funnel ID via GET /api/query/funnels, returning step-by-step conversion data for the specified date range. Supports segmentation via the "on" parameter and filtering via "where" expressions. Rate limited to 60 queries per hour with max 5 concurrent queries.

Query Retention - Query retention data via GET /api/query/retention, returning cohort-based retention metrics for a date range. Supports both "birth" (first-time) and "compounded" retention types, with configurable intervals and segmentation. Rate limited to 60 queries per hour with max 5 concurrent queries.

Query JQL - Execute custom JQL (JavaScript Query Language) scripts against Mixpanel data via POST /api/query/jql. JQL is in maintenance mode and may be deprecated in the future. Rate limited to 60 queries per hour with max 5 concurrent queries, a 2-minute execution timeout, and a 5GB data processing limit per query.

List Schemas - Retrieve all data dictionary schemas (event and profile definitions) in the Mixpanel project via GET /api/app/projects/{projectId}/schemas. Returns schema entries with entity types, names, descriptions, and property definitions.

List Schemas For Entity - Retrieve schemas filtered by entity type ("event" or "profile") via GET /api/app/projects/{projectId}/schemas/{entityType}. Optionally filter further by entity_name to find a specific event or profile schema definition.

List Schema By Entity And Name - Retrieve the schema definition for a specific entity by type and name via GET /api/app/projects/{projectId}/schemas/{entityType}/{name}. Returns the full property definitions, descriptions, and metadata for the specified event or profile schema.

Create/Replace Multiple Schemas - Bulk upload or replace data dictionary schemas via POST /api/app/projects/{projectId}/schemas. Existing schemas for specified entities are overwritten. Use the truncate option to clear the entire data dictionary before uploading.

Create/Replace One Schema - Upload or replace the schema for a single entity via POST /api/app/projects/{projectId}/schemas/{entityType}/{name}. Overwrites the existing schema definition including description, properties, and metadata for the specified event or profile.

Delete All Schemas - Permanently delete all data dictionary schemas in the project via DELETE /api/app/projects/{projectId}/schemas. This clears the entire data dictionary and is irreversible; use with caution in production environments.

Delete Schemas For Entity - Delete schemas by entity type via DELETE /api/app/projects/{projectId}/schemas/{entityType}. Optionally narrow deletion to a specific entity by providing entity_name; otherwise all schemas of the given type (event or profile) are removed.

Delete Schema - Delete the schema definition for a specific entity by type and name via DELETE /api/app/projects/{projectId}/schemas/{entityType}/{name}. Removes the property definitions and metadata for the specified event or profile from the data dictionary.

Do More, Build Less

Integration Infrastructure for Mixpanel AI Agents

Multiple Interfaces

Access integrations via API, AI SDKs, MCP & A2A.

Mixpanel MCP server

Managed Authentication

Pre-built authentication UI.

Agent auth

Falcon Engine

Every Mixpanel action runs on Falcon.

Agent Execution Engine

StackOne Defender

88.7% prompt injection detection.

Prompt injection defense

Start Free Book a Demo

"What impressed us most about StackOne is its ambition and clarity. They're creating infrastructure that modern software and the entire AI agent ecosystem can rely on. The depth of secure integrations, the pace of delivery, and the team's foresight into AI's future uniquely position StackOne to redefine this category."

Luna Schmid, Partner at GV

"We've been impressed by how quickly and deeply StackOne integrates with complex enterprise systems -- and now, with their focus on agent-to-agent interoperability, they're unlocking even more powerful use cases for customers. StackOne delivers all of the above in a universal layer -- without compromise."