Summary
Connects Claude to Convalytics analytics dashboards for Convex apps. Exposes read-only query access to page views, sessions, bounce rates, referrers, device breakdowns, and custom product events tracked from your Convex mutations. Useful when you want to ask questions about user behavior, conversion funnels, or feature adoption without switching to the web dashboard. The MCP endpoint runs at api.convalytics.dev/mcp and works over streamable HTTP, so no local server setup needed. Pairs with their Convex component that handles server-side event ingestion, which can't be blocked by ad blockers like client-side analytics.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Tools
Public tool metadata for what this MCP can expose to an agent.
9 tools
list_projectsList all Convalytics projects on the team this token belongs to. Useful when the agent needs to confirm the project it's querying against. No arguments.
List all Convalytics projects on the team this token belongs to. Useful when the agent needs to confirm the project it's querying against. No arguments.
No parameter schema in public metadata yet.
get_usageReturn the current month's custom-event usage, monthly quota, retention days, and plan name for the team.
Return the current month's custom-event usage, monthly quota, retention days, and plan name for the team.
No parameter schema in public metadata yet.
top_pagesReturn the top pages for a specific project, ranked by views in a time window. Default window is the last 7 days. Use list_projects first if you don't know the project name. Returns path, views, uniqueVisitors, and percentage of total views for each page. Pass `user` to see pa...5 params
Return the top pages for a specific project, ranked by views in a time window. Default window is the last 7 days. Use list_projects first if you don't know the project name. Returns path, views, uniqueVisitors, and percentage of total views for each page. Pass `user` to see pa...
Parameters* required
limitnumberMaximum number of pages to return. Default 20, max 50.
projectstringProject name (case-insensitive, e.g. 'slopbench') or project id from list_projects.
sincenumberStart of window as unix milliseconds. Defaults to 7 days ago.
untilnumberEnd of window as unix milliseconds. Defaults to now.
userstringOptional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity.
top_referrersReturn the top referring hosts for a specific project, ranked by visit count in a time window. Includes '(direct)' for visits with no referrer. Default window is the last 7 days.4 params
Return the top referring hosts for a specific project, ranked by visit count in a time window. Includes '(direct)' for visits with no referrer. Default window is the last 7 days.
Parameters* required
limitnumberMaximum number of referrers to return. Default 10, max 50.
projectstringProject name (case-insensitive, e.g. 'slopbench') or project id from list_projects.
sincenumberStart of window as unix milliseconds. Defaults to 7 days ago.
untilnumberEnd of window as unix milliseconds. Defaults to now.
pageviews_countCount page views for a specific project in a time window. Page views are the automatic hits captured by the browser script tag (separate from custom events). Use this for web-traffic questions like 'how many pageviews in the last 24 hours'. Default window is the last 7 days. P...4 params
Count page views for a specific project in a time window. Page views are the automatic hits captured by the browser script tag (separate from custom events). Use this for web-traffic questions like 'how many pageviews in the last 24 hours'. Default window is the last 7 days. P...
Parameters* required
projectstringProject name (case-insensitive, e.g. 'slopbench') or project id from list_projects.
sincenumberStart of window as unix milliseconds. Defaults to 7 days ago.
untilnumberEnd of window as unix milliseconds. Defaults to now.
userstringOptional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity.
events_countCount CUSTOM PRODUCT events for a specific project in a time window, optionally filtered to one event name and/or one user. Custom events are emitted by explicit analytics.track() calls in app code (signup_completed, payment_succeeded, etc.). This does NOT count page views — u...5 params
Count CUSTOM PRODUCT events for a specific project in a time window, optionally filtered to one event name and/or one user. Custom events are emitted by explicit analytics.track() calls in app code (signup_completed, payment_succeeded, etc.). This does NOT count page views — u...
Parameters* required
namestringOptional event name to filter by (e.g. 'signup_completed'). If omitted, counts all custom events in the window. Do NOT pass 'page_view' here — page views are in a separate table.
projectstringProject name (case-insensitive, e.g. 'slopbench') or project id from list_projects.
sincenumberStart of window as unix milliseconds. Defaults to 7 days ago.
untilnumberEnd of window as unix milliseconds. Defaults to now.
userstringOptional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity.
recent_eventsReturn the most recent custom events for a specific project, optionally filtered to one event name and/or one user. PII (userEmail, userName, props) is redacted by default; pass redact: false to include them.5 params
Return the most recent custom events for a specific project, optionally filtered to one event name and/or one user. PII (userEmail, userName, props) is redacted by default; pass redact: false to include them.
Parameters* required
limitnumberMaximum number of events to return. Default 20, max 100.
namestringOptional event name to filter by (e.g. 'signup_completed'). Omit to return events of any name.
projectstringProject name (case-insensitive, e.g. 'slopbench') or project id from list_projects.
redactbooleanIf true (default), userEmail/userName are null and props is {}. Set to false to include them.
userstringOptional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity.
user_activityComposite snapshot of a specific user's activity on a project. Returns an identity block (visitorId, userEmail, userName, firstSeen, lastSeen), total pageviews, total custom events, session count, top pages this user visited, their most-fired event names, and their 20 most rec...4 params
Composite snapshot of a specific user's activity on a project. Returns an identity block (visitorId, userEmail, userName, firstSeen, lastSeen), total pageviews, total custom events, session count, top pages this user visited, their most-fired event names, and their 20 most rec...
Parameters* required
projectstringProject name (case-insensitive, e.g. 'slopbench') or project id from list_projects.
sincenumberStart of window as unix milliseconds. Defaults to 7 days ago.
untilnumberEnd of window as unix milliseconds. Defaults to now.
userstringUser identifier. Accepts userEmail (case-insensitive, e.g. 'dan@example.com') or visitorId (the exact string passed as userId on the original track() call).
weekly_digestComposite snapshot of a project's web analytics over a lookback window. Returns unique visitors, pageviews, sessions, bounce rate, average session duration, top 5 pages, top 5 referrers, total custom events, and top 5 event names. Includes period-over-period comparison against...3 params
Composite snapshot of a project's web analytics over a lookback window. Returns unique visitors, pageviews, sessions, bounce rate, average session duration, top 5 pages, top 5 referrers, total custom events, and top 5 event names. Includes period-over-period comparison against...
Parameters* required
comparebooleanInclude period-over-period comparison against the prior equal-length window. Default true. Set false for faster response when only current numbers matter.
daysnumberLookback window in days, 1 to 90. Default 7.
projectstringProject name (case-insensitive, e.g. 'slopbench') or project id from list_projects.
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
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Categories
Registryactive
TransportHTTP
AuthRequired
UpdatedApr 23, 2026
