list_projectsList all Convalytics projects on the team this token belongs to. Useful when the agent needs to confirm the project it's querying against. No argument
get_usageReturn the current month's custom-event usage, monthly quota, retention days, and plan name for the team.
top_pagesReturn 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
top_referrersReturn the top referring hosts for a specific project, ranked by visit count in a time window. Includes '(direct)' for visits with no referrer. Defaul
pageviews_countCount 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 e
events_countCount 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
recent_eventsReturn the most recent custom events for a specific project, optionally filtered to one event name and/or one user. PII (userEmail, userName, props) i
user_activityComposite snapshot of a specific user's activity on a project. Returns an identity block (visitorId, userEmail, userName, firstSeen, lastSeen), total
weekly_digestComposite snapshot of a project's web analytics over a lookback window. Returns unique visitors, pageviews, sessions, bounce rate, average session dur
list_funnelsList active funnels defined on a project. A funnel is a saved ordered sequence of steps (events or pageview paths) that Convalytics computes step-by-s
get_funnelReturn the full definition of one funnel by id: name, description, ordered steps, and conversion window.
create_funnelCreate a new funnel on a project. Steps are 2–10 ordered events or pageview paths. conversionWindowMs caps how long a visitor has between consecutive
update_funnelPatch an existing funnel. Any subset of name/description/steps/conversionWindowMs. Refuses updates on deleted funnels.
delete_funnelSoft 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
compute_funnelRun a funnel over a time window and return per-step visitor count, conversion from previous step, conversion from start, and average time to convert b
No proxied traffic observed for this host yet. Connect it at /connect and its grade gains a measured Reliability score + per-tool behavioral evidence — the half a static scan can't produce.
We re-grade api.convalytics.dev on a schedule and alert your Slack/webhook the moment its tools change or its grade drops — rug-pull insurance for the connection.
Add the wmcp.sh trust oracle as an MCP server and call grade_mcp_server / check_mcp_drift in your agent's pre-connection gate:
https://wmcp.sh/mcp/trust
readOnly vs observed behavior) layer on via the wmcp.sh proxy.