English Français العربية

io.github.Dan-Cleary/convalytics

Official registry Marketing and sales

Read-only analytics for Convex apps, queryable via MCP from Claude, Cursor, and other clients.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http convalytics 'https://api.convalytics.dev/mcp' --header 'Authorization: <Convalytics API token. Create at https://convalytics.dev/tokens. Paste as '\''Bearer cnv_...'\''.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "convalytics": {
            "type": "http",
            "url": "https://api.convalytics.dev/mcp",
            "headers": {
                "Authorization": "<Convalytics API token. Create at https://convalytics.dev/tokens. Paste as 'Bearer cnv_...'.>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Convalytics
  2. What is Convalytics?
  3. Quick start
  4. Packages
  5. Project structure
  6. Tech stack
  7. Development
  8. Links

Convalytics

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.

Frequently asked questions

What is io.github.Dan-Cleary/convalytics?

Read-only analytics for Convex apps, queryable via MCP from Claude, Cursor, and other clients.

How do I install io.github.Dan-Cleary/convalytics?

It runs as a remote server. In Claude Code: claude mcp add --transport http convalytics 'https://api.convalytics.dev/mcp' --header 'Authorization: <Convalytics API token. Create at https://convalytics.dev/tokens. Paste as '\''Bearer cnv_...'\''.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Dan-Cleary/convalytics need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is io.github.Dan-Cleary/convalytics open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains io.github.Dan-Cleary/convalytics?

It is published by Dan-Cleary. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.