umami-compass
A secure, read-only MCP server for Umami Analytics 3.2+ — Cloud and self-hosted
Versions
0.5.1latest0.5.00.4.10.4.00.3.1+ show 6 moreshow less
0.3.00.2.00.1.30.1.20.1.10.1.0Tools 42
get_saved_report Get one saved report definition. The website ID is required to enforce the local allowlist and is verified against the response.
list_replays List Umami 3.2 session replay metadata. Successful responses state whether data is available and why an authorized result is empty. Raw rrweb event payloads are intentionally excluded.
resolve_website Resolve a website UUID from a UUID, domain, URL, or website name. Ambiguous matches return bounded candidates instead of guessing.
get_portfolio_overview Summarize bounded aggregate traffic across visible websites, including period changes, growth and decline leaders, stale tracking, failures, and suspicious jumps.
analyze_performance_portfolio Compare Core Web Vitals across a bounded website portfolio with compact-by-default output, metric-specific drill-down selection, confidence, event/pageview ratios, and precise section truncation metadata.
explain_traffic_change Compare traffic with a previous, year-over-year, or custom period and rank observed changes across pages, referrers, countries, devices, channels, and events. Results describe association, not causation.
compare_traffic_series Return aligned current and comparison traffic buckets to locate the exact day or hour when traffic changed.
analyze_release_impact Compare equal pre- and post-release windows across traffic breakdowns and Core Web Vitals. Returns a compact executive summary by default; request full detail for drill-down evidence. Recent releases use a partial post window and an equally shortened pre window.
tracking_health_check Audit visible websites for stale or missing traffic, traffic drops, domain mismatches, referral-spam patterns, custom-event availability, recorder configuration, and section permission failures. Disabled optional features are warnings only when marked as expected.
list_segments List reusable website segments or cohorts from Umami's paged response with explicit context limits.
get_heatmap Get Umami 3.2 click or scroll heatmap data. Successful responses state whether data is available and why an authorized result is empty. Omit urlPath to list pages; provide it for bounded detail.
list_sessions List and search visitor sessions for a website and time range.
get_session_stats Get aggregate session metrics for a website and time range.
get_session Get metadata for one Umami visitor session.
get_session_activity Get a bounded list of pageviews and events that occurred during one session and time range.
get_web_vitals Get normalized Umami 3.2 LCP, INP, CLS, FCP and TTFB summaries plus a bounded series for one metric. Empty data, partial buckets, filter scope and unavailable upstream sample counts are explicit.
get_performance_breakdown Rank Web Vital percentiles by page, page title, device or browser. Rows default to 20 performance events and report the upstream limitation that per-metric non-null counts are unavailable.
compare_web_vitals Compare all five Web Vital p75 summaries against a previous, year-over-year or custom period with ratings, materiality, event-count readiness and explicit filter scope.
compare_performance_breakdown Align page, page-title, device or browser rows across two periods. Comparable rows come first; undersized rows are excluded by default and missing capped candidates remain unknown rather than being treated as zero.
get_performance_cross_tab Derive a bounded two-dimensional performance breakdown through explicit fan-out. Candidate source, request count, sample limitations and truncation are reported so the result is not mistaken for a native exhaustive pivot.
get_route_group_performance Measure caller-defined route templates with exact regex-filtered performance queries instead of attempting to merge non-composable percentiles from individual URLs.
get_server_info Get the local package version, enabled toolsets, safety limits, and supported analysis capabilities without exposing credentials.
list_websites List websites visible directly or through any team membership of the configured Umami identity. If UMAMI_WEBSITE_IDS is set, returns only that exact allowlist.
get_website Get metadata for one website.
get_website_stats Get visits, visitors, pageviews, bounces, visit duration and Umami's comparison values for a time range.
get_pageviews Get Umami 3.2 pageview and session time series. Both arrays are preserved in the response.
get_metrics Get a ranked aggregate Umami metric breakdown such as paths, referrers, countries, devices, events, channels or URLs. Visitor identifiers are excluded from the core toolset.
get_active_visitors Get the current number of active visitors for a website.
get_website_date_range Get the earliest and latest analytics timestamps available for a website.
get_revenue_stats Get Umami 3.2 revenue totals and comparison values in a chosen currency.
get_revenue_metrics Break down Umami 3.2 revenue by country, region, referrer or channel.
list_events List and search custom events for a website and time range.
get_event_stats Get aggregate custom-event statistics and comparison values.
get_event_series Get custom-event counts over time, optionally filtered to a named event.
list_saved_reports List saved report definitions for one website without modifying them.
run_goal_report Calculate an Umami conversion goal for a path or custom event.
run_funnel_report Calculate a 2–8 step Umami funnel. windowMinutes controls the allowed time between consecutive steps.
run_journey_report Calculate the most common 2–7 step user journeys and return a bounded ranking.
run_retention_report Calculate daily Umami cohort retention and return a bounded result set.
run_utm_report Calculate Umami source, medium, campaign, term and content performance with bounded category arrays.
run_attribution_report Calculate first-click or last-click attribution for a conversion path or event with bounded channel arrays.
run_breakdown_report Cross-tabulate up to three Umami dimensions, including derived channel combinations, and return the highest-ranked bounded rows.
Permissions 3
network medium shell high env_vars low