Skip to content

MCP: connect an AI to your analytics

Let Claude, Cursor or any MCP client answer questions from your real numbers.

What this is

MCP is the protocol AI tools use to reach outside data. Once connected, you can ask Claude which page loses the most visitors, whether revenue moved this week, or which AI crawlers read your site, and it answers from your live Termind data rather than from guesses.

You ask Claude a question. Claude calls a Termind MCP tool over HTTPS with your token. The server checks the token, runs the query in your workspace only, and returns the numbers, which Claude turns into an answer.You"which page losesthe most visitors?"Claudepicks a tool, e.g.termind_breakdowntk_ tokennumbers backTermind MCP/api/mcptoken checked every callYour dataone workspaceThe token is the boundary: it is read only, scoped to one workspace or one project, andrevocable from settings without touching anything else.
The whole path, and where the token sits

Everything is read only. An assistant with your token can look at analytics; it cannot change settings, delete data, or spend money. There is nothing destructive to confirm and nothing to undo.

Set it up

In your project, open Settings, choose the MCP tab, then press Create token. The connect command appears above the token list.termind.tech/app/…/settings/developersSettingsGeneralTrackingEventsActivationIntegrationsAPI keysMCPclaude mcp add --transport http termind https://www.termind.tech/api/mcp …Create tokenPlaygroundRun any tool against the live endpoint before connecting an assistant1. the MCP tab2. mint3. test
Where to find it: Settings, then MCP
  1. 1
    Open Settings, then MCPIn any project, open Settings and choose the MCP tab. The connect commands and the endpoint are at the top.
  2. 2
    Create a tokenName it after where it will live, for example Claude on my laptop. Choose whether it can see every project in the workspace or only this one. The token is shown once; copy it then.
  3. 3
    Try it in the playgroundBefore connecting anything, run a tool in the playground on the same page. It calls the live endpoint with real MCP messages, so a working playground call means a working connection.
  4. 4
    Connect your assistantCopy the command for your client from the same page. For Claude Code it is one terminal command; for Cursor and Windsurf it is a small JSON block.
Claude Code
claude mcp add --transport http termind https://www.termind.tech/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"
Cursor, Windsurf and other JSON configs
{
  "mcpServers": {
    "termind": {
      "url": "https://www.termind.tech/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

The tools

Where other analytics MCPs ship a dozen nearly identical tools that differ by one word, Termind ships one breakdown tool with a dimension parameter. Models pick the right tool more reliably when there are fewer of them, and the ones that remain are distinct.

ToolWhat it returns
termind_projectsThe projects this token can see. Start here.
termind_overviewThe whole dashboard in one call: totals, vitals, every breakdown, daily trend.
termind_breakdownOne ranked list: channels, sources, campaigns, pages, entry or exit pages, countries, regions, cities, devices, browsers, systems, or goals.
termind_timeseriesVisitors and signups per day, for trend questions.
termind_liveWho is on the site right now.
termind_crawlersWhich AI crawlers read the site, and what they read.
termind_assistant_referralsVisitors sent by ChatGPT, Claude, Perplexity and friends.
termind_search_performanceSearch Console queries, clicks, impressions, position.
termind_revenueSubscriptions, MRR and recent payments, in minor units.
termind_peopleSearch identified users by email or name.
termind_personOne person in full, with their recent events.
termind_funnelStep conversion through any ordered list of events.

Security

PropertyMeaning
Read onlyNo tool can modify, delete, or purchase anything.
Workspace scopedA token sees one workspace, or one project. Never your whole account.
Hashed at restWe store a prefix and a hash. A database leak does not leak tokens.
RevocableRevoke in settings and the token stops working immediately.
AuditableEach token shows when it was last used.

Treat the token like a password to your analytics. Anyone holding it can read your numbers until you revoke it. If a token leaks, revoke it in Settings, Developers; connections using it fail from that moment.

If it does not connect

SymptomCause and fix
401 or 'invalid token'The token is wrong, incomplete, or revoked. Paste it again from a fresh mint; there is no way to re-view an old one.
Tools list is emptyThe client connected without the Authorization header. Check the header name is exactly Authorization and the value starts with Bearer.
'Pass project' errorsThe token can see several projects, so tools need to know which one. Ask the assistant to call termind_projects first, or mint a token scoped to one project.

The playground in Settings, Developers is the fastest diagnostic: it uses the identical endpoint and messages, so whatever it says is what your assistant is experiencing.

NextRevenue attributionConnect your payment provider so traffic can be tied to money.