Plausible MCP
Provides secure storage and retrieval of the Plausible API key via 1Password integration, allowing users to manage credentials without exposing them in environment files.
Allows natural language interaction with Plausible Analytics data, enabling queries for traffic, visitors, page views, bounce rates, and more with filtering and breakdowns by dimensions like country, device, and source.
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 What were my most visited pages last week?"
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.
Plausible MCP
Hey there! Let's talk about bringing analytics data right into your conversations — because that's what this project is all about. It's a Model Context Protocol (MCP) server that lets you chat with your Plausible Analytics data as naturally as asking a colleague "how's the website doing?"
The hardest thing about analytics dashboards is that they're stuck in the old paradigm of clicking through filters and dimensions. We're living in the future now — let's make our analytics data as accessible as asking a question.
What's This All About?
This MCP server bridges the gap between Plausible's powerful analytics API and the way we naturally think about our website stats. Want to know your most visited pages? Or where your traffic is coming from? Just ask!
Key Features
🤝 Natural interaction with your Plausible Analytics data
📊 Get insights about traffic, visitors, and engagement
🌍 Break down stats by country, device, or any dimension you care about
🔒 Secure API key handling with 1Password integration
🎯 Type-safe implementation with TypeScript and Zod
Related MCP server: Plausible Analytics MCP Server
Real-World Examples
Here's what you can do — and yes, these are actual queries that work:
# Basic Questions
> What were my most visited pages last week?
{
"site_id": "example.com",
"metrics": ["pageviews"],
"dimensions": ["event:page"],
"date_range": "7d",
"limit": 10
}
> Where's my traffic coming from?
{
"site_id": "example.com",
"metrics": ["visitors"],
"dimensions": ["visit:source"],
"date_range": "30d"
}
> Show me visitor trends by country
{
"site_id": "example.com",
"metrics": ["visitors"],
"dimensions": ["visit:country"],
"date_range": "month"
}
# Content Performance
> Which blog posts have the highest bounce rate?
{
"site_id": "example.com",
"metrics": ["bounce_rate"],
"dimensions": ["event:page"],
"filters": [["contains", "event:page", ["/blog"]]],
"date_range": "30d"
}
> What's the average time spent on documentation pages?
{
"site_id": "example.com",
"metrics": ["visit_duration"],
"dimensions": ["event:page"],
"filters": [["contains", "event:page", ["/docs"]]],
"date_range": "7d"
}
# Traffic Analysis
> Show me mobile vs desktop traffic trends
{
"site_id": "example.com",
"metrics": ["visitors", "pageviews"],
"dimensions": ["visit:device"],
"date_range": "30d"
}
> Which browsers do my visitors use?
{
"site_id": "example.com",
"metrics": ["visitors"],
"dimensions": ["visit:browser"],
"date_range": "30d"
}
# Marketing Insights
> How's our social media traffic performing?
{
"site_id": "example.com",
"metrics": ["visitors", "bounce_rate"],
"dimensions": ["visit:source"],
"filters": [["is", "visit:source", ["Twitter", "LinkedIn", "Facebook"]]],
"date_range": "30d"
}
> Which UTM campaigns are driving the most engagement?
{
"site_id": "example.com",
"metrics": ["visitors", "visit_duration"],
"dimensions": ["visit:utm_campaign"],
"date_range": "month"
}
# Geographic Analysis
> Show me traffic from European cities
{
"site_id": "example.com",
"metrics": ["visitors"],
"dimensions": ["visit:city"],
"filters": [["is", "visit:country", ["GB", "DE", "FR", "ES", "IT"]]],
"date_range": "30d"
}
# Time-Based Analysis
> How does traffic vary throughout the day?
{
"site_id": "example.com",
"metrics": ["visitors"],
"dimensions": ["hour"],
"date_range": "day"
}
# Complex Queries
> Show me popular blog posts from mobile users in the US
{
"site_id": "example.com",
"metrics": ["pageviews", "visit_duration"],
"dimensions": ["event:page"],
"filters": [["and", [
["contains", "event:page", ["/blog"]],
["is", "visit:device", ["mobile"]],
["is", "visit:country", ["US"]]
]]],
"date_range": "30d"
}
> Which pages have high engagement from social media?
{
"site_id": "example.com",
"metrics": ["visit_duration", "views_per_visit"],
"dimensions": ["event:page"],
"filters": [["is", "visit:source", ["Twitter", "LinkedIn", "Facebook"]]],
"date_range": "30d"
}These examples just scratch the surface — you can combine metrics, dimensions, and filters in countless ways to get exactly the insights you need. The beauty is in how natural it feels to ask these questions and get immediate answers.
Getting Started
First things first, let's get you set up:
pnpm installConfiguration
You've got two ways to handle your Plausible API key — choose what works for you:
Create a
.envfile:
PLAUSIBLE_API_KEY=your_api_key_here
PLAUSIBLE_API_URL=https://plausible.io/api/v2Or use 1Password (my preferred way): Store your key at "op://Development/plausible api/notesPlain"
The Tools at Your Disposal
list_sites
Gets you a list of all your Plausible sites. Simple but useful when you're just getting started.
get_breakdown
This is where the magic happens. Think of it as your analytics Swiss Army knife:
Metrics You Can Track
visitors- Unique visitors (the real people)pageviews- Total page loadsbounce_rate- One-and-done visitsvisit_duration- How long people stick aroundviews_per_visit- Pages per sessionAnd more!
Ways to Slice the Data
Break it down by:
Pages (
event:page)Traffic sources (
visit:source)Countries (
visit:country)Devices (
visit:device)Time periods (minute, hour, day, week, month)
Time Ranges
Look at:
Last 24 hours (
day)Last N days (
7d,30d)This month (
month)Last N months (
6mo,12mo)Custom date ranges
Smart Filtering
Filter your data like a pro:
// Just Chrome users
{"filters": [["is", "visit:browser", ["Chrome"]]]}
// Blog traffic only
{"filters": [["contains", "event:page", ["/blog"]]]}
// Traffic from specific countries
{"filters": [["is", "visit:country", ["US", "GB", "CA"]]]}
// Complex stuff - Chrome users from the US
{"filters": [["and", [
["is", "visit:browser", ["Chrome"]],
["is", "visit:country", ["US"]]
]]]}What's Next?
We're pushing this to the next level. On the roadmap:
Even smarter query handling
Better response formatting
More examples of common analytics questions
Comprehensive error handling
Performance optimizations
Development
Jump in and help us figure it out:
# Build it
pnpm build
# Run it
pnpm startRate Limits & Performance
600 requests per hour (that's the Plausible limit)
Real-time data, no caching
Snappy response times
License
MIT - because sharing is caring!
The analytics world is transforming from dashboards and SQL queries to natural conversations about your data. We're figuring it out as we go, but that's what makes it exciting. Let's make analytics as accessible as asking a question — because that's where this is all heading.
Available Tools
4 toolsanalyze_pageC
Get detailed analytics for a specific page
Inputs: site_id (required), page (required), timeRange (required), include.
get_breakdownA
Get detailed analytics breakdown for a site.
COMMON QUERIES:
Most visited pages in last 7 days: {"site_id": "example.com", "metrics": ["visitors", "pageviews"], "dimensions": ["event:page"], "date_range": "7d"}
Traffic sources with bounce rates: {"site_id": "example.com", "metrics": ["visitors", "bounce_rate"], "dimensions": ["visit:source"], "date_range": "30d"}
Geographic breakdown: {"site_id": "example.com", "metrics": ["visitors", "visit_duration"], "dimensions": ["visit:country", "visit:city"], "date_range": "month"}
Hourly visitor trends for today: {"site_id": "example.com", "metrics": ["visitors", "pageviews"], "dimensions": ["time:hour"], "date_range": "day"}
Device and browser analysis: {"site_id": "example.com", "metrics": ["visitors", "bounce_rate"], "dimensions": ["visit:device", "visit:browser"], "date_range": "7d"}
Campaign performance: {"site_id": "example.com", "metrics": ["visitors", "views_per_visit"], "dimensions": ["visit:utm_campaign", "visit:utm_source"], "date_range": "month"}
AVAILABLE METRICS:
visitors: Number of unique visitors
visits: Number of visits/sessions
pageviews: Number of pageview events
views_per_visit: Average number of pages viewed per visit
bounce_rate: Percentage of visits with only one page view
visit_duration: Average visit duration in seconds
events: Total number of events (pageviews + custom events)
AVAILABLE DIMENSIONS: Event dimensions (page/content related):
event:name - Event name (e.g., 'pageview', 'download', etc.)
event:page - Full page URL including UTM parameters
event:page.pathname - Page path without query parameters
event:props:* - Custom event properties (e.g., event:props:author)
Visit dimensions (visitor/session related):
visit:source - Traffic source (e.g., 'Google', 'Twitter')
visit:referrer - Full referrer URL
visit:utm_medium - Marketing medium (e.g., 'cpc', 'social')
visit:utm_source - UTM source parameter
visit:utm_campaign - UTM campaign name
visit:utm_content - UTM content parameter
visit:utm_term - UTM term parameter
visit:device - Device type (desktop, mobile, tablet)
visit:browser - Browser name
visit:browser_version - Browser version
visit:os - Operating system
visit:os_version - OS version
visit:country - Country of visitor
visit:country_name - Full country name
visit:region - Region/state of visitor
visit:region_name - Full region/state name
visit:city - City of visitor
visit:city_name - Full city name
Time dimensions (for trends and patterns):
time:minute - Group by minute (only available with 'day' time:day range)
time:hour - Group by hour (only available with 'day' time:day range)
time:day - Group by day (available with any time:day range)
time:week - Group by week (available with 'month', '6mo', '12mo', or custom ranges)
time:month - Group by month (available with '6mo', '12mo', or custom ranges)
Note: Time dimensions are mutually exclusive - only one can be used at a time. When using time dimensions, results are automatically sorted chronologically.
FILTERING EXAMPLES:
Only Chrome users: {"filters": [["is", "visit:browser", ["Chrome"]]]}
Blog pages only: {"filters": [["contains", "event:page", ["/blog"]]]}
Multiple countries: {"filters": [["is", "visit:country", ["US", "GB", "CA"]]]}
Exclude certain pages: {"filters": [["is_not", "event:page", ["/admin", "/login"]]]}
Complex filter (Chrome users from US): {"filters": [["and", [["is", "visit:browser", ["Chrome"]], ["is", "visit:country", ["US"]]]]]}
Inputs: site_id (required), metrics, dimensions, date_range, +3 more.
get_trafficB
Get traffic analytics for a site using structured parameters
Inputs: site_id (required), time_range, metrics, dimensions, +1 more.
list_sitesA
List all sites in your Plausible account
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
analyze_page and list_sites are distinct, but get_breakdown and get_traffic both provide site analytics with unclear differentiation, causing potential for confusion.
All tools follow a consistent verb_noun pattern (e.g., analyze_page, get_breakdown), making naming predictable and clear.
4 tools is slightly thin for an analytics server; while it covers basic operations, two overlapping tools suggest the count could be reduced or expanded.
Core analytics queries are covered, but missing functionality like managing goals or real-time data means agents may encounter dead ends.
Maintenance
Related MCP Connectors
Ask your website analytics in plain language and set up funnels, features and dashboards.
Query site stats, realtime visitors, breakdowns and goals from Plausible Analytics.
Ask your web and product analytics: traffic, funnels, goals, revenue and sessions.
Connect Google Analytics to ChatGPT. Query GA4 data in plain English and get instant insights.
Related MCP Servers
- AlicenseBqualityDmaintenanceAllows AI models to query and retrieve analytics data from Plausible Analytics through the Plausible API, enabling natural language interactions with website statistics.18MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to query website statistics from Plausible Analytics, providing access to metrics like real-time visitors, traffic trends, and page performance. It supports both Plausible Cloud and self-hosted instances through the Stats API v2.642 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying Plausible Analytics data for website statistics, traffic, engagement, and conversions through natural language, with support for filters, dimensions, and time-series.7MIT
- AlicenseAqualityBmaintenanceEnables natural language analytics queries for Pirsch Analytics, providing comprehensive website traffic statistics, period comparisons, and trend analysis through an MCP interface.454 npm1MIT