Provides tools for querying traffic, conversions, sources, device breakdowns, real-time visitors, and other analytics from Plausible Analytics, supporting various metrics, dimensions, filters, and date ranges.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@plausible-mcp-server top traffic sources for this month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for Plausible Analytics — privacy-friendly web analytics. Query traffic, conversions, sources, and device breakdowns from any MCP-compatible AI assistant.
Flexible stats queries — metrics, dimensions, filters, date ranges
Real-time visitors — live visitor count
Traffic breakdowns — sources, countries, browsers, UTM campaigns
Time-series data — daily, weekly, monthly, hourly intervals
Custom events — event tracking and conversion rates
Entry/exit pages — where visitors land and leave
Device analytics — browser, OS, screen size breakdowns
Goal tracking — conversion stats for all configured goals
Site management — list and inspect sites
Related MCP server: plausible-mcp
Tool | Description |
| Full flexible stats query (the main endpoint) |
| Current real-time visitor count |
| Breakdown by any dimension (source, page, country, etc.) |
| Metrics over time with configurable intervals |
| List all sites in your account |
| Get site details |
| Custom event breakdown |
| Top landing pages |
| Top exit pages |
| UTM campaign/source/medium breakdowns |
| Browser, OS, screen size breakdowns |
| Conversion stats for all goals |
A Plausible Analytics account (cloud or self-hosted)
An API key — generate one at Site Settings → API Keys in your Plausible dashboard
Add to your MCP client config (e.g. Claude Desktop, Cursor):
{
"mcpServers": {
"plausible": {
"command": "node",
"args": ["/path/to/plausible-mcp-server/dist/index.js"],
"env": {
"PLAUSIBLE_API_KEY": "your-api-key-here"
}
}
}
}For self-hosted Plausible, also set:
"env": {
"PLAUSIBLE_API_KEY": "your-api-key",
"PLAUSIBLE_API_BASE": "https://your-plausible-instance.com"
}git clone https://github.com/friendlygeorge/plausible-mcp-server.git
cd plausible-mcp-server
npm install
npx tscOnce configured, ask your AI assistant:
"Show me the top traffic sources for my site this month"
"How many visitors did I get today?"
"What's the time-series of pageviews for the last 30 days?"
"Which pages have the highest bounce rate?"
"Show me UTM campaign performance"
"What are my top entry pages?"
"Show conversion rates for all goals"
"Break down visitors by country for the last week"
Variable | Required | Default | Description |
| Yes | — | Your Plausible API key |
| No |
| API base URL (change for self-hosted) |
visitors, visits, pageviews, views_per_visit, visit_duration, events, bounce_rate, scroll_depth, conversion_rate
visit:source, visit:referrer, visit:utm_source, visit:utm_medium, visit:utm_campaign, visit:utm_content, visit:utm_term, visit:country_name, visit:city_name, visit:screen, visit:browser, visit:browser_version, visit:os, visit:os_version, visit:entry_page, visit:exit_page, event:page, event:name, event:goal, event:props:<key>
MIT
Get a breakdown of visitors by a specific dimension (top sources, pages, countries, browsers, etc.).
Inputs: site_id (required), property (required), date_range (required), limit, +1 more.
Get custom event breakdown — see which events fire most, conversion rates, and revenue.
Inputs: site_id (required), date_range (required), filters.
Get breakdown by device type, browser, OS, and screen size.
Inputs: site_id (required), date_range (required), dimension.
Get top entry pages — where visitors land on your site.
Inputs: site_id (required), date_range (required), limit.
Get top exit pages — where visitors leave your site.
Inputs: site_id (required), date_range (required), limit.
Get conversion stats for all configured goals on a site.
Inputs: site_id (required), date_range (required).
Get detailed information about a specific site.
Inputs: site_id (required).
Get time-series data for one or more metrics — daily, hourly, weekly, or monthly intervals.
Inputs: metrics (required), site_id (required), date_range (required), filters, +1 more.
Get UTM campaign, source, and medium breakdowns — see which campaigns drive traffic.
Inputs: site_id (required), date_range (required), dimension.
List all sites in your Plausible account.
Inputs: no named parameters.
Query Plausible analytics with full flexibility — metrics, dimensions, filters, date ranges. The main stats endpoint.
Inputs: metrics (required), site_id (required), date_range (required), limit, +4 more.
Get the current number of real-time visitors on a site.
Inputs: site_id (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 12 tools
Most tools have clearly distinct purposes (e.g., realtime_visitors, list_sites, get_utm_stats). However, query_stats is a flexible endpoint that could overlap with specialized tools like get_breakdown or get_timeseries, potentially causing confusion.
The majority use a get_* pattern, but query_stats and realtime_visitors deviate. The mix of verb-based and descriptive names is inconsistent but still readable.
12 tools cover the Plausible analytics domain well—neither too few nor too many. Each tool serves a distinct purpose without redundancy.
The tool set covers all major analytics dimensions (traffic, sources, pages, devices, goals, UTM). A minor gap is the lack of site CRUD, but this server focuses on querying, not management.
Clamp Analytics MCP server: traffic, revenue, funnels, cohorts, errors, and search, for AI agents.
Read-only Google Analytics 4 MCP server for AI assistants.
Hosted MCP server for marketing agencies: connect Google Ads, GA4, Search Console, Meta, LinkedIn and more to Claude or ChatGPT. Pull reports and make changes via OAuth login, no setup.
