MCP server
Connect Claude, Cursor, or any MCP compatible client to your Analyse data. Query events, build segments, and manage knowledge base pages from your own AI tools.
What it is
Analyse runs a Model Context Protocol server. Point an MCP client at it and your AI tool of choice can query your analytics directly, with the same tool set the built in assistant uses. MCP server access is available on the Pro plan and above.
Connecting a client
Open Settings → Account in the dashboard and find the MCP section. Two ways in:
OAuthClients that support remote MCP servers with OAuth (like Claude) can connect to the server URL directly and log in through the browser. The dashboard shows the exact URL and a ready made config block to copy.API keysGenerate a key in the same panel for clients that authenticate with a bearer token.
Keys are scoped: you pick which sites a key can see, and whether it is read only or allowed to write (create boards, edit knowledge base pages). Keys can be revoked at any time, and the panel shows when each was last used.
Available tools
| Tool | What it does |
|---|---|
list_websites | Lists the sites the key can access, call it first to get ids. |
get_analytics_overview | Headline metrics for a site and date range. |
get_live_visitors | Real-time active visitor count. |
query_events | Top tracked events site-wide with volumes and trends. |
get_event_detail | Property schema and recent samples for one event. |
get_funnel | Conversion between a sequence of events. |
get_retention_overview | Retention KPIs, weekly curve, and channel breakdown. |
list_cohorts | Weekly cohort retention matrix. |
list_users | Users with optional filters (country, event, property). |
get_user_activity | One person's recent event timeline and activity stats. |
get_pages | Top, entry, and exit pages plus page KPIs. |
get_traffic_sources | Top referrer domains by visitors. |
get_geography | Countries, cities, devices, browsers, and OS breakdown. |
get_seo_overview | Search Console clicks, positions, and keywords. |
get_sites_overview | Compare metrics across all sites in the workspace. |
preview_segment | Estimate audience size for segment criteria (no save). |
list_segments | Saved audience segments. |
list_dashboards | Saved dashboards (boards). |
build_segment | Build an audience segment from behavior filters. |
create_dashboard | Create a board (requires write scope). |
search_knowledge_base, query_knowledge_base | Search and read knowledge base pages. |
create_kb_page, update_kb_page, delete_kb_page, attach_kb_page | Manage knowledge base pages (write scope). |
What this is good for
Ad hoc analysis without leaving your editor, weekly report drafts written by your own agent, or wiring Analyse numbers into automations. Since the knowledge base tools are included, an agent can also keep your internal docs in sync as it works.
An MCP key grants whatever access you scoped it to. Treat write enabled keys like passwords, and prefer read only keys for anything experimental.