Umami Compass
Secure Umami Analytics MCP server for Cloud and self-hosted deployments
Connector by webcredo · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/webcredo-umami-compass
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 42 read · 0 write · 0 deleteRead-only
- Secrets
- 3 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Node.js package
Tools by what they do 42
Read from the source code; the running server may list different tools.
Read 42 · Look things up without changing anything.
analyze_performance_portfolioanalyze_release_impactcompare_performance_breakdowncompare_traffic_seriescompare_web_vitalsexplain_traffic_changeget_active_visitorsget_event_seriesget_event_statsget_heatmapget_metricsget_pageviews
Show 30 more tools
get_performance_breakdownget_performance_cross_tabget_portfolio_overviewget_revenue_metricsget_revenue_statsget_route_group_performanceget_saved_reportget_server_infoget_sessionget_session_activityget_session_statsget_web_vitalsget_websiteget_website_date_rangeget_website_statslist_eventslist_replayslist_saved_reportslist_segmentslist_sessionslist_websitesresolve_websiterun_attribution_reportrun_breakdown_reportrun_funnel_reportrun_goal_reportrun_journey_reportrun_retention_reportrun_utm_reporttracking_health_check
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
UMAMI_ACCESS_TOKENUMAMI_API_KEYUMAMI_PASSWORD
Other settings (environment variables or headers).
UMAMI_API_URLUMAMI_MAX_RESPONSE_BYTESUMAMI_TEAM_IDSUMAMI_TOOLSETSUMAMI_URLUMAMI_USERNAMEUMAMI_WEBSITE_IDS
Tools (42)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
analyze_performance_portfolioAnalyze portfolio performanceread-onlyCompare 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.
analyze_release_impactAnalyze release impactread-onlyCompare 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.
compare_performance_breakdownCompare a Web Vital breakdownread-onlyAlign 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.
compare_traffic_seriesCompare traffic time seriesread-onlyReturn aligned current and comparison traffic buckets to locate the exact day or hour when traffic changed.
compare_web_vitalsCompare Core Web Vitals periodsread-onlyCompare 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.
explain_traffic_changeExplain a traffic changeread-onlyCompare 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.
get_active_visitorsGet active visitorsread-onlyGet the current number of active visitors for a website.
get_event_seriesGet event time seriesread-onlyGet custom-event counts over time, optionally filtered to a named event.
get_event_statsGet event statisticsread-onlyGet aggregate custom-event statistics and comparison values.
get_heatmapGet an Umami heatmapread-onlyGet 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.
get_metricsBreak down website metricsread-onlyGet 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_pageviewsGet pageview and session seriesread-onlyGet Umami 3.2 pageview and session time series. Both arrays are preserved in the response.
get_performance_breakdownBreak down Core Web Vitalsread-onlyRank 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.
get_performance_cross_tabCross-tabulate Web Vitalsread-onlyDerive 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_portfolio_overviewGet a portfolio analytics overviewread-onlySummarize bounded aggregate traffic across visible websites, including period changes, growth and decline leaders, stale tracking, failures, and suspicious jumps.
Show 27 more tools
get_revenue_metricsBreak down revenue metricsread-onlyBreak down Umami 3.2 revenue by country, region, referrer or channel.
get_revenue_statsGet revenue statisticsread-onlyGet Umami 3.2 revenue totals and comparison values in a chosen currency.
get_route_group_performanceAnalyze route-group performanceread-onlyMeasure caller-defined route templates with exact regex-filtered performance queries instead of attempting to merge non-composable percentiles from individual URLs.
get_saved_reportGet a saved Umami reportread-onlyGet one saved report definition. The website ID is required to enforce the local allowlist and is verified against the response.
get_server_infoGet Umami Compass server informationread-onlyGet the local package version, enabled toolsets, safety limits, and supported analysis capabilities without exposing credentials.
get_sessionGet a sessionread-onlyGet metadata for one Umami visitor session.
get_session_activityGet session activityread-onlyGet a bounded list of pageviews and events that occurred during one session and time range.
get_session_statsGet session statisticsread-onlyGet aggregate session metrics for a website and time range.
get_web_vitalsGet Core Web Vitalsread-onlyGet 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_websiteGet an Umami websiteread-onlyGet metadata for one website.
get_website_date_rangeGet website data rangeread-onlyGet the earliest and latest analytics timestamps available for a website.
get_website_statsGet website statisticsread-onlyGet visits, visitors, pageviews, bounces, visit duration and Umami's comparison values for a time range.
list_eventsList Umami eventsread-onlyList and search custom events for a website and time range.
list_replaysList session replay metadataread-onlyList 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.
list_saved_reportsList saved Umami reportsread-onlyList saved report definitions for one website without modifying them.
list_segmentsList Umami segments or cohortsread-onlyList reusable website segments or cohorts from Umami's paged response with explicit context limits.
list_sessionsList Umami sessionsread-onlyList and search visitor sessions for a website and time range.
list_websitesList Umami websitesread-onlyList websites visible directly or through any team membership of the configured Umami identity. If UMAMI_WEBSITE_IDS is set, returns only that exact allowlist.
resolve_websiteResolve an Umami websiteread-onlyResolve a website UUID from a UUID, domain, URL, or website name. Ambiguous matches return bounded candidates instead of guessing.
run_attribution_reportRun an attribution reportread-onlyCalculate first-click or last-click attribution for a conversion path or event with bounded channel arrays.
run_breakdown_reportRun a multi-field breakdownread-onlyCross-tabulate up to three Umami dimensions, including derived channel combinations, and return the highest-ranked bounded rows.
run_funnel_reportRun a funnel reportread-onlyCalculate a 2–8 step Umami funnel. windowMinutes controls the allowed time between consecutive steps.
run_goal_reportRun a goal reportread-onlyCalculate an Umami conversion goal for a path or custom event.
run_journey_reportRun a journey reportread-onlyCalculate the most common 2–7 step user journeys and return a bounded ranking.
run_retention_reportRun a retention reportread-onlyCalculate daily Umami cohort retention and return a bounded result set.
run_utm_reportRun a UTM reportread-onlyCalculate Umami source, medium, campaign, term and content performance with bounded category arrays.
tracking_health_checkCheck analytics tracking healthread-onlyAudit 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.
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Last commit
- Sep 17, 2026 (1 month ago)
- Last release
- Jul 21, 2026 (3 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.webcredo/umami-compass- Version
- 0.5.1
- Auth
- API key
- Packages
- npm umami-compass
- License
- MIT
- Repository
- github.com/webcredo/umami-compass
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Umami Compass MCP server. Agent Mart. https://agentmart.dev/connectors/webcredo-umami-compass (last updated 2026-10-24)