diff --git a/.claude-plugin/.upstream-base b/.claude-plugin/.upstream-base index 612a025921..df1d185ce3 100644 --- a/.claude-plugin/.upstream-base +++ b/.claude-plugin/.upstream-base @@ -1 +1 @@ -6b0300214a09fd6029cfb7077043125758cd1fd2 +de8ee15dd1194627d21eb5fcd41cb1873208dabb diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 153216eb7e..b8fdf4b576 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -128,6 +128,11 @@ "source": "third_party/google-ads", "description": "Report on campaigns, research keywords, and make previewed changes." }, + { + "name": "google-analytics", + "source": "third_party/google-analytics", + "description": "Run GA4 reports and manage property configuration." + }, { "name": "gong", "source": "third_party/gong", @@ -619,8 +624,8 @@ "description": "Work with clients, requests, quotes, jobs, visits, and invoices." }, { - "name": "databricks-genie-one", - "source": "third_party/databricks-genie-one", + "name": "databricks-genie", + "source": "third_party/databricks-genie", "description": "Ask Databricks Genie questions about your workspace's data in plain language." }, { @@ -697,6 +702,16 @@ "name": "fitmetrics", "source": "third_party/fitmetrics", "description": "Review Trainerize clients and check-ins, and update macros, messages, and programs." + }, + { + "name": "mixpanel", + "source": "third_party/mixpanel", + "description": "Query events, funnels, flows, and retention in Mixpanel, and manage dashboards, cohorts, experiments, and feature flags." + }, + { + "name": "metricool", + "source": "third_party/metricool", + "description": "Plan and publish social posts, pull metrics and reports, and manage inbox, reviews, and ads across your Metricool brands." } ] } diff --git a/third_party/databricks-genie-one/.cursor-plugin/plugin.json b/third_party/databricks-genie/.cursor-plugin/plugin.json similarity index 89% rename from third_party/databricks-genie-one/.cursor-plugin/plugin.json rename to third_party/databricks-genie/.cursor-plugin/plugin.json index 4371307e46..c458d89613 100644 --- a/third_party/databricks-genie-one/.cursor-plugin/plugin.json +++ b/third_party/databricks-genie/.cursor-plugin/plugin.json @@ -1,7 +1,7 @@ { - "name": "databricks-genie-one", - "displayName": "Databricks Genie One", - "version": "1.0.1", + "name": "databricks-genie", + "displayName": "Databricks Genie", + "version": "1.1.0", "minClientVersions": { "cursor": "3.19.0" }, @@ -10,14 +10,13 @@ "name": "Cursor", "email": "plugins@cursor.com" }, - "homepage": "https://github.com/cursor/plugins/tree/main/third_party/databricks-genie-one", + "homepage": "https://github.com/cursor/plugins/tree/main/third_party/databricks-genie", "repository": "https://github.com/cursor/plugins", "license": "MIT", "logo": "assets/logo.png", "keywords": [ "databricks", "genie", - "genie one", "data", "analytics", "sql", diff --git a/third_party/databricks-genie-one/CHANGELOG.md b/third_party/databricks-genie/CHANGELOG.md similarity index 83% rename from third_party/databricks-genie-one/CHANGELOG.md rename to third_party/databricks-genie/CHANGELOG.md index 796051b363..d8188ad6cb 100644 --- a/third_party/databricks-genie-one/CHANGELOG.md +++ b/third_party/databricks-genie/CHANGELOG.md @@ -2,6 +2,10 @@ All notable changes to this plugin will be documented here. +## 1.1.0 — Databricks Genie + +- Renamed the plugin from Databricks Genie One to Databricks Genie. The plugin id and MCP server key are now `databricks-genie`. + ## 1.0.1 — Genie icon - Logo: replaced the Databricks mark with Databricks' official Genie icon from https://www.databricks.com/sites/default/files/2026-05/icon-genie.svg, rendered at 192×192 on a transparent background. No server or client-version changes. diff --git a/third_party/databricks-genie-one/LICENSE b/third_party/databricks-genie/LICENSE similarity index 100% rename from third_party/databricks-genie-one/LICENSE rename to third_party/databricks-genie/LICENSE diff --git a/third_party/databricks-genie-one/README.md b/third_party/databricks-genie/README.md similarity index 85% rename from third_party/databricks-genie-one/README.md rename to third_party/databricks-genie/README.md index 2c827a07b8..84f8e4bdc4 100644 --- a/third_party/databricks-genie-one/README.md +++ b/third_party/databricks-genie/README.md @@ -1,25 +1,25 @@ -# Databricks Genie One +# Databricks Genie -Cursor plugin that connects agents to [Databricks Genie](https://www.databricks.com/product/business-intelligence/genie) through the Genie One [Model Context Protocol](https://modelcontextprotocol.io/) server on your Databricks workspace. +Cursor plugin that connects agents to [Databricks Genie](https://www.databricks.com/product/business-intelligence/genie) through the Genie [Model Context Protocol](https://modelcontextprotocol.io/) server on your Databricks workspace. Agents ask Genie questions about your workspace's data in plain language, and Genie answers from the data the signed-in user can read. ## Install 1. A Databricks account admin creates an OAuth app connection (see [Team setup](#team-setup)). -2. A Cursor team admin opens **Cursor Settings → Plugins**, searches for **Databricks Genie One**, installs it for the team, and enters the workspace hostname and client. +2. A Cursor team admin opens **Cursor Settings → Plugins**, searches for **Databricks Genie**, installs it for the team, and enters the workspace hostname and client. 3. Each member signs in to Databricks when Cursor prompts them. -Or run `/add-plugin databricks-genie-one` in chat. +Or run `/add-plugin databricks-genie` in chat. ## MCP -The plugin points at your workspace's Genie One endpoint: +The plugin points at your workspace's Genie endpoint: ```json { "mcpServers": { - "databricks-genie-one": { + "databricks-genie": { "type": "http", "url": "https://${DATABRICKS_HOST}/ai-gateway/mcp-services/system.ai.genie_one_mcp", "auth": { diff --git a/third_party/databricks-genie-one/assets/logo.png b/third_party/databricks-genie/assets/logo.png similarity index 100% rename from third_party/databricks-genie-one/assets/logo.png rename to third_party/databricks-genie/assets/logo.png diff --git a/third_party/databricks-genie-one/mcp.json b/third_party/databricks-genie/mcp.json similarity index 91% rename from third_party/databricks-genie-one/mcp.json rename to third_party/databricks-genie/mcp.json index 9469cd7fff..a51a11004d 100644 --- a/third_party/databricks-genie-one/mcp.json +++ b/third_party/databricks-genie/mcp.json @@ -1,6 +1,6 @@ { "mcpServers": { - "databricks-genie-one": { + "databricks-genie": { "type": "http", "url": "https://${DATABRICKS_HOST}/ai-gateway/mcp-services/system.ai.genie_one_mcp", "auth": { diff --git a/third_party/google-analytics/.cursor-plugin/plugin.json b/third_party/google-analytics/.cursor-plugin/plugin.json new file mode 100644 index 0000000000..012edce15e --- /dev/null +++ b/third_party/google-analytics/.cursor-plugin/plugin.json @@ -0,0 +1,35 @@ +{ + "name": "google-analytics", + "displayName": "Google Analytics", + "version": "1.0.0", + "minClientVersions": { + "cursor": "never", + "grokbot": "0.30.0", + "sand": "0.30.0" + }, + "description": "Run GA4 reports and manage property configuration.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://github.com/cursor/plugins/tree/main/third_party/google-analytics", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.svg", + "keywords": [ + "google-analytics", + "analytics", + "ga4", + "google", + "reports", + "mcp" + ], + "category": "integrations", + "tags": [ + "google-analytics", + "analytics", + "ga4", + "mcp" + ], + "mcpServers": "./mcp.json" +} diff --git a/third_party/google-analytics/CHANGELOG.md b/third_party/google-analytics/CHANGELOG.md new file mode 100644 index 0000000000..befd480a9c --- /dev/null +++ b/third_party/google-analytics/CHANGELOG.md @@ -0,0 +1,8 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 - initial release + +- Logo: official Google Analytics product icon on a padded white tile. +- Added the `google-analytics` MCP server pointing at `https://api.cursor.com/rest-mcp/google-analytics/mcp`. diff --git a/third_party/google-analytics/LICENSE b/third_party/google-analytics/LICENSE new file mode 100644 index 0000000000..ca2bba771c --- /dev/null +++ b/third_party/google-analytics/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Cursor + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/google-analytics/README.md b/third_party/google-analytics/README.md new file mode 100644 index 0000000000..74a482a577 --- /dev/null +++ b/third_party/google-analytics/README.md @@ -0,0 +1,39 @@ +# Google Analytics + +Cursor plugin that connects Grok Bot to [Google Analytics](https://analytics.google.com) (GA4) through Cursor's remote [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Run reports, read property configuration and change history, and manage custom dimensions, metrics, key events, data streams and annotations. + +## Install + +1. Open **Grok Bot Settings → Plugins**. +2. Search for **Google Analytics**. +3. Click **Install**, then complete the Google sign-in prompt. + +## MCP + +```json +{ + "mcpServers": { + "google-analytics": { + "type": "http", + "url": "https://api.cursor.com/rest-mcp/google-analytics/mcp" + } + } +} +``` + +Auth is OAuth 2.0 against Google with the `https://www.googleapis.com/auth/analytics.readonly` and `https://www.googleapis.com/auth/analytics.edit` scopes. Grok Bot prompts for Google sign-in when the plugin connects. + +## Tools + +- **Reporting:** `run_report`, `run_realtime_report`, `run_funnel_report`, `get_metadata`, `check_compatibility`, `audience_export` +- **Configuration:** `list_account_summaries`, `get_config`, `search_change_history`, `run_access_report`, `list_annotations` +- **Changes:** `update_config`, `delete_config`, `manage_data_policy`, `manage_annotations` + +## Docs + +- Google Analytics Data API: https://developers.google.com/analytics/devguides/reporting/data/v1 +- Google Analytics Admin API: https://developers.google.com/analytics/devguides/config/admin/v1 + +Logo is the official Google Analytics product icon, placed on a white tile with padding so it reads well in the UI. diff --git a/third_party/google-analytics/assets/logo.svg b/third_party/google-analytics/assets/logo.svg new file mode 100644 index 0000000000..1cc5ea6a91 --- /dev/null +++ b/third_party/google-analytics/assets/logo.svg @@ -0,0 +1 @@ + diff --git a/third_party/google-analytics/mcp.json b/third_party/google-analytics/mcp.json new file mode 100644 index 0000000000..5daf1a699b --- /dev/null +++ b/third_party/google-analytics/mcp.json @@ -0,0 +1,8 @@ +{ + "mcpServers": { + "google-analytics": { + "type": "http", + "url": "https://api.cursor.com/rest-mcp/google-analytics/mcp" + } + } +} diff --git a/third_party/metricool/.cursor-plugin/plugin.json b/third_party/metricool/.cursor-plugin/plugin.json new file mode 100644 index 0000000000..f683b14b98 --- /dev/null +++ b/third_party/metricool/.cursor-plugin/plugin.json @@ -0,0 +1,36 @@ +{ + "name": "metricool", + "displayName": "Metricool", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.13.0" + }, + "description": "Plan and publish social posts, pull metrics and reports, and manage inbox, reviews, and ads across your Metricool brands.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://help.metricool.com/en/article/how-to-connect-metricools-mcp-1364s63/", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "metricool", + "social media", + "scheduling", + "publishing", + "analytics", + "reports", + "inbox", + "ads", + "mcp" + ], + "category": "integrations", + "tags": [ + "metricool", + "social-media", + "marketing", + "mcp" + ], + "mcpServers": "./mcp.json" +} diff --git a/third_party/metricool/CHANGELOG.md b/third_party/metricool/CHANGELOG.md new file mode 100644 index 0000000000..00c630f953 --- /dev/null +++ b/third_party/metricool/CHANGELOG.md @@ -0,0 +1,9 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Added the `metricool` MCP server pointing at Metricool's hosted Streamable HTTP endpoint (`https://ai.metricool.com/mcp`). +- Auth uses OAuth with Metricool user login (authorization code + PKCE, dynamic client registration, scopes `mcp:read` and `mcp:write`) — no API key or client ID to configure. +- Logo: Metricool's official mark, the 180×180 web app icon published on metricool.com. diff --git a/third_party/metricool/LICENSE b/third_party/metricool/LICENSE new file mode 100644 index 0000000000..ca2bba771c --- /dev/null +++ b/third_party/metricool/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Cursor + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/metricool/README.md b/third_party/metricool/README.md new file mode 100644 index 0000000000..5fd49815bc --- /dev/null +++ b/third_party/metricool/README.md @@ -0,0 +1,68 @@ +# Metricool + +Cursor plugin that connects agents to [Metricool](https://metricool.com) through Metricool's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Plan and publish social posts, pull metrics and reports, and manage inbox messages, reviews, Smartlinks, and ad campaigns across your Metricool brands from chat. + +## Install + +1. Open **Cursor Settings → Plugins**. +2. Search for **Metricool**. +3. Click **Install**, then complete the Metricool sign-in prompt. + +Or run `/add-plugin metricool` in chat. + +In Grok Bot, open **Settings → Plugins**, install **Metricool**, and complete the same Metricool sign-in. + +## MCP + +```json +{ + "mcpServers": { + "metricool": { + "type": "http", + "url": "https://ai.metricool.com/mcp", + "placement": "server" + } + } +} +``` + +Auth is OAuth. Metricool uses the authorization code flow with PKCE (S256) and dynamic client registration, with the scopes `mcp:read` and `mcp:write`, so there is no API key or client ID to configure. Cursor or Grok Bot prompts for Metricool sign-in when the plugin connects. Each user signs in with their own Metricool account. + +`"placement": "server"` makes Grok Bot dial the server through the hosted MCP path. + +## Before you connect + +You need a Metricool account. MCP works on every plan, including Free, but your plan's limits still apply to what the agent can do. See [Metricool pricing](https://metricool.com/pricing/). + +## What agents can do + +| Category | Capabilities | +| --- | --- | +| Brands | See and manage your brands and their connected networks | +| Analytics | Read and download metrics and reports | +| Publishing | See, create, and publish posts on any connected network, and manage autolists | +| Engagement | Read and manage inbox messages, post comments, and Google Business Profile reviews | +| Smartlinks | See and manage Smartlinks | +| Ads | See and manage ad campaigns on the ad accounts connected to your brands | +| Assets | Browse folders and files in connected Canva or Google Drive accounts | + +The hosted runtime is the source of truth for tool names and schemas. See the [Metricool MCP docs](https://help.metricool.com/en/article/how-to-connect-metricools-mcp-1364s63/) for details. + +## Notes + +- The connection grants access similar to signing in to Metricool directly. Many tools publish or change things in public: posts, replies to comments and messages, review responses, and ad campaigns. Confirm the brand, network, and content before letting the agent publish or edit. +- Metricool also supports header-token auth (`X-Mc-Auth` with a Metricool API key) for clients like n8n. This plugin packages only the OAuth endpoint and does not send that header. +- Revoke access by disconnecting the plugin or from your Metricool account. + +## Docs + +- Metricool MCP server: https://help.metricool.com/en/article/how-to-connect-metricools-mcp-1364s63/ +- Server URL: https://ai.metricool.com/mcp + +Logo is Metricool's official mark, from the web app icon published on metricool.com. + +## License + +MIT diff --git a/third_party/metricool/assets/logo.png b/third_party/metricool/assets/logo.png new file mode 100644 index 0000000000..712b3b073c Binary files /dev/null and b/third_party/metricool/assets/logo.png differ diff --git a/third_party/metricool/mcp.json b/third_party/metricool/mcp.json new file mode 100644 index 0000000000..3ac94f1d20 --- /dev/null +++ b/third_party/metricool/mcp.json @@ -0,0 +1,9 @@ +{ + "mcpServers": { + "metricool": { + "type": "http", + "url": "https://ai.metricool.com/mcp", + "placement": "server" + } + } +} diff --git a/third_party/mixpanel/.cursor-plugin/plugin.json b/third_party/mixpanel/.cursor-plugin/plugin.json new file mode 100644 index 0000000000..b5136dace0 --- /dev/null +++ b/third_party/mixpanel/.cursor-plugin/plugin.json @@ -0,0 +1,35 @@ +{ + "name": "mixpanel", + "displayName": "Mixpanel", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.13.0" + }, + "description": "Query events, funnels, flows, and retention in Mixpanel, and manage dashboards, cohorts, experiments, and feature flags.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://docs.mixpanel.com/docs/mcp", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "mixpanel", + "product analytics", + "funnels", + "retention", + "dashboards", + "cohorts", + "experiments", + "feature flags", + "mcp" + ], + "category": "integrations", + "tags": [ + "mixpanel", + "analytics", + "mcp" + ], + "mcpServers": "./mcp.json" +} diff --git a/third_party/mixpanel/CHANGELOG.md b/third_party/mixpanel/CHANGELOG.md new file mode 100644 index 0000000000..78eaf55d58 --- /dev/null +++ b/third_party/mixpanel/CHANGELOG.md @@ -0,0 +1,9 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Added the `mixpanel` MCP server pointing at Mixpanel's hosted Streamable HTTP endpoint (`https://mcp.mixpanel.com/mcp`, US). +- Auth uses OAuth with Mixpanel user login (authorization code + PKCE, dynamic client registration) — no API key or client ID to configure. +- Logo: Mixpanel's official mark, the favicon published on mixpanel.com, white on the dark tile used by mixpanel.com's apple-touch icon, at 192×192. diff --git a/third_party/mixpanel/LICENSE b/third_party/mixpanel/LICENSE new file mode 100644 index 0000000000..ca2bba771c --- /dev/null +++ b/third_party/mixpanel/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Cursor + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/mixpanel/README.md b/third_party/mixpanel/README.md new file mode 100644 index 0000000000..e4c8bc33e7 --- /dev/null +++ b/third_party/mixpanel/README.md @@ -0,0 +1,83 @@ +# Mixpanel + +Cursor plugin that connects agents to [Mixpanel](https://mixpanel.com) through Mixpanel's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Query events, funnels, flows, retention, and session replays, and manage dashboards, Lexicon, cohorts, experiments, and feature flags from chat. + +## Install + +1. Open **Cursor Settings → Plugins**. +2. Search for **Mixpanel**. +3. Click **Install**, then complete the Mixpanel sign-in prompt. + +Or run `/add-plugin mixpanel` in chat. + +In Grok Bot, open **Settings → Plugins**, install **Mixpanel**, and complete the same Mixpanel sign-in. + +## MCP + +```json +{ + "mcpServers": { + "mixpanel": { + "type": "http", + "url": "https://mcp.mixpanel.com/mcp", + "placement": "server" + } + } +} +``` + +Auth is OAuth. Mixpanel uses the authorization code flow with PKCE (S256) and dynamic client registration, so there is no API key or client ID to configure. Cursor or Grok Bot prompts for Mixpanel sign-in when the plugin connects. Each user signs in with their own Mixpanel account, and tool calls cannot exceed that user's project permissions. + +`"placement": "server"` makes Grok Bot dial the server through the hosted MCP path. + +This plugin connects to Mixpanel's **US** server. EU and India organizations use different hosts: + +| Region | URL | +| --- | --- | +| US | `https://mcp.mixpanel.com/mcp` | +| EU | `https://mcp-eu.mixpanel.com/mcp` | +| IN | `https://mcp-in.mixpanel.com/mcp` | + +## Before you connect + +You need a Mixpanel account with access to the project you want to query. + +- **New free and growth accounts created after August 1, 2026:** MCP is on by default. An organization admin can turn it off under **Settings → Org → AI Settings**. +- **Every other account:** an organization admin must enable MCP under **Settings → Org → AI Settings** before anyone can connect. The change can take up to 15 minutes. + +Free plans can be subject to Query API access limits. See [Mixpanel pricing](https://mixpanel.com/pricing/). + +## What agents can do + +| Category | Capabilities | +| --- | --- | +| Analytics | Run insights, funnels, flows, and retention queries; read a saved report; show a chart for a query already run | +| Dashboards | List, get, create, update, duplicate, and delete boards | +| Discovery | List organizations and projects; browse events, properties, and property values; search entities; read data-quality issues and Lexicon links; read business context | +| Data management | Edit event and property metadata, manage tags, dismiss data-quality issues, update business context, and find or merge duplicate names | +| Cohorts, metrics, and definitions | Create, read, and update cohorts, saved metrics, lookup tables, and custom properties | +| Session replays | Analyze one user's replays alongside their event data | +| Experiments and feature flags | List, get, create, and update experiments and feature flags, with setup and results guidance. These tools are in beta. Audience targeting, including cohort-based targeting, is not available through MCP | +| Audit log | Read who changed what, and when | + +The hosted runtime is the source of truth for tool names and schemas. See the [Mixpanel MCP docs](https://docs.mixpanel.com/docs/mcp) for the current tool list. + +## Notes + +- Many tools write to the project: dashboards, Lexicon entries, cohorts, metrics, experiments, and feature flags. Confirm the project and the change before letting the agent write. +- If Verified Mode is on, query results still include unverified entities. They are flagged, and results prefer a verified equivalent when one exists. +- Mixpanel also offers service-account authentication (beta) for headless clients. This plugin packages only the OAuth endpoint and does not send a service-account header. +- Revoke access from the Mixpanel account's authorized applications, or disconnect the plugin. + +## Docs + +- Mixpanel MCP server: https://docs.mixpanel.com/docs/mcp +- Server URL (US): https://mcp.mixpanel.com/mcp + +Logo is Mixpanel's official mark, from the favicon published on mixpanel.com, placed on the dark tile used by mixpanel.com's apple-touch icon. + +## License + +MIT diff --git a/third_party/mixpanel/assets/logo.png b/third_party/mixpanel/assets/logo.png new file mode 100644 index 0000000000..13d5ad2711 Binary files /dev/null and b/third_party/mixpanel/assets/logo.png differ diff --git a/third_party/mixpanel/mcp.json b/third_party/mixpanel/mcp.json new file mode 100644 index 0000000000..8643f0f7ea --- /dev/null +++ b/third_party/mixpanel/mcp.json @@ -0,0 +1,9 @@ +{ + "mcpServers": { + "mixpanel": { + "type": "http", + "url": "https://mcp.mixpanel.com/mcp", + "placement": "server" + } + } +}