plausible_query
Query analytics data from Plausible
LABSCO SUMMARY
One query tool, and that is enough for most analytics questions.
Plausible's own API is one endpoint that takes a site, a metric list and a date range, so wrapping it as one tool is the honest shape rather than a shortcut — the flexibility is in the arguments. Because PLAUSIBLE_API_URL is configurable, the same server points at a self-hosted instance without a code change. Note that it reads: nothing here writes goals, sites or events.
What it is
An MCP server over the Plausible Analytics v2 API. It exposes Plausible's query endpoint as a single tool, so an assistant can pull visitor and pageview figures for a domain over a period without opening the dashboard.
What you get
- An analytics query against a site you own, taking the domain as
site_id, a list of metrics such as visitors or pageviews, and a date range such as7dor30d—plausible_query - All three arguments required, so a query is unambiguous about which site, which numbers and which period it is asking for
Requirements
A Plausible account and an API key, supplied as PLAUSIBLE_API_KEY — the server refuses to start without it. PLAUSIBLE_API_URL points at the API and defaults to Plausible's hosted v2 endpoint, so set it if you run Plausible yourself. It is not on npm (package.json names it plausible-model-context-protocol-server, 0.0.1); build it from a clone and point your client at dist/index.js.
Setup effort
Build from source — git clone https://github.com/AVIMBU/plausible-mcp-server
USE CASES
01
Getting a daily overview without opening the dashboard
Ask for visitors and pageviews on your domain over the last day and read the answer in the conversation you were already in.
02
Comparing two periods
Run the same metrics over a 7-day and a 30-day range and let the model do the comparison rather than reading two charts.
03
Pulling numbers into a report you are writing
Query the metrics you need mid-draft, so the figures in the document come from the API rather than from memory.
04
Reading a self-hosted Plausible
Point the API URL at your own instance and use the same tool, keeping analytics data on infrastructure you control.
1 tool
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool when we connected.
Requires
- Node.js
- npm on PATH
- PLAUSIBLE_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the one tool definition that rides along on every turn
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/AVIMBU/plausible-mcp-server
cd plausible-mcp-server
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mcp-plausible-local": {
"command": "node",
"args": [
"<YOUR_PATH_TO_PROJECT>/dist/index.js"
],
"env": {
"PLAUSIBLE_API_URL": "https://plausible.io/api/v2",
"PLAUSIBLE_API_KEY": "<YOUR_PLAUSIBLE_API_KEY>"
}
}
}
}
