Umami Is Live in Cogny: Privacy-First Analytics Your Agent Can Read and Annotate
Umami is the analytics many teams pick when they want simple, cookie-free numbers they own, on Umami Cloud or on their own server. Until now the agent that reads your ad accounts and Search Console couldn't see what those visitors did on your site.
Umami is now a live MCP integration in Cogny, for Umami Cloud and self-hosted Umami. Your Umami address and an API key, and the agent reads traffic, pages, referrers, channels, UTM campaigns, custom events, goals and who is on the site right now, for every website the key can see. It can also write the two things that make next month's analysis easier: an annotation on the day a campaign launched, and a saved goal for a new thank-you page.
TL;DR
- Umami is live now, on every Cogny plan. Connect it from your workspace Settings → Integrations.
- Umami Cloud and self-hosted Umami 3.4 or later. Both connect with an API key from Umami → Settings → API keys.
- 18 tools: 13 that read and 5 that write.
- Reports:
aggregate,timeseries,breakdown,get_event_stats,event_timeseries,list_events,get_goal_conversions,realtime_visitors,get_realtime. - Writes: create, edit and delete annotations; create and edit saved goals.
- The key acts as the Umami user it belongs to, so Cogny sees the websites that user and their teams see.
What you can do with it
| Tool | What your agent can do |
|---|---|
list_websites, get_website | List your websites with their ids and domains |
aggregate | Pageviews, visitors, visits, bounce rate and average visit duration for a period, next to the period before or the same period last year |
timeseries | Pageviews and visits per hour, day or month |
breakdown | Top pages, entry and exit pages, referrers, channels, countries, cities, devices, browsers, languages and UTM sources, mediums and campaigns |
get_event_stats, event_timeseries, list_events | Custom event totals, events per day per event name, and the latest pageviews and events |
list_goals, get_goal_conversions | Saved goals, and how many visitors converted on a goal or on any page or event you name |
realtime_visitors, get_realtime | Who is on the site now, and the last 30 minutes of pages, referrers and countries |
list_annotations, create_annotation, update_annotation, delete_annotation | Dated notes on Umami's charts |
create_goal, update_goal | Goals that count a page view or a custom event as a conversion |
The reports take a date range, a timezone and optional filters, so the agent can ask the same question about one slice of traffic: only visitors from the newsletter, only Sweden, only the pricing page.
The tool names match the ones the Plausible integration uses (aggregate, timeseries, breakdown, realtime_visitors), so an agent that already knows one privacy analytics tool in Cogny knows this one.
Some things to ask:
- "Compare last week's visitors and bounce rate with the week before, and tell me which channels moved."
- "Which UTM campaigns sent the most visitors in October, and how many of them fired the signup event?"
- "How many visitors reached /thank-you last month, and what was the conversion rate for visitors from Google?"
- "We launched the spring sale today. Add an annotation so it shows on the charts."
- "Save a goal called Demo booked for the demo_booked event."
How to connect it
- In Umami, open Settings → API keys and click Create key.
- Copy the key. A self-hosted Umami shows it only once.
- In Cogny, open Settings → Integrations, click Connect on Umami and enter:
- Your Umami address:
https://cloud.umami.isfor Umami Cloud, or the address you open your own Umami at - The API key
- Your Umami address:
The key is stored encrypted and is only ever sent to your own Umami. Delete the key in Umami, or disconnect in Cogny, at any time.
A self-hosted Umami needs version 3.4 or later, the first with API keys, and has to be reachable from the internet over https.
What the write tools change
- Annotations are notes on a date, visible to everyone who can see the website in Umami. A chart with "pricing page redesigned" on it explains itself next quarter. Deleting one can't be undone.
- Saved goals count a page view or a custom event as a conversion. Editing a goal changes what it counts from then on in every report that uses it.
Both need edit rights on the website. In the Cogny app, write tools ask first by default, so a person approves each one. When your own AI client calls a tool over MCP, your client is the approval step, so keep write tools set to ask every time there.
What it does not cover yet
Sessions and visitor journeys, funnels, retention, attribution, revenue, heatmaps, session replays and custom event properties have no tools today. Goals can't be deleted, and websites, teams and share links can't be changed from Cogny. The full tool list, with what each tool reads or changes, is on the Umami tools page. If you need one of the missing pieces, ask your agent to request it: it can file the request itself from inside Cogny.
Umami next to your ad platforms and Search Console, in one conversation, turns "traffic was up" into "this campaign sent these visitors and they signed up". Connect Umami from your Cogny dashboard and ask your first question.