Skip to content

OpenPanel is an open-source web and product analytics platform, an open-source alternative to Mixpanel with optional self-hosting.

3.9 KB
Raw Blame
{
  "slug": "mcp",
  "short_name": "MCP",
  "seo": {
    "title": "Analytics MCP Server - Ask Your AI About Your Users | OpenPanel",
    "description": "Connect Claude, Cursor, or Windsurf to your OpenPanel analytics via MCP. Query funnels, retention, user profiles, and events without opening the dashboard.",
    "keywords": [
      "analytics mcp server",
      "openpanel mcp",
      "ai product analytics",
      "connect analytics to claude",
      "mixpanel mcp alternative"
    ]
  },
  "hero": {
    "heading": "MCP: ask your AI about your users",
    "subheading": "Let your AI deep dive into your OpenPanel data and understand what's going on. Skip dashboards and reports when you just want a quick answer."
  },
  "related_features": [
    {
      "slug": "event-tracking",
      "title": "Event tracking",
      "description": "The events you track are what the MCP server queries. Better event coverage means better answers."
    },
    {
      "slug": "funnels",
      "title": "Funnels",
      "description": "Define funnels in OpenPanel and query them by name through MCP."
    },
    {
      "slug": "retention",
      "title": "Retention",
      "description": "Ask retention questions in plain language—the MCP server handles the cohort math."
    }
  ],
  "faqs": {
    "title": "Frequently asked questions",
    "intro": "Common questions about OpenPanel's MCP server.",
    "items": [
      {
        "question": "Which AI clients work with OpenPanel MCP?",
        "answer": "Any client that speaks MCP over streamable HTTP. The settings page writes the config for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code (Copilot) and Raycast, and the same URL and token work in an agent you build yourself."
      },
      {
        "question": "Do I need to install anything?",
        "answer": "No. The MCP server is hosted by OpenPanel at `https://api.openpanel.dev/mcp`. You add that URL to your AI client's config with your token—nothing runs on your machine."
      },
      {
        "question": "How does authentication work?",
        "answer": "Your token is `base64(clientId:clientSecret)`. Generate it with `echo -n \"CLIENT_ID:CLIENT_SECRET\" | base64` and send it as an `Authorization: Bearer YOUR_TOKEN` header. If your client can't set headers, append it to the URL as `?token=YOUR_TOKEN` instead—it works the same, but a token in a URL is easier to leak into history and logs."
      },
      {
        "question": "What's the difference between a read client and a root client?",
        "answer": "A read client is tied to one project and gets the 39 read tools. A root client can reach every project in the organization and adds the 9 tools that create and edit dashboards and reports. Write clients cannot authenticate with MCP at all."
      },
      {
        "question": "Can the AI modify my data?",
        "answer": "With a read client, no: its 39 tools only read. A root client also gets 9 write tools that create, update, delete and lay out dashboards and reports, so treat a root token as write access. Neither can change events, profiles or settings."
      },
      {
        "question": "Does it work with self-hosted OpenPanel?",
        "answer": "If you're self-hosting, the MCP server is part of the API—it runs on your instance at the same `/mcp` path. Point your AI client at your own API URL instead of `api.openpanel.dev`."
      },
      {
        "question": "How is this different from the Google Analytics MCP server?",
        "answer": "Google Analytics MCP connects to GA4 data—pageviews, traffic sources, sessions. OpenPanel's MCP connects to product event data: custom events, user profiles, funnels, retention cohorts. If you want to ask 'what's the 30-day retention for users who completed onboarding', that's not a question GA4's MCP can answer. OpenPanel's can."
      }
    ]
  },
  "cta": {
    "label": "Connect your AI to your analytics",
    "href": "https://dashboard.openpanel.dev/onboarding"
  }
}