Docs / AI agents (MCP)

Connect OpenAnalytics to your AI assistant

Ask Claude, ChatGPT or Cursor about your traffic, goals and funnels — and let it set things up for you.

What it is

OpenAnalytics runs an MCP server (Model Context Protocol) at

https://mcp.openanalyticsapi.com/mcp

Your assistant connects to it, you approve the connection once in the OpenAnalytics console, and from then on it can answer questions like “Which pages lost the most traffic this week?” or “Create a signup funnel for example.com” using your real data. No API key to copy — sign-in uses OAuth.

Tested with Claude.ai. Any client that supports remote MCP servers over Streamable HTTP with OAuth should work the same way.

Claude.ai and Claude Desktop

Open Settings → Connectors and choose Add custom connector.
Name it OpenAnalytics and paste the URL https://mcp.openanalyticsapi.com/mcp.
Click Connect. A page from console.openanalyticsapi.com opens — sign in if needed.
Choose what the assistant may do (see permissions) and click Allow.

Custom connectors are available on Claude plans that support them; the connector then works in Claude Desktop and on mobile too.

Claude Code

claude mcp add --transport http openanalyticsapi https://mcp.openanalyticsapi.com/mcp

Then run /mcp inside Claude Code and pick openanalyticsapi → Authenticate. Your browser opens the approval page.

ChatGPT, Cursor and other MCP clients

Add a remote MCP server with the URL above. Clients that support OAuth will open the approval page by themselves. In Cursor, for example, add this to mcp.json:

{
  "mcpServers": {
    "openanalyticsapi": { "url": "https://mcp.openanalyticsapi.com/mcp" }
  }
}

Client without OAuth? Create a token in the console under Settings → AI agents and send it as a header:

Authorization: Bearer oaa_master_…

Treat the token like a password. It works until you revoke it and expires after 90 days (you get an e-mail a week before).

What the assistant can and cannot do

Can

Read traffic, events, sessions, realtime, retention, heatmaps, goals, funnels and conversions.
Get the install snippet and check platform health.
Only if you tick “write” on the approval page: create projects, goals, funnels, release markers and ad-spend rows, and change project settings.

Never

Delete anything (archiving a project is the most it can do).
Touch billing, API keys or project secrets.
See projects you excluded when approving the connection.

Read-only is the default. You can also limit the connection to selected projects — useful when an agency or a client assistant should see only one site.

27 tools in total: projects, install snippet, pageviews, events, sessions, realtime, retention, traffic quality, heatmaps, goals, funnels, conversions, ad spend, release markers and platform health.

Seeing and revoking access

Every approved client appears in the console under Settings → AI agents as “client name (OAuth)”. Revoke cuts it off immediately.
What did the agents do on the same page shows every call: which tool, which project, when and with what result. Only argument names are logged, never values.
A connection stays valid while it is in use and expires 90 days after the last use.
Changing or resetting your password revokes all AI connections and tokens.

Good to know

Page paths, referrers and event names come from your visitors' browsers. The assistant is told to treat them as data, not instructions.
MCP access is currently free on every plan.
Prefer plain HTTP? The same operations are in the REST API.

← REST API All docs →