Servidor MCP
convalytics
io.github.Dan-Cleary/convalytics
Qué hace este MCP
Provides read-only product analytics for Convex applications, including page views, events, funnels, user activity, traffic sources, and weekly performance summaries.
Capacidades
Herramientas
15
herramientas
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 scan cap was hit.
Solo lectura
Idempotente
Esquema de entrada
{'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}
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 limit, without which a funnel is just event co-occurrence. Returns { id } on success.
Esquema de entrada
{'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}
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 and cannot be undone from MCP.
Destructivo
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['funnelId'], 'properties': {'funnelId': {'type': 'string'}}, 'additionalProperties': False}
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 (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.
Solo lectura
Idempotente
Esquema de entrada
{'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}
get_funnel
Return the full definition of one funnel by id: name, description, ordered steps, and conversion window.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['funnelId'], 'properties': {'funnelId': {'type': 'string', 'description': 'Funnel id from list_funnels or create_funnel.'}}, 'additionalProperties': False}
get_usage
Return the current month's custom-event usage, monthly quota, retention days, and plan name for the team.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
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 excluded.
Solo lectura
Idempotente
Esquema de entrada
{'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_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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
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 'how many pageviews in the last 24 hours'. Default window is the last 7 days. Pass `user` to scope to one visitor.
Solo lectura
Idempotente
Esquema de entrada
{'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}
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 include them.
Solo lectura
Idempotente
Esquema de entrada
{'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}
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, uniqueVisitors, and percentage of total views for each page. Pass `user` to see pages a specific visitor hit.
Solo lectura
Idempotente
Esquema de entrada
{'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_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.
Solo lectura
Idempotente
Esquema de entrada
{'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}
update_funnel
Patch an existing funnel. Any subset of name/description/steps/conversionWindowMs. Refuses updates on deleted funnels.
Idempotente
Esquema de entrada
{'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}
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 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.
Solo lectura
Idempotente
Esquema de entrada
{'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}
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 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.
Solo lectura
Idempotente
Esquema de entrada
{'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}
Historial
Cambios recientes en herramientas
Añadido
compute_funnel
17 de September de 2026 a las 12:41
Añadido
delete_funnel
17 de September de 2026 a las 12:41
Añadido
update_funnel
17 de September de 2026 a las 12:41
Añadido
create_funnel
17 de September de 2026 a las 12:41
Añadido
get_funnel
17 de September de 2026 a las 12:41
Añadido
list_funnels
17 de September de 2026 a las 12:41
Añadido
weekly_digest
17 de September de 2026 a las 12:41
Añadido
user_activity
17 de September de 2026 a las 12:41
Añadido
recent_events
17 de September de 2026 a las 12:41
Añadido
events_count
17 de September de 2026 a las 12:41
Añadido
pageviews_count
17 de September de 2026 a las 12:41
Añadido
top_referrers
17 de September de 2026 a las 12:41
Añadido
top_pages
17 de September de 2026 a las 12:41
Añadido
get_usage
17 de September de 2026 a las 12:41
Añadido
list_projects
17 de September de 2026 a las 12:41
Descubrir
Servidores MCP similares
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Oracle
com.stratalize/oracle
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Intelligence
com.stratalize/intelligence
Provides vendor, market, SaaS, workforce, government contract, public company, regulatory, competitive, and AI-brand intelligence…
Stratalize Real Estate
com.stratalize/realestate
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…