Turbo-Puffin/measure-mcp-server

MCP License: MIT

A Model Context Protocol (MCP) server for Measure.events — privacy-first web analytics that AI agents can use natively.

Connect 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.

Why?

Every analytics platform has a dashboard. None of them talk to your AI tools.

Measure.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.

Tools

Tool	Description
list_sites	List all tracked sites in your account
get_pageviews	Pageview counts with daily time series
get_top_pages	Most viewed pages on a site
get_referrers	Traffic sources and referring domains
get_site_summary	AI-friendly natural language analytics summary
track_event	Track custom events (signups, purchases, etc.)

Setup

1. Get your API key

Sign up at lets.measure.events and grab your API key from Settings.

2. Install

npm install @turbo-puffin/measure-mcp-server

Or run directly with npx:

npx @turbo-puffin/measure-mcp-server

3. Configure your MCP client

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "measure": {
      "command": "npx",
      "args": ["-y", "@turbo-puffin/measure-mcp-server"],
      "env": {
        "MEASURE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "measure": {
      "command": "npx",
      "args": ["-y", "@turbo-puffin/measure-mcp-server"],
      "env": {
        "MEASURE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "measure": {
      "command": "npx",
      "args": ["-y", "@turbo-puffin/measure-mcp-server"],
      "env": {
        "MEASURE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
MEASURE_API_KEY	Yes	Your Measure.events API key
MEASURE_API_URL	No	Custom API base URL (default: https://lets.measure.events/api/v1)

Example Usage

Once configured, ask your AI assistant:

• "What's my traffic looking like this week?"
• "Which pages are getting the most views on propfirmdeck.com?"
• "Where is my traffic coming from?"
• "Give me a summary of my analytics"
• "Track a signup event for my site"

Hosted MCP Endpoint

Measure.events also provides a hosted MCP endpoint for server-to-server integration:

POST https://lets.measure.events/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{"jsonrpc": "2.0", "method": "initialize", "id": 1, "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0"}}}

About Measure.events

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.

• 🔒 Privacy-first — no cookies, no fingerprinting
• 🤖 Agent-native — MCP server + REST API
• ⚡ Lightweight — single script tag, <1KB
• 📊 Real-time — see traffic as it happens

License

MIT — see LICENSE for details.