MCP: ask your AI about your users
Paste one URL into Claude, Cursor or Windsurf and ask in plain English. Funnels, retention, sessions, profiles and Search Console, with the numbers behind every answer.
- 48
- tools39 read tools for every client, 9 write tools for root tokens.
- 6
- documented clientsClaude Desktop, Claude Code, Cursor, Windsurf, VS Code and Raycast. Any MCP client works.
- 0
- installsStreamable HTTP, hosted by OpenPanel or by you. A URL and a token.
One URL, no install
The MCP server is part of the API. Create a read or root client in the project settings, copy the token once, and paste the endpoint into your client's config. The settings page writes the config block for you.
- Streamable HTTP
- Token as a Bearer header, or ?token= for clients that cannot send headers.
- Six documented clients
- And any other MCP client, including an agent you wrote yourself.
- Self-hosted too
- Your install has the same /mcp endpoint.
Everything the dashboard knows
The tools map to what the dashboard can show: the overview, pages, referrers, devices and countries, funnels and retention, events and sessions with filters, profiles and groups, Search Console queries. Root tokens also get the tools that create and edit dashboards and reports.
- 39 read tools
- For any read or root client.
- 9 write tools
- Create, update, delete and lay out dashboards and reports. Root only.
- Your permissions, nothing more
- A read client sees one project. A root client sees the organization.
Or use the one inside
No MCP client at hand? The dashboard has a chat with the same reach. It answers from your data, drafts charts and dashboards, and asks before it saves anything.
- Builds charts and dashboards
- Describe the report and approve it when it looks right.
- Writes ask first
- Creating a dashboard, saving a chart or inviting someone needs your approval.
- Daily limits by plan
- Unlimited on self-hosted. GPT and Claude models, whichever key you configure.
Read or root
Two kinds of client can talk to the server. Pick by how much you trust the thing holding the token.
- Read clientOne project, 39 tools, cannot change anything.
- Root clientEvery project, 48 tools, treat the token as write access.
What the AI can reach
- Search Console toolsSeven gsc_* tools once the property is connected: queries, pages, opportunities, cannibalization.
- Profiles and groupsFind a person or a company, then their sessions, metrics and events.
- Events with filtersquery_events and query_sessions take the same filters the dashboard does.
- Works self-hostedThe endpoint lives on your API. Nothing leaves your servers except what the AI client asks for.
- The token is shown onceRead and root clients only. Rotate it by creating a new client.
- Pick the client in settingsThe MCP tab writes the config block for the client you choose.
Connected in four steps
- 1
Create an API client
Settings › Clients. Read for one project, root for the organization.
- 2
Copy the token
base64(clientId:clientSecret). It is shown once.
- 3
Paste the URL into your client
The config block for your client is on the MCP tab.
// claude_desktop_config.json"openpanel": {"type": "streamable-http","url": "<api>/mcp","headers": {"Authorization":"Bearer <token>"}} - 4
Ask
Which campaign brought paying users last month? The answer names its tools.
Frequently asked questions
Common questions about OpenPanel's MCP server.
Start understanding your users today
One script on your site, or one SDK call in your app, and the first events show up within a minute. 30-day free trial, no credit card.
Cloud from $2.50 a month, or self-host for free.