{
  "markdown": "# Measure.events MCP Server\n\n[![MCP](https://img.shields.io/badge/MCP-compatible-brightgreen)](https://modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for [Measure.events](https://measure.events) — privacy-first web analytics that AI agents can use natively.\n\nConnect your AI coding assistant (Claude Desktop, Cursor, Windsurf, etc.) to your web analytics. Ask questions like \"how's my traffic this week?\" or \"what are my top pages?\" and get real answers from real data.\n\n## Why?\n\nEvery analytics platform has a dashboard. None of them talk to your AI tools.\n\nMeasure.events is the first analytics platform with a native MCP server. Your AI assistant can check traffic, find top content, identify referrers, and track events — all without you opening a browser.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_sites` | List all tracked sites in your account |\n| `get_pageviews` | Pageview counts with daily time series |\n| `get_top_pages` | Most viewed pages on a site |\n| `get_referrers` | Traffic sources and referring domains |\n| `get_site_summary` | AI-friendly natural language analytics summary |\n| `track_event` | Track custom events (signups, purchases, etc.) |\n\n## Setup\n\n### 1. Get your API key\n\nSign up at [lets.measure.events](https://lets.measure.events) and grab your API key from Settings.\n\n### 2. Install\n\n```bash\nnpm install @turbo-puffin/measure-mcp-server\n```\n\nOr run directly with npx:\n\n```bash\nnpx @turbo-puffin/measure-mcp-server\n```\n\n### 3. Configure your MCP client\n\n#### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"measure\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@turbo-puffin/measure-mcp-server\"],\n      \"env\": {\n        \"MEASURE_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Cursor\n\nAdd to your Cursor MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"measure\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@turbo-puffin/measure-mcp-server\"],\n      \"env\": {\n        \"MEASURE_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Windsurf\n\nAdd to your Windsurf MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"measure\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@turbo-puffin/measure-mcp-server\"],\n      \"env\": {\n        \"MEASURE_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `MEASURE_API_KEY` | Yes | Your Measure.events API key |\n| `MEASURE_API_URL` | No | Custom API base URL (default: `https://lets.measure.events/api/v1`) |\n\n## Example Usage\n\nOnce configured, ask your AI assistant:\n\n- \"What's my traffic looking like this week?\"\n- \"Which pages are getting the most views on propfirmdeck.com?\"\n- \"Where is my traffic coming from?\"\n- \"Give me a summary of my analytics\"\n- \"Track a signup event for my site\"\n\n## Hosted MCP Endpoint\n\nMeasure.events also provides a hosted MCP endpoint for server-to-server integration:\n\n```\nPOST https://lets.measure.events/mcp\nAuthorization: Bearer YOUR_API_KEY\nContent-Type: application/json\n\n{\"jsonrpc\": \"2.0\", \"method\": \"initialize\", \"id\": 1, \"params\": {\"protocolVersion\": \"2024-11-05\", \"capabilities\": {}, \"clientInfo\": {\"name\": \"test\", \"version\": \"1.0\"}}}\n```\n\n## About Measure.events\n\n[Measure.events](https://measure.events) is privacy-first web analytics built for the AI era. No cookies, no personal data, GDPR/CCPA compliant out of the box. The only analytics platform where AI agents are first-class citizens.\n\n- 🔒 Privacy-first — no cookies, no fingerprinting\n- 🤖 Agent-native — MCP server + REST API\n- ⚡ Lightweight — single script tag, <1KB\n- 📊 Real-time — see traffic as it happens\n\n## License\n\nMIT — see [LICENSE](LICENSE) for details.\n",
  "bytes": 3895,
  "sha": "019a90624a7d3251af932c38a61c3b8e608ba14ff7054c1d16ea849baac0d928",
  "repo_slug": "turbo-puffin/measure-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_meetclawdius_measure_events_e62a301c/readme"
}