io.github.Dan-Cleary/convalytics
Read-only analytics for Convex apps, queryable via MCP from Claude, Cursor, and other clients.
Open source Repository Open in the app JSON README (API)
About
Read-only analytics for Convex apps, queryable via MCP from Claude, Cursor, and other clients.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- dan-cleary
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Stars
- 7
- Last push
- 2026-07-17T15:09:58Z
- Repository state
- ativo
- Language
- TypeScript
- License
- Apache-2.0
- Added
- 2026-08-29 03:01:49
- Updated
- 2026-08-29 03:01:49
- Origin id
io.github.Dan-Cleary/convalytics
README
# Convalytics Web analytics and product event tracking built for [Convex](https://convex.dev) apps. **Dashboard:** [convalytics.dev](https://convalytics.dev) ## What is Convalytics? Convalytics gives Convex apps two things: 1. **Web analytics** — automatic page views, sessions, bounce rate, referrers, and device/browser breakdowns via a lightweight script tag. 2. **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 ```bash 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`](https://www.npmjs.com/package/convalytics-dev) | Convex component for server-side event tracking | | [`convalytics`](https://www.npmjs.com/package/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](https://github.com/Dan-Cleary/convalytics-convex-component) ## Tech stack - **Backend:** [Convex](https://convex.dev) — 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 ```bash npm install npm run dev ``` This starts both the Vite frontend and `convex dev` in parallel. ## Links - [Dashboard](https://convalytics.dev) - [Component repo](https://github.com/Dan-Cleary/convalytics-convex-component) - [GitHub](https://github.com/Dan-Cleary/convalytics) - [Twitter](https://x.com/DanJCleary)