List every website you can access (including team sites). CALL THIS FIRST — every other tool needs a website ID from here. Returns id, name, domain, createdAt.

Fetch one website's metadata (name, domain, share settings, createdAt) by ID.

Return the earliest and latest timestamps for which a website has analytics data. Use this to choose a valid window before querying stats/metrics.

Aggregate metrics for a website over a date range: pageviews, visitors (unique sessions), visits, bounces (single-pageview sessions), and totaltime (seconds). Includes a previous-period comparison by default.

Pageviews and sessions over time, bucketed by unit. Returns { pageviews: [{x,y}], sessions: [{x,y}] } where x is the bucket timestamp and y the count.

Current real-time active visitor count for a website (visitors in the last few minutes).

Richer real-time snapshot for a website (recent events/sessions/series). Availability varies by Umami version; falls back gracefully.

Top-N breakdown of a website by a single dimension (type) over a date range. Returns ranked { x: value, y: count } rows. Use type=event for custom-event counts. url is an alias for path.

List the distinct values seen for a column over a date range — useful to discover valid filter values (e.g. all browsers or countries) before filtering other queries.

Custom-event activity over time for a website, bucketed by unit. Returns a time series of event counts. For a ranked list of event names use get_metrics(type='event').

Explore custom event properties. select chooses the view: 'events' (event names), 'fields' (all fields), 'properties' (property keys), 'values' (values for a property — pass propertyName), or 'stats' (counts). Optionally scope by eventName.

Paginated list of individual visitor sessions over a date range (id, browser, os, device, geo, screen, visits, views, firstAt/lastAt). Supports search + filters.

Fetch a single visitor session's details by session ID.

Ordered pageview/event timeline for a single session (createdAt, urlPath, referrer, eventType, eventName) — effectively a data-level session replay.

Aggregate session totals over a date range: pageviews, visitors, visits, countries, events — a session-centric overview.

List the custom properties attached to a single session (set via identify calls).

Conversion funnel across an ordered list of steps. Each step is { type: 'path' | 'event', value }. window is the conversion window (hours).

Cohort retention over the selected period (how many users return on subsequent days).

Most common navigation paths through the site, up to steps deep (2–7). Optionally pin a start or end step.

Progress toward one or more goals. Each goal is { type: 'event' | 'path', value }. Computed per goal against Umami's /reports/goal endpoint.

Conversion attribution. model is first-click or last-click; type is the target dimension; step the target value.

Revenue analytics over the period (requires revenue events configured in Umami). currency is required (e.g. USD).

Breakdown of traffic by UTM parameters (source, medium, campaign, content, term).

Multi-dimensional breakdown across one or more fields (e.g. ['country','browser']).

List saved reports (funnels, goals, journeys, etc.), optionally scoped to a website.

Fetch a saved report's full definition (type, parameters) by ID.

List saved segments and cohorts defined for a website.

Fetch a single segment/cohort definition by ID.

List teams you belong to (id, name, role). Available on both Cloud and self-hosted.

Fetch a single team's metadata by ID.

List members of a team and their roles (team-owner, team-manager, team-member, team-view-only).

Return the authenticated account's profile: id, username, role, isAdmin, and teams. Credentials/tokens are stripped from the response.