About convalytics
Convalytics provides web analytics and product event tracking for Convex apps, bringing the data into one dashboard. It is aimed at Convex projects monitoring visits and in-app events, and includes a CLI for project setup.
Key features
- 01Track page views, sessions, and bounce rate
- 02Break down referrers, devices, and browsers
- 03Track events from Convex mutations and actions
- 04Initialize projects and analytics setup with a CLI
Use cases
- 01Review visits and traffic sources for a Convex app
- 02Track signup, payment, and feature-use events
MCP support
The README says read-only analytics can be queried via MCP from clients such as Claude and Cursor, but does not list specific MCP tools.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.convalytics.dev/mcpclaude mcp add --transport http dan-cleary-convalytics https://api.convalytics.dev/mcp{"mcpServers":{"dan-cleary-convalytics":{"type":"http","url":"https://api.convalytics.dev/mcp"}}}Open in Cursor{"servers":{"dan-cleary-convalytics":{"type":"http","url":"https://api.convalytics.dev/mcp"}}}Open in VS Code{"mcpServers":{"dan-cleary-convalytics":{"type":"http","url":"https://api.convalytics.dev/mcp"}}}{"mcpServers":{"dan-cleary-convalytics":{"serverUrl":"https://api.convalytics.dev/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://api.convalytics.dev/mcpAuth requiredTools
15This tool takes no parameters.
Details
From the project READMEConvalytics
Web analytics and product event tracking built for Convex apps.
Dashboard: convalytics.dev
What is Convalytics?
Convalytics gives Convex apps two things:
- Web analytics — automatic page views, sessions, bounce rate, referrers, and device/browser breakdowns via a lightweight script tag.
- Product event tracking — track signups, payments, feature usage, and any custom event directly from Convex mutations and actions. Server-side events can't be blocked by ad blockers.
Everything flows into a single dashboard. Projects auto-provision on first event — no account required to start tracking.
Quick start
npx convalytics init
This auto-provisions a project, installs the Convex component, patches convex/convex.config.ts, creates convex/analytics.ts with the write key inlined, inserts the browser script tag into index.html, and installs a skill file for AI agents. Works with Cursor, Claude Code, and other AI coding agents out of the box.
Packages
| Package | Description |
|---|---|
convalytics-dev | Convex component for server-side event tracking |
convalytics | CLI for zero-config project setup |
Project structure
convalytics/
convex/ # Convex backend — dashboard API, ingest, billing, auth
src/ # React frontend — dashboard UI
cli/ # CLI (published as convalytics on npm)
The Convex component (convalytics-dev on npm) lives in its own repo:
Dan-Cleary/convalytics-convex-component
Tech stack
- Backend: Convex — database, server functions, scheduled jobs, real-time queries
- Frontend: React 19, React Router v7, TailwindCSS v4, Vite, Recharts
- Hosting: Vercel (frontend), Convex Cloud (backend)
- Billing: Stripe (usage-based tiers)
- Email: Resend + React Email
Development
npm install
npm run dev
This starts both the Vite frontend and convex dev in parallel.
Links
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.