io.github.Dan-Cleary/convalytics

skills: {'id': 'list_projects', 'name': 'list_projects', 'description': "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.", 'tags': [], 'examples': None, 'input_modes': None, 'output_modes': None}, {'id': 'get_usage', 'name': 'get_usage', 'description': "Return the current month's custom-event usage, monthly quota, retention days, and plan name for the team.", 'tags': [], 'examples': None, 'input_modes': None, 'output_modes': None}, {'id': 'top_pages', 'name': 'top_pages', 'description': "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.", 'tags': [], 'examples': None, 'input_modes': None, 'output_modes': None}, {'id': 'top_referrers', 'name': 'top_referrers', 'description': "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.", 'tags': [], 'examples': None, 'input_modes': None, 'output_modes': None}, {'id': 'pageviews_count', 'name': 'pageviews_count', 'description': "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.", 'tags': [], 'examples': None, 'input_modes': None, 'output_modes': None}, {'id': 'events_count', 'name': 'events_count', 'description': '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.', 'tags': [], 'examples': None, 'input_modes': None, 'output_modes': None}, {'id': 'recent_events', 'name': 'recent_events', 'description': '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.', 'tags': [], 'examples': None, 'input_modes': None, 'output_modes': None}, {'id': 'user_activity', 'name': 'user_activity', 'description': "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 [email protected] 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.", 'tags': [], 'examples': None, 'input_modes': None, 'output_modes': None}; uptime_30d 1.0%; p95 1513.0ms; conformance: pass

How to connect

https://api.convalytics.dev/mcp

curl -X POST https://api.convalytics.dev/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'