Get Rybbit server version and configuration

List all sites and organizations the authenticated user has access to

Create a new site in Rybbit. Returns the created site with its siteId for tracking integration.

Look up a site ID by domain name. Useful for finding the siteId needed for tracking setup and analytics queries.

Update configuration for an existing Rybbit site. Toggle tracking features like IP tracking, session replay, error tracking, button clicks, etc.

Delete a site from Rybbit. This permanently removes the site and its replay data. Use rybbit_list_sites or rybbit_get_site_id to find site IDs.

Get the current number of live/active users on a site in real-time

Get aggregated overview metrics for a site: sessions, pageviews, unique users, pages per session, bounce rate, and average session duration. Supports date range and filters.

Get overview metrics as time-series data with configurable time buckets (minute, hour, day, week, month). Returns arrays of data points for charting trends.

Get geographic session location data with coordinates. Returns latitude, longitude, city, country, and session count for map visualization and geographic analysis.

Get metric breakdown by dimension. Use parameter='pathname' for top pages, 'browser'/'operating_system'/'device_type' for tech stats, 'country'/'city' for geo, 'utm_source'/'utm_campaign' for marketing, 'referrer'/'channel' for traffic sources, 'entry_page'/'exit_page' for user flow. Returns sorted list with counts, percentages, bounce rate, and session duration.

Get user retention cohort analysis showing how many users return over time periods.

List sessions for a site with filtering and pagination. Returns session ID, user info, device, location, pages visited, duration, bounce status, and IP address (if site has trackIp enabled). Supports client-side IP filtering.

Get detailed session information including all page views, events, user traits, device info, location, and full event timeline. Use rybbit_list_sessions first to find session IDs.

List users for a site. Returns user IDs, session counts, first/last seen dates, and user traits. Supports filtering by any analytics dimension. Use 'search' param to find users by username/email/name (case-insensitive partial match).

Get detailed information about a specific user including their traits, session history, and activity summary.

Get user trait keys, values, or find users by trait. mode='keys' lists all trait keys. mode='values' (default when key is provided) returns distinct values for a trait key. mode='users' finds users matching a specific trait key+value pair (case-insensitive).

Get event count breakdown for a specific user. Shows how many times each event_name was triggered by this user. Accepts either the Rybbit user_id (device hash) or the identified_user_id (app-provided user ID). Useful for analyzing per-user behavior like ad_click, chat_message_sent, etc.

List raw events for a site with filtering and pagination. Returns individual event records with timestamps, types, pathnames, event names, and properties. When filtering by event_name, only matching events are returned (not entire sessions).

Get all custom event names and their occurrence counts for a site. Useful for discovering what events are being tracked.

Get property breakdowns for a specific custom event. Returns the distinct property keys and values with counts.

Get custom event counts as time-series data with configurable buckets. Useful for analyzing event trends over time.

Get outbound link clicks tracked on the site. Shows which external URLs users are clicking and how often.

Get error tracking data. Workflow: (1) type='names' to see error types and counts, (2) type='events' with errorMessage to see individual instances with stack traces, (3) type='timeseries' with errorMessage to see trends over time.

Get Core Web Vitals performance metrics (LCP, CLS, INP, FCP, TTFB) with p50, p75, p90, p99 percentiles. Optionally break down by page path, browser, or OS.

Get Core Web Vitals performance metrics as time-series data for trend analysis.

List all saved funnels for a site with their step definitions.

Analyze a custom funnel by defining steps (page visits or events). Returns visitor counts and drop-off rates at each step.

Get the sessions that reached (or dropped off at) a specific funnel step. Useful for drilling into why users drop off at a particular funnel step.

Create and save a new funnel in Rybbit. Requires a name and at least 2 steps. Each step is either a page path (supports wildcards) or a custom event name. Use rybbit_list_funnels to verify creation afterward.

Update an existing funnel's name and/or steps. Uses the create endpoint with reportId to perform an upsert. Use rybbit_list_funnels to find funnel IDs (the 'id' field is the reportId).

Permanently delete a saved funnel. This cannot be undone. Use rybbit_list_funnels to find funnel IDs.

Create multiple funnels at once. Each funnel is created sequentially to respect rate limits. If one fails, the others still proceed. Returns a summary of successes and failures.

List all goals for a site with their current conversion metrics and configuration.

Get sessions that completed a specific goal. Useful for analyzing which users and sessions triggered goal conversions.

Create a new conversion goal in Rybbit. A goal tracks conversions when users visit a specific page path or trigger a custom event. For path goals: set goalType='path' and config.pathPattern (e.g. '/order-confirmation'). For event goals: set goalType='event' and config.eventName (e.g. 'purchase'). Use rybbit_list_goals to verify creation afterward.

Update an existing goal. You must provide the full goal definition (goalType + config) as the update replaces the entire goal. Use rybbit_list_goals to find goal IDs and current configuration.

Permanently delete a conversion goal. This cannot be undone. Use rybbit_list_goals to find goal IDs.

Create multiple conversion goals at once. Each goal is created sequentially to respect rate limits. If one fails, the others still proceed. Returns a summary of successes and failures.

Get user journey (flow) analysis showing the most common navigation paths through the site. Shows sequences of pages users visit and how many sessions follow each path.

Get page titles with visit counts, percentages, and average time on page. Useful for understanding content engagement. Returns title, pathname, visits, percentage, and avg time.

Get time-bucketed event counts broken down by type: pageviews, custom events, performance, outbound, errors, button clicks, copy, form submits, input changes. Useful for understanding the volume and mix of tracking events over time.

Get aggregated daily event counts across all sites in an organization. Includes breakdown by event type (pageviews, custom events, errors, etc.). Use rybbit_list_sites to find organization IDs.

Check if a site has any recorded events. Returns a boolean. Useful for verifying that the tracking script is properly installed before querying analytics.

Get daily session counts for a specific user over time. Useful for analyzing individual user activity patterns and retention.

Get the list of IP addresses excluded from tracking for a site. Useful for auditing tracking configuration.

Get the list of country codes excluded from tracking for a site. Useful for compliance auditing (GDPR, etc.).

Get full site configuration and metadata: domain, name, creation date, tracking flags (blockBots, trackIp, sessionReplay, webVitals, trackErrors, trackOutbound, trackUrlParams, trackButtonClicks, trackCopy, trackFormInteractions, etc.). Complementary to rybbit_update_site_config — this reads the current config.