Convalytics

MCP serverDatabases & data

Convalytics gives your AI read-only access to analytics from your Convex app. Once added, you can ask your AI questions about your app's analytics and get answers without leaving your conversation. It works from Claude, Cursor, and other AI clients.

Use Convalytics in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Convalytics and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use Convalytics to list projects

Details

Available today. Use it from your connected AI after setup.

Add Convalytics, then ask your AI a question about your Convex app's analytics from Claude, Cursor, or another client. Setup details are in the repository at github.com/dan-cleary/convalytics.

ConvalyticsStart free

What your AI can do with it

  • Answer questions about your Convex app's analytics
  • Pull analytics data from your Convex app on request
  • Read your app's data without changing anything
  • Work from Claude, Cursor, and other AI clients

Install Convalytics

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user convalytics 'https://api.convalytics.dev/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://api.convalytics.dev/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=convalytics&config=eyJ1cmwiOiJodHRwczovL2FwaS5jb252YWx5dGljcy5kZXYvbWNwIn0=

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://api.convalytics.dev/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add convalytics --url 'https://api.convalytics.dev/mcp'

    Run it once, then sign in with codex mcp login convalytics if the server asks for an account.

From the project's README

As published by dan-cleary/convalytics in README.md.

Web analytics and product event tracking built for Convex apps.

Dashboard: 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

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

PackageDescription
convalytics-devConvex component for server-side event tracking
convalyticsCLI 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

Tools it offers (15)

What this server listed when Ahel dialed its public endpoint in Oct 2026, with no key and no account of yours. The names are the server’s own.

  • list_projects
  • get_usage
  • top_pages
  • top_referrers
  • pageviews_count
  • events_count
  • recent_events
  • user_activity
  • weekly_digest
  • list_funnels
  • get_funnel
  • create_funnel
  • update_funnel
  • delete_funnel
  • compute_funnel

Signals

GitHub stars
7
Last commit
Jul 2026
Advanced
Delivery
convalytics MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-dan-cleary-convalytics
Source
github.com/dan-cleary/convalytics
Hosted endpoint
https://api.convalytics.dev/mcp