# Convalytics

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-dan-cleary-convalytics`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Dan-Cleary](https://agentstack.voostack.com/s/dan-cleary)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 1.0.0
- **License:** Apache-2.0
- **Upstream author:** [Dan-Cleary](https://github.com/Dan-Cleary)
- **Source:** https://github.com/Dan-Cleary/convalytics
- **Website:** https://convalytics.dev

## Install

```sh
agentstack add mcp-dan-cleary-convalytics
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Convalytics

Web analytics and product event tracking built for [Convex](https://convex.dev) apps.

**Dashboard:** [convalytics.dev](https://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

```bash
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`](https://www.npmjs.com/package/convalytics-dev) | Convex component for server-side event tracking |
| [`convalytics`](https://www.npmjs.com/package/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](https://github.com/Dan-Cleary/convalytics-convex-component)

## Tech stack

- **Backend:** [Convex](https://convex.dev) — 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

```bash
npm install
npm run dev
```

This starts both the Vite frontend and `convex dev` in parallel.

## Links

- [Dashboard](https://convalytics.dev)
- [Component repo](https://github.com/Dan-Cleary/convalytics-convex-component)
- [GitHub](https://github.com/Dan-Cleary/convalytics)
- [Twitter](https://x.com/DanJCleary)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Dan-Cleary](https://github.com/Dan-Cleary)
- **Source:** [Dan-Cleary/convalytics](https://github.com/Dan-Cleary/convalytics)
- **License:** Apache-2.0
- **Homepage:** https://convalytics.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-dan-cleary-convalytics
- Seller: https://agentstack.voostack.com/s/dan-cleary
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.