Convalytics
- 6 repo stars
- Updated July 17, 2026
- Dan-Cleary/convalytics
Convalytics is a MCP server that provides read-only Convex app analytics queryable from AI coding agents.
About
Convalytics MCP is a read-only Model Context Protocol connector that lets AI assistants query analytics for apps built on Convex. founders who already use Convex for backend and want to ask natural-language questions about usage—without exporting CSVs or building a custom metrics API—can register the hosted remote with a Bearer token created at convalytics.dev/tokens. Skillselion catalogs it under Grow and analytics because the payoff appears after you have users and need data-informed iteration, pricing tweaks, and support prioritization. The integration is query-only, which limits risk compared with write-capable ops tools, but you still treat API tokens as secrets in Claude Code or Cursor configs. It complements Convex development during Build but is not a substitute for instrumenting events in your app.
- Read-only analytics MCP for Convex applications
- Streamable HTTP remote at https://api.convalytics.dev/mcp
- Bearer token auth with Convalytics API token (cnv_...) from convalytics.dev/tokens
- Designed for Claude, Cursor, and other MCP clients
- Server version 1.0.0 with companion site convalytics.dev/mcp
Convalytics by the numbers
- Data as of Jul 18, 2026 (Skillselion catalog sync)
claude mcp add --transport http convalytics https://api.convalytics.dev/mcp --header "Authorization: Bearer YOUR_TOKEN"Add your badge
Show developers this MCP server is listed on Skillselion. Paste this into your README.
| repo stars | ★ 6 |
|---|---|
| Transport | HTTP |
| Auth | Required |
| Last updated | July 17, 2026 |
| Repository | Dan-Cleary/convalytics ↗ |
What it does
Query read-only product analytics for your Convex app from Claude Code or Cursor instead of clicking through dashboards when deciding what to fix or ship next.
Who is it for?
Best when you're shipping on Convex and want MCP-driven analytics Q&A in Claude Code or Cursor during growth and iteration.
Skip if: Skip if you're not on Convex, developers and need write access to production data, or products without Convalytics instrumentation set up.
What you get
After you authorize with a Convalytics Bearer token, your agent pulls read-only analytics for your Convex app through the hosted MCP remote.
- Agent-accessible read-only analytics queries against your Convex app
- Reduced dashboard context-switch during growth decisions
- Documented HTTP MCP endpoint for team-wide agent configs
By the numbers
- Server version 1.0.0
- Remote MCP URL https://api.convalytics.dev/mcp
- Read-only analytics scope per server description
README.md
Convalytics
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
Recommended MCP Servers
1ClickReport40 tools for marketing analytics, campaign management, and AI monitoring across 6 platforms.
222wcnm BilistalkermcpTrack Bilibili creators and get the latest updates on videos, dynamics, and articles.7
ABMeterFeature flagging and A/B testing platform with AI-first experimentation workflows.
Abs McpQuery the ABS in plain English — CPI, labour force, building approvals, migration, GDP.
AdAdvisor MCP ServerQuery Meta Ads performance data — accounts, campaigns, ad sets, ads, metrics & settings.
ADCIRC Model Setup MCP ServerADCIRC model configuration debugging, parameter lookup, and validation5How it compares
Convex-specific read-only analytics MCP, not a general database or agent memory server.
FAQ
Who is Convalytics for?
Developers and small teams running Convex-backed SaaS who want their coding agent to read product analytics safely via MCP.
When should I use Convalytics?
Use it in Grow when you are analyzing funnels, engagement, or support drivers and want answers inside the agent instead of only in the Convalytics web UI.
How do I add Convalytics to my agent?
Create an API token at https://convalytics.dev/tokens, add the streamable HTTP server https://api.convalytics.dev/mcp with Authorization header Bearer cnv_..., in your MCP client settings.