Back to search
100
MCP live v1.0.0 MCP 2025-06-18 streamable-http

io.github.dan-cleary/convalytics

io.github.dan-cleary/convalytics

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

Uptime
100.0%
1 direct probes · 30d
Response
635ms
last probe
Tools
15
callable
Resources
0
readable
Prompts
0
available
Primary URL
https://api.convalytics.dev/mcp

Tools · 15

list_projects

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.

get_usage

Return the current month's custom-event usage, monthly quota, retention days, and plan name for the team.

top_pages

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, uniqu…

top_referrers

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.

pageviews_count

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 'h…

events_count

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 (s…

recent_events

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 inclu…

user_activity

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…

weekly_digest

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 …

list_funnels

List 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 exclu…

get_funnel

Return the full definition of one funnel by id: name, description, ordered steps, and conversion window.

create_funnel

Create 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 l…

update_funnel

Patch an existing funnel. Any subset of name/description/steps/conversionWindowMs. Refuses updates on deleted funnels.

delete_funnel

Soft 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 a…

compute_funnel

Run 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 sca…

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "io.github.dan-cleary/convalytics": {
      "url": "https://api.convalytics.dev/mcp",
      "transport": "streamable-http"
    }
  }
}