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.
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
- 1Open Settings, then MCPIn any project, open Settings and choose the MCP tab. The connect commands and the endpoint are at the top.
- 2Create 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.
- 3Try 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.
- 4Connect 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 mcp add --transport http termind https://www.termind.tech/api/mcp \
--header "Authorization: Bearer YOUR_TOKEN"{
"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.
| Tool | What it returns |
|---|---|
| termind_projects | The projects this token can see. Start here. |
| termind_overview | The whole dashboard in one call: totals, vitals, every breakdown, daily trend. |
| termind_breakdown | One ranked list: channels, sources, campaigns, pages, entry or exit pages, countries, regions, cities, devices, browsers, systems, or goals. |
| termind_timeseries | Visitors and signups per day, for trend questions. |
| termind_live | Who is on the site right now. |
| termind_crawlers | Which AI crawlers read the site, and what they read. |
| termind_assistant_referrals | Visitors sent by ChatGPT, Claude, Perplexity and friends. |
| termind_search_performance | Search Console queries, clicks, impressions, position. |
| termind_revenue | Subscriptions, MRR and recent payments, in minor units. |
| termind_people | Search identified users by email or name. |
| termind_person | One person in full, with their recent events. |
| termind_funnel | Step conversion through any ordered list of events. |
Security
| Property | Meaning |
|---|---|
| Read only | No tool can modify, delete, or purchase anything. |
| Workspace scoped | A token sees one workspace, or one project. Never your whole account. |
| Hashed at rest | We store a prefix and a hash. A database leak does not leak tokens. |
| Revocable | Revoke in settings and the token stops working immediately. |
| Auditable | Each 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
| Symptom | Cause 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 empty | The client connected without the Authorization header. Check the header name is exactly Authorization and the value starts with Bearer. |
| 'Pass project' errors | The 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.