List recent visitor sessions with filtering.

Each session includes: duration, page count, entry/exit URLs, device info, screen size, IP address, location (country/city), friction score, and rage click count.

Use this to find sessions matching specific criteria — e.g. frustrated mobile users, visitors from a specific country, or high-friction sessions.

Args: query: Search entry/exit URLs (e.g. "/pricing", "/checkout") limit: Max results (1-100, default 20) offset: Pagination offset country: Filter by country name device_type: "mobile" or "desktop" min_friction: Minimum friction score (0-10) min_duration: Minimum session duration in seconds has_rage_clicks: Only sessions with rage clicks

Get full details for a specific session.

Returns the complete session record including: all page visits with timestamps, event timeline, device/browser info, IP address, geographic location, friction breakdown, rage clicks, errors encountered, and navigation path.

Use this to deep-dive into a specific session after finding it via get_sessions.

Args: session_id: The session primary key (UUID) from get_sessions results

Get aggregate site statistics and performance metrics.

Returns: total sessions, average duration, average friction score, bounce rate, rage click sessions, device breakdown (desktop/mobile), browser breakdown, top entry pages, top exit pages, daily session counts, and friction score distribution.

Use this for an overview of site health and trends.

Args: days: Lookback period in days (7-90, default 7)

Get detected anomalies for the site.

Anomalies are automatically detected when metrics deviate significantly from their 7-day rolling average (>2 standard deviations). Types include: traffic_spike, traffic_drop, friction_surge, and bounce_spike.

Each anomaly includes: type, severity (warning/critical), metric name, expected vs actual values, deviation percentage, and an AI-generated explanation of what likely caused it.

Args: limit: Max results (1-200, default 20) unacknowledged_only: Only show unacknowledged anomalies

List all conversion funnels defined for this site.

Returns funnel definitions with their name, steps (URLs/patterns), and creation date. Use the funnel ID with get_funnel_analysis to see conversion rates and drop-off points.

Analyze a conversion funnel — see where users drop off.

Returns step-by-step conversion rates showing how many sessions reached each step, the conversion rate between steps, and the overall funnel completion rate.

Use this to identify which step in a user flow (e.g. landing -> signup -> checkout -> payment) loses the most visitors.

Args: funnel_id: Funnel ID from get_funnels results days: Lookback period in days (7-90, default 30)