Skip to content

Platform

MCP server

Let Claude, Cursor or any MCP client query your analytics through the built-in, read-only MCP server.

Globatics has a built-in, read-only Model Context Protocol server. Connect Claude, Cursor or any MCP client and ask about your traffic in your own words; the agent calls typed analytics tools and gets numbers back, never raw SQL.

Endpoint

Endpointhttps://globatics.live/api/mcp
TransportStreamable HTTP, JSON-RPC 2.0 (POST; batches accepted)
AuthAuthorization: Bearer glb_…, an API key
AccessRead-only. A key sees only the sites its owner owns.
Protocol versions2025-11-25 (default), 2025-06-18, 2025-03-26, 2024-11-05

Connect a client

claude mcp add --transport http globatics https://globatics.live/api/mcp \
  --header "Authorization: Bearer glb_YOUR_KEY"

Claude Desktop’s remote connectors expect OAuth, so the config above uses the mcp-remote bridge to send the key (Node.js 18+). There is no space after Authorization: in args: the value comes from env, which avoids quoting problems on Windows. Keep keys out of version control.

Then ask
Using globatics, what were my top pages this week and why did traffic change?

Tools

Site-scoped tools take site_id (an id from list_sites or the domain; optional when you have one site) and the shared query arguments period, from/to, compare and filters (for example [{"dim":"country","op":"is","value":"FR"}]).

ToolReturns
list_sitesYour sites: id, name, domain, timezone, currency, visitors online now, goals and saved funnels
get_overviewVisitors, visits, pageviews, bounce rate, duration, conversions, revenue, with the change vs the previous period
get_breakdownTop values of a dimension: page, referrer, channel, country, device, event, goal…
get_timeseriesMetrics per minute, hour, day, week or month
get_live_nowOnline now, last 5 and 30 minutes, today, top pages, countries and referrers right now
get_funnelStep conversion for a saved funnel or ad-hoc steps
explain_changeWhy a metric changed: the top drivers of the difference
get_ai_trafficVisitors from ChatGPT, Perplexity, Claude, Gemini…, AI vs other visitors
get_insightsAnomalies (spikes, drops, new referrers, error spikes, slow pages) and the digest
askA plain-language question answered by the built-in engine (English or French)

Every result is returned as structuredContent and as a text block with the same JSON, with citations (the key numbers) and a deep link into the dashboard.

Errors and limits

CaseResult
Unknown site, or a site you don’t ownTool result with isError and “Site not found.”
Invalid argumentsTool result with isError and structuredContent.error
Missing or invalid keyHTTP 401 with WWW-Authenticate, JSON-RPC error -32001
Rate limit240 calls per minute per user (HTTP 429 with Retry-After); at most 10 tools/call per batch
GET or DELETE on the endpoint405 (no server-sent stream)