Skip to main content
Glama
Plausible MCP

Plausible MCP

by The-Focus-AI

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 install

Configuration

You've got two ways to handle your Plausible API key — choose what works for you:

  1. Create a .env file:

PLAUSIBLE_API_KEY=your_api_key_here
PLAUSIBLE_API_URL=https://plausible.io/api/v2
  1. Or 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 loads

  • bounce_rate - One-and-done visits

  • visit_duration - How long people stick around

  • views_per_visit - Pages per session

  • And 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 start

Rate 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 tools
analyze_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:

  1. Most visited pages in last 7 days: {"site_id": "example.com", "metrics": ["visitors", "pageviews"], "dimensions": ["event:page"], "date_range": "7d"}

  2. Traffic sources with bounce rates: {"site_id": "example.com", "metrics": ["visitors", "bounce_rate"], "dimensions": ["visit:source"], "date_range": "30d"}

  3. Geographic breakdown: {"site_id": "example.com", "metrics": ["visitors", "visit_duration"], "dimensions": ["visit:country", "visit:city"], "date_range": "month"}

  4. Hourly visitor trends for today: {"site_id": "example.com", "metrics": ["visitors", "pageviews"], "dimensions": ["time:hour"], "date_range": "day"}

  5. Device and browser analysis: {"site_id": "example.com", "metrics": ["visitors", "bounce_rate"], "dimensions": ["visit:device", "visit:browser"], "date_range": "7d"}

  6. 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:

  1. Only Chrome users: {"filters": [["is", "visit:browser", ["Chrome"]]]}

  2. Blog pages only: {"filters": [["contains", "event:page", ["/blog"]]]}

  3. Multiple countries: {"filters": [["is", "visit:country", ["US", "GB", "CA"]]]}

  4. Exclude certain pages: {"filters": [["is_not", "event:page", ["/admin", "/login"]]]}

  5. 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

    B3.3/5.0

    Scored across 4 tools

    Disambiguation2/5

    analyze_page and list_sites are distinct, but get_breakdown and get_traffic both provide site analytics with unclear differentiation, causing potential for confusion.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (e.g., analyze_page, get_breakdown), making naming predictable and clear.

    Tool Count3/5

    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.

    Completeness3/5

    Core analytics queries are covered, but missing functionality like managing goals or real-time data means agents may encounter dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Allows AI models to query and retrieve analytics data from Plausible Analytics through the Plausible API, enabling natural language interactions with website statistics.
      1
      8
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      6
      42 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables querying Plausible Analytics data for website statistics, traffic, engagement, and conversions through natural language, with support for filters, dimensions, and time-series.
      7
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables natural language analytics queries for Pirsch Analytics, providing comprehensive website traffic statistics, period comparisons, and trend analysis through an MCP interface.
      4
      54 npm
      1
      MIT