sudomichael/gizmoanalytics-mcp
📇 ☁️ - Gizmo Analytics — cookieless web analytics for AI coding agents. Framework-aware install (Next/Remix/SvelteKit/Nuxt/Astro/Vite/React/HTML), OAuth onboarding, 28 tools for setup + query + workflow operations (summarizeallsites, explaintrafficchange, detectanomalies). Hosted MCP at gizmoanalytics.io/mcp.
Quick Install
{
"mcpServers": {
"sudomichael-gizmoanalytics-mcp": {
"command": "npx",
"args": [
"-y",
"sudomichael-gizmoanalytics-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
gizmoanalytics-mcp
The MCP server for Gizmo Analytics — cookieless
web analytics with a 28-tool MCP surface (install workflows like
setup_analytics_for_site and verify_install, analyst-grade
compositions like summarize_all_sites and explain_traffic_change,
plus filterable query primitives across every dimension).
The server is hosted at https://gizmoanalytics.io/mcp. This repo
is the public ownership marker + documentation (README, tool
inventory, license) for the MCP catalogs (MCP Registry, Smithery,
Glama, MCP.so). There's nothing to install or run locally — point
your IDE at the hosted endpoint and you're done.
Connect
Auto-discovery (Cursor, Claude Desktop, Windsurf, …)
In your IDE's MCP settings, add a new server with URL:
https://gizmoanalytics.io/mcp
The IDE will discover the auth server via RFC 9728 metadata, open a browser tab for OAuth consent, and store the resulting token. No API keys to paste, no config files to edit.
Manual config
If your IDE doesn't yet support OAuth-aware MCP discovery, paste this into your client's MCP config file (Claude Desktop, etc.):
{
"mcpServers": {
"gizmoanalytics": {
"url": "https://gizmoanalytics.io/mcp",
"headers": {
"Authorization": "Bearer ak_admin_<your-admin-key>"
}
}
}
}
Get an admin key at https://gizmoanalytics.io/dashboard/keys.
What you can ask
"Why did traffic drop yesterday?"
"Which of my sites is growing fastest?"
"Add foo.com to Gizmo and install the tracker"
"Track signup events on this button"
"Top pages from Germany last quarter"
Tools
- Install workflow (the wedge — call this first for any install
ask):
setup_analytics_for_sitebundles site creation + framework- aware snippet + paste-target file path + next-action plan into one call.verify_installconfirms the script is loading by fetching the homepage. - Other setup:
create_site,get_install_snippet,get_event_tracking_snippet,get_badge_snippet,add_site_tags, goals + funnels. - Workflows (high-level questions):
summarize_all_sites,rank_sites_by_growth,identify_dead_sites,detect_anomalies,explain_traffic_change. - Query primitives:
get_workspace_overview,get_site_traffic,get_top_pages,get_top_referrers,get_breakdown(any of country / browser / device / channel / AI source / city / etc.),get_time_series,query_events,breakdown_by_property. All support stacked filters (country=US AND device=mobile) and custom date ranges.
See TOOLS.md for the full inventory with descriptions
(auto-generated from the live tools/list endpoint).
Full docs: https://gizmoanalytics.io/mcp-analytics
License
MIT