Convalytics MCP server
online · 100% uptimeio.github.Dan-Cleary/convalytics·v1.0.0·7 starsRead-only analytics for Convex apps, queryable via MCP from Claude, Cursor, and other clients.
7 stars
Reviews
Write oneNobody has reviewed Convalytics yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Convalytics tools (15, 4 write)
write = sends, deletes, buys or postscompute_funnelwrite actionFreeRun a funnel over a time window and return per-step visitor count, conversion from previous step, conversion from start, and average time to convert between steps. Returns `truncated` flags if the scan cap was hit.
create_funnelwrite actionFreeCreate a new funnel on a project. Steps are 2–10 ordered events or pageview paths. conversionWindowMs caps how long a visitor has between consecutive steps (default 7 days); this is the step-to-step limit, without which a funnel is just event co-occurrence. Returns { id } on success.
delete_funnelwrite actionFreeSoft delete a funnel. The row is retained with status='deleted' and excluded from list/get/compute. Idempotent — calling twice is a no-op. Use if the funnel is obsolete; the record is kept for audit and cannot be undone from MCP.
events_countFreeCount 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 — use pageviews_count or weekly_digest for those. Returns count, unique visitors, and a `truncated` flag if the scan hit the maximum scan size.
get_funnelFreeReturn the full definition of one funnel by id: name, description, ordered steps, and conversion window.
get_usageFreeReturn the current month's custom-event usage, monthly quota, retention days, and plan name for the team.
list_funnelsFreeList active funnels defined on a project. A funnel is a saved ordered sequence of steps (events or pageview paths) that Convalytics computes step-by-step conversion for. Soft-deleted funnels are excluded.
list_projectsFreeList 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.
pageviews_countFreeCount 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. Pass `user` to scope to one visitor.
recent_eventsFreeReturn 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.
top_pagesFreeReturn 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 pages a specific visitor hit.
top_referrersFreeReturn 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.
update_funnelwrite actionFreePatch an existing funnel. Any subset of name/description/steps/conversionWindowMs. Refuses updates on deleted funnels.
user_activityFreeComposite 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 recent events with props. Use this for 'how is dancleary54@gmail.com using my app?' style questions — one call, full picture. For ad-hoc drill-down (just a count, just recent events) pass `user` to the individual tools instead. Default window is the last 7 days.
weekly_digestFreeComposite 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 the prior equal-length window unless compare: false. Prefer this over chaining top_pages + top_referrers + events_count when the agent just wants to report on the week.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 997ms20/20
- Tool poisoning15 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 72 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Convalytics compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 84/100
- higher than 68% of 48,255 servers
- Tools
- 15
- the typical server has 7
- Tools that change things
- 27%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 125 ms
- faster than 78% of 30,031 servers
- GitHub stars
- 7
- more than 86% of 28,688 servers
What its tools let an agent do: 11 read · 1 create · 2 change · 1 delete
Install Convalytics in Claude Code, Cursor or VS Code
claude mcp add --transport http convalytics https://api.convalytics.dev/mcp
What the publisher says
From the Convalytics repository's README, as published. We do not edit it. Read it on GitHub
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 initThis 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
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 devThis starts both the Vite frontend and convex dev in parallel.
Links
- Dashboard
- Component repo
- GitHub
Nothing above is checked by us. What we check is on the safety report.
Convalytics: common questions
- Is Convalytics MCP server safe?
- Mostly: it is graded B (84/100). Read the Convalytics safety report
- How do I install Convalytics?
- It runs remotely at api.convalytics.dev. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Convalytics need an API key?
- Yes. The registry entry asks for
Authorization. - Is Convalytics maintained?
- The last commit was 110 days ago (2026-07-17). The latest release is v1.0.0.
- Is Convalytics up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does Convalytics compare with other MCP servers?
- safety score 84/100 (higher than 68% of 48,255 servers); tools 15 (the typical server has 7); tools that change things 27% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.