Plausible Analytics MCP Server
A Model Context Protocol server for Plausible Analytics, built first for self-hosted Plausible Community Edition and fully compatible with Plausible Cloud. It lets AI assistants like Claude answer questions about your sites in plain English: a one-call site overview, totals and trends over time, top pages, sources, countries and devices, goal conversions, side-by-side period comparisons (which the Plausible API does not offer on its own) and realtime visitors, plus a raw Stats API v2 tool for anything custom. Connections are read-only by default, and with a per-site Plugin Token you can also manage goals, shared links and custom properties. Your Plausible URL and API key are stored in the MCP Key Service instead of your client config.
Base endpoint (requires API key):
https://mcp.techmavie.digital/plausibleanalytics/mcpNeed help setting up? Follow the official setup guides:
Features
Works with self-hosted Plausible Community Edition and Plausible Cloud
One-call site overview: key metrics with the change vs the previous period, plus top pages, sources, countries, devices and goals
Period comparisons (previous period or year over year) for totals or row by row, e.g. top pages this month vs last month
Breakdowns by page, entry/exit page, source, channel, UTM tags, country, device, browser, OS or custom properties, with simple filters
Timeseries by hour, day, week or month, with empty days filled in
Goal conversions and conversion rates, optionally broken down by source, page or country
Realtime visitors plus the last few minutes of top pages and sources
Raw Stats API v2 queries for nested, behavioural (has_done) and segment filters
Optional goal, shared-link, custom-property and tracker-script management with per-site Plugin Tokens
Read-only by default: write tools only appear when you opt in, and deletes need explicit confirmation
Available Tools
hello / get_instance_infoConnection check and diagnostics: version, health, API key and supported metrics
list_sitesSites on your connection (Sites API on Plausible Cloud)
get_site_overviewOne-call dashboard with changes vs the previous period
get_aggregate_statsTotals for any date range, optionally compared
get_timeseriesMetrics over time by hour, day, week or month
get_breakdownTop values of any dimension, with filters and pagination
get_goal_conversionsGoal conversions and conversion rates
compare_periodsTwo periods side by side with % change
get_realtime_visitorsCurrent visitors and recent activity
query_statsFull Stats API v2 query for anything custom
list_goals / create_goal / delete_goalManage goals (Plugin Token or Plausible Cloud)
list_shared_links / create_shared_linkShared dashboard links
enable_custom_property / disable_custom_propertyCustom property allow-list
get_tracker_config / update_tracker_configTracker script options
get_site / create_site / update_site / delete_site / list_custom_propertiesSite admin (Plausible Cloud only)
send_eventRecord a test pageview or custom event (opt-in)
Highlights
Requirements
- MCP Key Service API key (register at mcpkeys.techmavie.digital)
- Plausible Stats API key and your instance URL (registered via MCP Key Service)
- Self-hosted: Plausible Community Edition v2.1.2 or newer (v3.0+ recommended)
- Optional: per-site Plugin Tokens for goal, shared-link and custom-property management