Koskamo

Convalytics MCP

An MCP server for Convalytics that allows AI assistants to query Convex app analytics conversationally. It provides nine read-only tools for project metrics and user activity, plus six funnel tools for creating and analyzing conversion funnels, enabling developers to inspect event data and track user journeys directly within their AI workflows.

Visit Convalytics

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Convalytics MCP logo, by ConvalyticsCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by Convalytics
You need:Authorization: Bearer cnv_... # API token from /tokensGated to Solo+ plans.
MCP endpoint (Streamable HTTP)
https://api.convalytics.dev/mcp
Vendor documentation

What its tools do

15 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (12)

Can change data (3)

15 of 15 have a description · 15 of 15 declare behavior hints · 10 of 13 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Query project usage metrics and pageviews
  • Retrieve recent events and user activity snapshots
  • Generate weekly project digests with comparisons
  • Create and compute conversion funnels

Source and maintenance

Community listingRegistry 1.0.0
mcp-registry: io.github.Dan-Cleary/convalytics@1.0.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
convalytics 1.0.0
MCP protocol negotiated in check
2025-06-18
Tools
15 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Tools

15 advertised

list_projects
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

list_projects input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
list_projects annotations
{
  "title": "List projects",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_usage
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

get_usage input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_usage annotations
{
  "title": "Get usage and plan",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
top_pages
Advertised by the server during the last successful anonymous check.
Advertised read-only

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, uniqueVisitors, and percentage of total views for each page. Pass `user` to see pages a specific visitor hit.

top_pages input schema
{
  "type": "object",
  "required": [
    "project"
  ],
  "properties": {
    "user": {
      "type": "string",
      "description": "Optional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of pages to return. Default 20, max 50."
    },
    "since": {
      "type": "number",
      "description": "Start of window as unix milliseconds. Defaults to 7 days ago."
    },
    "until": {
      "type": "number",
      "description": "End of window as unix milliseconds. Defaults to now."
    },
    "project": {
      "type": "string",
      "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects."
    }
  },
  "additionalProperties": false
}
top_pages annotations
{
  "title": "Top pages",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
top_referrers
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

top_referrers input schema
{
  "type": "object",
  "required": [
    "project"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum number of referrers to return. Default 10, max 50."
    },
    "since": {
      "type": "number",
      "description": "Start of window as unix milliseconds. Defaults to 7 days ago."
    },
    "until": {
      "type": "number",
      "description": "End of window as unix milliseconds. Defaults to now."
    },
    "project": {
      "type": "string",
      "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects."
    }
  },
  "additionalProperties": false
}
top_referrers annotations
{
  "title": "Top referrers",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
pageviews_count
Advertised by the server during the last successful anonymous check.
Advertised read-only

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 'how many pageviews in the last 24 hours'. Default window is the last 7 days. Pass `user` to scope to one visitor.

pageviews_count input schema
{
  "type": "object",
  "required": [
    "project"
  ],
  "properties": {
    "user": {
      "type": "string",
      "description": "Optional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity."
    },
    "since": {
      "type": "number",
      "description": "Start of window as unix milliseconds. Defaults to 7 days ago."
    },
    "until": {
      "type": "number",
      "description": "End of window as unix milliseconds. Defaults to now."
    },
    "project": {
      "type": "string",
      "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects."
    }
  },
  "additionalProperties": false
}
pageviews_count annotations
{
  "title": "Page views count",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
events_count
Advertised by the server during the last successful anonymous check.
Advertised read-only

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 (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.

events_count input schema
{
  "type": "object",
  "required": [
    "project"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Optional event name to filter by (e.g. 'signup_completed'). If omitted, counts all custom events in the window. Do NOT pass 'page_view' here — page views are in a separate table."
    },
    "user": {
      "type": "string",
      "description": "Optional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity."
    },
    "since": {
      "type": "number",
      "description": "Start of window as unix milliseconds. Defaults to 7 days ago."
    },
    "until": {
      "type": "number",
      "description": "End of window as unix milliseconds. Defaults to now."
    },
    "project": {
      "type": "string",
      "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects."
    }
  },
  "additionalProperties": false
}
events_count annotations
{
  "title": "Events count",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
recent_events
Advertised by the server during the last successful anonymous check.
Advertised read-only

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 include them.

recent_events input schema
{
  "type": "object",
  "required": [
    "project"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Optional event name to filter by (e.g. 'signup_completed'). Omit to return events of any name."
    },
    "user": {
      "type": "string",
      "description": "Optional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of events to return. Default 20, max 100."
    },
    "redact": {
      "type": "boolean",
      "description": "If true (default), userEmail/userName are null and props is {}. Set to false to include them."
    },
    "project": {
      "type": "string",
      "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects."
    }
  },
  "additionalProperties": false
}
recent_events annotations
{
  "title": "Recent events",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
user_activity
Advertised by the server during the last successful anonymous check.
Advertised read-only

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 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.

user_activity input schema
{
  "type": "object",
  "required": [
    "project",
    "user"
  ],
  "properties": {
    "user": {
      "type": "string",
      "description": "User identifier. Accepts userEmail (case-insensitive, e.g. 'dan@example.com') or visitorId (the exact string passed as userId on the original track() call)."
    },
    "since": {
      "type": "number",
      "description": "Start of window as unix milliseconds. Defaults to 7 days ago."
    },
    "until": {
      "type": "number",
      "description": "End of window as unix milliseconds. Defaults to now."
    },
    "project": {
      "type": "string",
      "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects."
    }
  },
  "additionalProperties": false
}
user_activity annotations
{
  "title": "User activity",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
weekly_digest
Advertised by the server during the last successful anonymous check.
Advertised read-only

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 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.

weekly_digest input schema
{
  "type": "object",
  "required": [
    "project"
  ],
  "properties": {
    "days": {
      "type": "number",
      "description": "Lookback window in days, 1 to 90. Default 7."
    },
    "compare": {
      "type": "boolean",
      "description": "Include period-over-period comparison against the prior equal-length window. Default true. Set false for faster response when only current numbers matter."
    },
    "project": {
      "type": "string",
      "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects."
    }
  },
  "additionalProperties": false
}
weekly_digest annotations
{
  "title": "Weekly digest",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_funnels
Advertised by the server during the last successful anonymous check.
Advertised read-only

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 excluded.

list_funnels input schema
{
  "type": "object",
  "required": [
    "project"
  ],
  "properties": {
    "project": {
      "type": "string",
      "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects."
    }
  },
  "additionalProperties": false
}
list_funnels annotations
{
  "title": "List funnels",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_funnel
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

get_funnel input schema
{
  "type": "object",
  "required": [
    "funnelId"
  ],
  "properties": {
    "funnelId": {
      "type": "string",
      "description": "Funnel id from list_funnels or create_funnel."
    }
  },
  "additionalProperties": false
}
get_funnel annotations
{
  "title": "Get funnel",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
create_funnel
Advertised by the server during the last successful anonymous check.

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 limit, without which a funnel is just event co-occurrence. Returns { id } on success.

create_funnel input schema
{
  "type": "object",
  "required": [
    "project",
    "name",
    "steps"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable name."
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "kind",
          "match"
        ],
        "properties": {
          "kind": {
            "enum": [
              "event",
              "pageview"
            ],
            "type": "string",
            "description": "'event' for a custom analytics.track() event, 'pageview' for a page-path match."
          },
          "label": {
            "type": "string",
            "description": "Optional friendly display name."
          },
          "match": {
            "type": "string",
            "description": "Event name (for kind='event') or exact pageview path (for kind='pageview')."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 10,
      "minItems": 2,
      "description": "Ordered list of 2–10 steps. Visitors must hit them in order."
    },
    "project": {
      "type": "string",
      "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects."
    },
    "description": {
      "type": "string",
      "description": "Optional longer description."
    },
    "conversionWindowMs": {
      "type": "number",
      "description": "Max ms between consecutive steps. Default 7 days (604800000). Bounds: 60000 (1 min) to 7776000000 (90 days)."
    }
  },
  "additionalProperties": false
}
create_funnel annotations
{
  "title": "Create funnel",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
update_funnel
Advertised by the server during the last successful anonymous check.

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

update_funnel input schema
{
  "type": "object",
  "required": [
    "funnelId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "kind",
          "match"
        ],
        "properties": {
          "kind": {
            "enum": [
              "event",
              "pageview"
            ],
            "type": "string",
            "description": "'event' for a custom analytics.track() event, 'pageview' for a page-path match."
          },
          "label": {
            "type": "string",
            "description": "Optional friendly display name."
          },
          "match": {
            "type": "string",
            "description": "Event name (for kind='event') or exact pageview path (for kind='pageview')."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 10,
      "minItems": 2
    },
    "funnelId": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "conversionWindowMs": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
update_funnel annotations
{
  "title": "Update funnel",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
delete_funnel
Advertised by the server during the last successful anonymous check.
Advertised destructive

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 and cannot be undone from MCP.

delete_funnel input schema
{
  "type": "object",
  "required": [
    "funnelId"
  ],
  "properties": {
    "funnelId": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
delete_funnel annotations
{
  "title": "Delete funnel",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}
compute_funnel
Advertised by the server during the last successful anonymous check.
Advertised read-only

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 scan cap was hit.

compute_funnel input schema
{
  "type": "object",
  "required": [
    "funnelId"
  ],
  "properties": {
    "since": {
      "type": "number",
      "description": "Start of window as unix milliseconds. Defaults to 7 days ago."
    },
    "until": {
      "type": "number",
      "description": "End of window as unix milliseconds. Defaults to now."
    },
    "funnelId": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
compute_funnel annotations
{
  "title": "Compute funnel",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (1 of 1 answered).

  1. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
405 ms
95th percentile latency
405 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 405 ms · metadata changed · 15 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http convalytics-mcp https://api.convalytics.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add convalytics-mcp --url https://api.convalytics.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable convalytics-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "convalytics-mcp": {
      "url": "https://api.convalytics.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "convalytics-mcp": {
      "type": "streamableHttp",
      "url": "https://api.convalytics.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start convalytics-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "convalytics-mcp": {
      "type": "http",
      "url": "https://api.convalytics.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http convalytics-mcp https://api.convalytics.dev/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.convalytics.dev/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "convalytics-mcp": {
      "serverUrl": "https://api.convalytics.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Convalytics MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 6,262