@icjia/plausible-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PLAUSIBLE_API_KEY | Yes | Your Plausible Stats API key | |
| PLAUSIBLE_BASE_URL | Yes | Your Plausible instance URL (e.g., https://plausible.icjia.cloud) | |
| PLAUSIBLE_DEFAULT_SITE | No | Default site domain so you don't have to specify it every query |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| query_overviewA | Aggregate stats for a site with period-over-period deltas. Answers "How is this site doing?" |
| query_pagesA | Top or bottom pages by traffic. Answers "What pages are popular?" or "What pages get no traffic?" |
| query_breakdownA | Break down traffic by any dimension: source, country, device, browser, OS, UTMs, etc. |
| query_timeseriesC | Trend data over time. Answers "Is traffic going up or down?" |
| list_sitesA | Discover all sites tracked by the Plausible instance. |
| get_statusA | Server info, version, and Plausible instance health check. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: server info, site listing, dimension breakdown, aggregate stats, page rankings, and time trends. No overlap.
All tools follow a consistent verb_noun pattern (get_status, list_sites, query_breakdown, etc.), making the API predictable.
Six tools is appropriate for a Plausible analytics client, covering all essential read operations without excess.
The tool surface covers server health, site listing, and all major query types (dimension breakdown, overview with deltas, pages, timeseries). No obvious gaps for a read-only analytics tool.