plausible-mcp-server

Plausible Analytics MCP Server

MCP server for Plausible Analytics — privacy-friendly web analytics. Query traffic, conversions, sources, and device breakdowns from any MCP-compatible AI assistant.

Features

• 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

12 Tools

| Tool | Description | |------|-------------| | query_stats | Full flexible stats query (the main endpoint) | | realtime_visitors | Current real-time visitor count | | get_breakdown | Breakdown by any dimension (source, page, country, etc.) | | get_timeseries | Metrics over time with configurable intervals | | list_sites | List all sites in your account | | get_site | Get site details | | get_custom_events | Custom event breakdown | | get_entry_pages | Top landing pages | | get_exit_pages | Top exit pages | | get_utm_stats | UTM campaign/source/medium breakdowns | | get_device_stats | Browser, OS, screen size breakdowns | | get_goals | Conversion stats for all goals |

Setup

Prerequisites

1. A Plausible Analytics account (cloud or self-hosted)
2. An API key — generate one at Site Settings → API Keys in your Plausible dashboard

Configuration

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"
}

Build from source

git clone https://github.com/friendlygeorge/plausible-mcp-server.git
cd plausible-mcp-server
npm install
npx tsc

Usage Examples

Once 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"

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | PLAUSIBLE_API_KEY | Yes | — | Your Plausible API key | | PLAUSIBLE_API_BASE | No | https://plausible.io | API base URL (change for self-hosted) |

Supported Metrics

visitors, visits, pageviews, views_per_visit, visit_duration, events, bounce_rate, scroll_depth, conversion_rate

Supported Dimensions

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>

License

MIT