List the websites in your Umami account, with their ids, names, and domains.

Takes no arguments. Use the returned id for the other tools. If a team id is configured the team's websites are returned; otherwise your personal websites.

Get overview metrics for a website over a date range.

Returns pageviews, unique visitors, visits, bounces, and total time. If you get no data, double-check the date range before assuming there is none.

Args: website_id: The website id (from get_websites). start_at: Range start, 'YYYY-MM-DD' or 'YYYY-MM-DD HH:MM:SS' (UTC). end_at: Range end, same formats (a bare date includes the whole day).

Get a breakdown of visitors by a dimension over a date range.

type selects the dimension: url (pages), referrer (traffic sources), browser, os, device, country, or event (tally of tracked events).

Args: website_id: The website id (from get_websites). start_at: Range start (UTC). end_at: Range end (UTC). type: One of url, referrer, browser, os, device, country, event.

Get a pageviews-and-sessions time series, bucketed by hour, day, or month.

Use 'hour' for short ranges (1-7 days), 'day' for medium ranges, 'month' for long ranges.

Args: website_id: The website id (from get_websites). start_at: Range start (UTC). end_at: Range end (UTC). unit: Bucket size: hour, day, or month. timezone: IANA timezone for bucketing, e.g. 'UTC' or 'Europe/London'.

Get the number of visitors currently active on a website (real-time).

Args: website_id: The website id (from get_websites).

Get the unique session ids active in a range, optionally filtered to an event.

Use this to find sessions to inspect with get_tracking_data, not to count unique visitors (use get_website_stats for counts). Pass event_name to keep only sessions that fired that event, or omit it for all sessions.

Args: website_id: The website id (from get_websites). start_at: Range start (UTC). end_at: Range end (UTC). event_name: Optional event name to filter by (e.g. 'checkout_completed').

Get the full activity timeline (user journey) for one session.

Args: website_id: The website id (from get_websites). start_at: Range start (UTC). end_at: Range end (UTC). session_id: The session to inspect (from get_session_ids).

Semantic search over many user journeys to surface the most relevant moments.

Pulls every session for the range (optionally filtered to selected_event), then returns only the journey chunks most relevant to user_question -- letting you analyze behavior across many users without overflowing the context window.

Requires the optional 'rag' extra; without it, this returns install instructions.

Args: user_question: What you want to learn (used for the similarity search). website_id: The website id (from get_websites). start_at: Range start (UTC). end_at: Range end (UTC). selected_event: Optional event name to filter sessions by.

Fetch the raw HTML of a live web page (HTTP GET, no JavaScript execution).

Useful for giving the model the structure/markup of a page you're analyzing.

Args: url: Full URL including scheme, e.g. 'https://example.com/pricing'.

Capture a rendered screenshot of a live web page.

Requires the optional 'screenshot' extra (Playwright); without it, this returns install instructions instead of an image.

Args: url: Full URL including scheme, e.g. 'https://example.com'.