# convalytics

Lets an AI agent read web analytics and product events from Convex apps. Handy when you want the numbers without leaving the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: Dan-Cleary
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Dan-Cleary/convalytics
- Updated: 2026-07-17
- HTML: https://affpapa.org/en/nevibecode/mcp/convalytics

## What it does

Convalytics handles web analytics and product event tracking for apps built on Convex. Page views, sessions, bounce rate, referrers and device or browser breakdowns arrive through a small script tag. Signups, payments and feature usage can be sent straight from Convex mutations and actions, and ad blockers cannot stop server-side events.

The MCP server exposes that data read-only, and clients reach it at `https://api.convalytics.dev/mcp`. It speaks HTTP transport, so there is no local process to keep alive. Setup also drops in a skill file for AI agents, which means Cursor and Claude pick up the workflow without extra wiring.

A project provisions itself on the first event, so you can start tracking without an account. Running `npx convalytics init` patches `convex/convex.config.ts`, writes `convex/analytics.ts` with the write key inlined and inserts the script tag into `index.html`. Those are edits to your repo — read the diff before you commit.

## Requirements
- Remote server: `https://api.convalytics.dev/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http convalytics https://api.convalytics.dev/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add convalytics --url https://api.convalytics.dev/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "convalytics": {
            "url": "https://api.convalytics.dev/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "convalytics": {
            "type": "http",
            "url": "https://api.convalytics.dev/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http convalytics https://api.convalytics.dev/mcp
```

## When to use it
- check Convex app metrics from inside an agent chat
- track signups and payments from server-side mutations
- break down sessions by referrer and device
- wire up analytics without hand-editing Convex config
- give an AI agent read access to product event data

## Example prompts
- Show me page views for the last week using convalytics
- How many signups came in this month? Pull it from convalytics
- Which referrers drive the most sessions?

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md