measure-mcp-server

Measure.events MCP Server

 

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.