Server data from the Official MCP Registry
Plausible Analytics MCP: privacy-first website stats, real-time visitors, breakdowns, and trends.
About
Plausible Analytics MCP: privacy-first website stats, real-time visitors, breakdowns, and trends.
Security Report
The plausible-mcp server is a read-only Plausible Analytics client that requires a Bearer API key from env or tool argument and uses network access that matches its purpose. The main concerns are default-on anonymous telemetry sent to two third-party gateway URLs with a hardcoded client-side payload, and a dynamic skills fetch from GitHub that loads remote instructions into the model context; neither is malicious on its face but both should be disclosed to users. Low-severity quality issues (broad exception handling, unpinned dependencies, fixed telemetry metadata) do not significantly reduce the score. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.
10 files analyzed · 14 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: PLAUSIBLE_API_KEY
Environment variable: PLAUSIBLE_SITE_ID
Environment variable: PLAUSIBLE_BASE_URL
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-surendranb-plausible-mcp": {
"env": {
"PLAUSIBLE_API_KEY": "your-plausible-api-key-here",
"PLAUSIBLE_SITE_ID": "your-plausible-site-id-here",
"PLAUSIBLE_BASE_URL": "your-plausible-base-url-here"
},
"args": [
"-y",
"plausible-analytics-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
plausible-mcp
Fast, privacy-first Plausible Analytics Model Context Protocol (MCP) server for AI coding agents and LLM harnesses. Works seamlessly with both Plausible Cloud and self-hosted Plausible installations.
Quick Start
Run with uvx (Python)
export PLAUSIBLE_API_KEY="your_api_key_here"
uvx plausible-mcp
Run with npx (Node / npm bridge)
export PLAUSIBLE_API_KEY="your_api_key_here"
npx -y plausible-analytics-mcp
Environment Configuration
| Variable | Description | Default |
|---|---|---|
PLAUSIBLE_API_KEY | Your Plausible Stats/Sites API token | Required (or pass via tool token arg) |
PLAUSIBLE_BASE_URL | Base URL for self-hosted Plausible | https://plausible.io |
DO_NOT_TRACK | Set to 1 to disable anonymous telemetry | 0 |
Getting an API Key
- Log in to Plausible (Cloud or your self-hosted instance).
- Go to Settings (user profile menu) -> API Keys.
- Click + New Key, name it
mcp-agent, and copy the token. - Export as
PLAUSIBLE_API_KEY="your_token".
Available Tools
| Tool | Description |
|---|---|
get_aggregate_stats(site_id, date_range="30d", metrics=None, token=None) | High-level visitor, pageview, bounce rate, and session duration totals |
get_breakdown(site_id, property_name="event:page", date_range="30d", limit=20, token=None) | Segment metrics by pages, traffic sources, countries, browsers, OS, devices |
get_realtime_visitors(site_id, token=None) | Current count of active visitors on the site right now |
get_timeseries(site_id, date_range="30d", interval="date", token=None) | Daily or monthly trendline data points for chart generation |
doctor(token=None) | Test Plausible API connectivity and validate the configured API token |
skills_list() | List dynamic analytics playbooks and methodology guides |
skill_read(name) | Fetch full markdown playbook by name (e.g. plausible-overview, analytics-recipes) |
check_for_updates() | Check PyPI for newer versions and view upgrade commands |
Error Absorption Standard
Errors returned to agents are explicitly classified:
[INPUT_FIXABLE]: Parameter errors (e.g., misspelled site_id, unknown dimension). Fix arguments and retry.[ENVIRONMENT_FIXABLE: STOP & ASK HUMAN]: Missing, expired, or unauthorized API key. Prompt user with guided setup steps.[TRANSIENT]: Upstream rate limits (HTTP 429) or network hiccups. Wait briefly and retry.
MCP Client Setup
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"plausible": {
"command": "uvx",
"args": ["plausible-mcp"],
"env": {
"PLAUSIBLE_API_KEY": "YOUR_PLAUSIBLE_API_KEY"
}
}
}
}
Or using the npm bridge:
{
"mcpServers": {
"plausible": {
"command": "npx",
"args": ["-y", "plausible-analytics-mcp"],
"env": {
"PLAUSIBLE_API_KEY": "YOUR_PLAUSIBLE_API_KEY"
}
}
}
}
License
MIT License. See LICENSE for details.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.