Plausible MCP by usefulapi is an MCP server published by io.usefulapi, hosted at plausible-analytics.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 8 tools, including plausible_query_stats, plausible_aggregate, plausible_timeseries, plausible_breakdown, plausible_realtime_visitors.
Query site stats, realtime visitors, breakdowns and goals from Plausible Analytics.
4,123 connections through 5 shared values. Tap any node.
The full-power Stats API query. Compute metrics over a date range, optionally grouped by dimensions and narrowed by filters, with ordering, includes, and pagination. Plausible: POST /api/v2/query.
| Parameter | Type | Description |
|---|---|---|
| filters | array | Optional filters. Each is an array like ["is","visit:country_name",["Estonia"]] or ["contains","event:page",["/blog"]] with logical wrappers ["and",[...]] / ["or",[...]] / ["not",[...]]. Operators: is, is_not, contains, contains_not, matches, matches_not, has_done, has_not_done. |
| include | object | Optional include flags: { imports?, time_labels?, total_rows? }. |
| metrics * | array | Metrics to compute. Any of: visitors, visits, pageviews, views_per_visit, bounce_rate, visit_duration, events, scroll_depth, percentage, conversion_rate, group_conversion_rate, average_revenue, total_revenue, time_on_page. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
| site_id * | string | The site's domain as registered in Plausible, e.g. "example.com". |
| order_by | array | Optional ordering: an array of [metric_or_dimension, "asc"|"desc"] pairs, e.g. [["visitors","desc"]]. |
| date_range * | any | Date range: a shortcut string ("day", "7d", "28d", "30d", "91d", "month", "6mo", "12mo", "year", "all", "24h") OR a 2-element ISO8601 array like ["2024-01-01","2024-07-01"] (dates or datetimes with tz). |
| dimensions | array | Group-by dimensions. Event dims (event:goal, event:page, event:hostname), visit dims (visit:source, visit:referrer, visit:utm_medium/source/campaign, visit:device, visit:browser, visit:os, visit:country/region/city[_name], visit:entry_page, visit:exit_page), time dims (time, time:hour, time:day, tim… |
| pagination | object | Optional pagination: { limit?, offset? }. |
{
"name": "plausible_query_stats",
"title": "Query stats",
"description": "The full-power Stats API query. Compute metrics over a date range, optionally grouped by dimensions and narrowed by filters, with ordering, includes, and pagination. Plausible: POST /api/v2/query.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"metrics",
"date_range"
],
"properties": {
"filters": {
"type": "array",
"items": {
"type": "array",
"items": {}
},
"description": "Optional filters. Each is an array like [\"is\",\"visit:country_name\",[\"Estonia\"]] or [\"contains\",\"event:page\",[\"/blog\"]] with logical wrappers [\"and\",[...]] / [\"or\",[...]] / [\"not\",[...]]. Operators: is, is_not, contains, contains_not, matches, matches_not, has_done, has_not_done."
},
"include": {
"type": "object",
"properties": {
"imports": {
"type": "boolean",
"description": "Include imported (pre-Plausible) stats."
},
"total_rows": {
"type": "boolean",
"description": "Include the total number of rows in meta."
},
"time_labels": {
"type": "boolean",
"description": "Include a full list of time labels for the range."
}
},
"description": "Optional include flags: { imports?, time_labels?, total_rows? }."
},
"metrics": {
"type": "array",
"items": {
"enum": [
"visitors",
"visits",
"pageviews",
"views_per_visit",
"bounce_rate",
"visit_duration",
"events",
"scroll_depth",
"percentage",
"conversion_rate",
"group_conversion_rate",
"average_revenue",
"total_revenue",
"time_on_page"
],
"type": "string"
},
"minItems": 1,
"description": "Metrics to compute. Any of: visitors, visits, pageviews, views_per_visit, bounce_rate, visit_duration, events, scroll_depth, percentage, conversion_rate, group_conversion_rate, average_revenue, total_revenue, time_on_page."
},
"site_id": {
"type": "string",
"description": "The site's domain as registered in Plausible, e.g. \"example.com\"."
},
"order_by": {
"type": "array",
"items": {
"type": "array",
"items": {}
},
"description": "Optional ordering: an array of [metric_or_dimension, \"asc\"|\"desc\"] pairs, e.g. [[\"visitors\",\"desc\"]]."
},
"date_range": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
],
"description": "Date range: a shortcut string (\"day\", \"7d\", \"28d\", \"30d\", \"91d\", \"month\", \"6mo\", \"12mo\", \"year\", \"all\", \"24h\") OR a 2-element ISO8601 array like [\"2024-01-01\",\"2024-07-01\"] (dates or datetimes with tz)."
},
"dimensions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Group-by dimensions. Event dims (event:goal, event:page, event:hostname), visit dims (visit:source, visit:referrer, visit:utm_medium/source/campaign, visit:device, visit:browser, visit:os, visit:country/region/city[_name], visit:entry_page, visit:exit_page), time dims (time, time:hour, time:day, time:week, time:month), or custom props (event:props:<name>). Omit for totals."
},
"pagination": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Rows per page (default 10000)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Row offset (default 0)."
}
},
"description": "Optional pagination: { limit?, offset? }."
}
}
},
"annotations": {
"title": "Query stats",
"readOnlyHint": true
}
}Convenience: aggregate totals for the given metrics over a date range (no group-by). Plausible: POST /api/v2/query with no dimensions.
| Parameter | Type | Description |
|---|---|---|
| filters | array | Optional filters. Each is an array like ["is","visit:country_name",["Estonia"]] or ["contains","event:page",["/blog"]] with logical wrappers ["and",[...]] / ["or",[...]] / ["not",[...]]. Operators: is, is_not, contains, contains_not, matches, matches_not, has_done, has_not_done. |
| metrics * | array | Metrics to compute. Any of: visitors, visits, pageviews, views_per_visit, bounce_rate, visit_duration, events, scroll_depth, percentage, conversion_rate, group_conversion_rate, average_revenue, total_revenue, time_on_page. |
| site_id * | string | The site's domain as registered in Plausible, e.g. "example.com". |
| date_range * | any | Date range: a shortcut string ("day", "7d", "28d", "30d", "91d", "month", "6mo", "12mo", "year", "all", "24h") OR a 2-element ISO8601 array like ["2024-01-01","2024-07-01"] (dates or datetimes with tz). |
{
"name": "plausible_aggregate",
"title": "Aggregate totals",
"description": "Convenience: aggregate totals for the given metrics over a date range (no group-by). Plausible: POST /api/v2/query with no dimensions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"metrics",
"date_range"
],
"properties": {
"filters": {
"type": "array",
"items": {
"type": "array",
"items": {}
},
"description": "Optional filters. Each is an array like [\"is\",\"visit:country_name\",[\"Estonia\"]] or [\"contains\",\"event:page\",[\"/blog\"]] with logical wrappers [\"and\",[...]] / [\"or\",[...]] / [\"not\",[...]]. Operators: is, is_not, contains, contains_not, matches, matches_not, has_done, has_not_done."
},
"metrics": {
"type": "array",
"items": {
"enum": [
"visitors",
"visits",
"pageviews",
"views_per_visit",
"bounce_rate",
"visit_duration",
"events",
"scroll_depth",
"percentage",
"conversion_rate",
"group_conversion_rate",
"average_revenue",
"total_revenue",
"time_on_page"
],
"type": "string"
},
"minItems": 1,
"description": "Metrics to compute. Any of: visitors, visits, pageviews, views_per_visit, bounce_rate, visit_duration, events, scroll_depth, percentage, conversion_rate, group_conversion_rate, average_revenue, total_revenue, time_on_page."
},
"site_id": {
"type": "string",
"description": "The site's domain as registered in Plausible, e.g. \"example.com\"."
},
"date_range": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
],
"description": "Date range: a shortcut string (\"day\", \"7d\", \"28d\", \"30d\", \"91d\", \"month\", \"6mo\", \"12mo\", \"year\", \"all\", \"24h\") OR a 2-element ISO8601 array like [\"2024-01-01\",\"2024-07-01\"] (dates or datetimes with tz)."
}
}
},
"annotations": {
"title": "Aggregate totals",
"readOnlyHint": true
}
}Convenience: metrics over time, grouped by a time interval. Plausible: POST /api/v2/query with dimensions=[interval].
| Parameter | Type | Description |
|---|---|---|
| filters | array | Optional filters. Each is an array like ["is","visit:country_name",["Estonia"]] or ["contains","event:page",["/blog"]] with logical wrappers ["and",[...]] / ["or",[...]] / ["not",[...]]. Operators: is, is_not, contains, contains_not, matches, matches_not, has_done, has_not_done. |
| metrics * | array | Metrics to compute. Any of: visitors, visits, pageviews, views_per_visit, bounce_rate, visit_duration, events, scroll_depth, percentage, conversion_rate, group_conversion_rate, average_revenue, total_revenue, time_on_page. |
| site_id * | string | The site's domain as registered in Plausible, e.g. "example.com". |
| interval | string | Time bucket to group by. Default time:day. |
| date_range * | any | Date range: a shortcut string ("day", "7d", "28d", "30d", "91d", "month", "6mo", "12mo", "year", "all", "24h") OR a 2-element ISO8601 array like ["2024-01-01","2024-07-01"] (dates or datetimes with tz). |
{
"name": "plausible_timeseries",
"title": "Timeseries",
"description": "Convenience: metrics over time, grouped by a time interval. Plausible: POST /api/v2/query with dimensions=[interval].",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"metrics",
"date_range"
],
"properties": {
"filters": {
"type": "array",
"items": {
"type": "array",
"items": {}
},
"description": "Optional filters. Each is an array like [\"is\",\"visit:country_name\",[\"Estonia\"]] or [\"contains\",\"event:page\",[\"/blog\"]] with logical wrappers [\"and\",[...]] / [\"or\",[...]] / [\"not\",[...]]. Operators: is, is_not, contains, contains_not, matches, matches_not, has_done, has_not_done."
},
"metrics": {
"type": "array",
"items": {
"enum": [
"visitors",
"visits",
"pageviews",
"views_per_visit",
"bounce_rate",
"visit_duration",
"events",
"scroll_depth",
"percentage",
"conversion_rate",
"group_conversion_rate",
"average_revenue",
"total_revenue",
"time_on_page"
],
"type": "string"
},
"minItems": 1,
"description": "Metrics to compute. Any of: visitors, visits, pageviews, views_per_visit, bounce_rate, visit_duration, events, scroll_depth, percentage, conversion_rate, group_conversion_rate, average_revenue, total_revenue, time_on_page."
},
"site_id": {
"type": "string",
"description": "The site's domain as registered in Plausible, e.g. \"example.com\"."
},
"interval": {
"enum": [
"time",
"time:hour",
"time:day",
"time:week",
"time:month"
],
"type": "string",
"description": "Time bucket to group by. Default time:day."
},
"date_range": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
],
"description": "Date range: a shortcut string (\"day\", \"7d\", \"28d\", \"30d\", \"91d\", \"month\", \"6mo\", \"12mo\", \"year\", \"all\", \"24h\") OR a 2-element ISO8601 array like [\"2024-01-01\",\"2024-07-01\"] (dates or datetimes with tz)."
}
}
},
"annotations": {
"title": "Timeseries",
"readOnlyHint": true
}
}Convenience: break metrics down by a single property (dimension), e.g. visit:source or event:page. Plausible: POST /api/v2/query with dimensions=[property].
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max rows to return — maps to pagination.limit. |
| filters | array | Optional filters. Each is an array like ["is","visit:country_name",["Estonia"]] or ["contains","event:page",["/blog"]] with logical wrappers ["and",[...]] / ["or",[...]] / ["not",[...]]. Operators: is, is_not, contains, contains_not, matches, matches_not, has_done, has_not_done. |
| metrics * | array | Metrics to compute. Any of: visitors, visits, pageviews, views_per_visit, bounce_rate, visit_duration, events, scroll_depth, percentage, conversion_rate, group_conversion_rate, average_revenue, total_revenue, time_on_page. |
| site_id * | string | The site's domain as registered in Plausible, e.g. "example.com". |
| order_by | array | Optional ordering: an array of [metric_or_dimension, "asc"|"desc"] pairs, e.g. [["visitors","desc"]]. |
| property * | string | The single dimension to group by, e.g. visit:source, event:page, visit:country_name, visit:device. |
| date_range * | any | Date range: a shortcut string ("day", "7d", "28d", "30d", "91d", "month", "6mo", "12mo", "year", "all", "24h") OR a 2-element ISO8601 array like ["2024-01-01","2024-07-01"] (dates or datetimes with tz). |
{
"name": "plausible_breakdown",
"title": "Breakdown by property",
"description": "Convenience: break metrics down by a single property (dimension), e.g. visit:source or event:page. Plausible: POST /api/v2/query with dimensions=[property].",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"metrics",
"date_range",
"property"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Max rows to return — maps to pagination.limit."
},
"filters": {
"type": "array",
"items": {
"type": "array",
"items": {}
},
"description": "Optional filters. Each is an array like [\"is\",\"visit:country_name\",[\"Estonia\"]] or [\"contains\",\"event:page\",[\"/blog\"]] with logical wrappers [\"and\",[...]] / [\"or\",[...]] / [\"not\",[...]]. Operators: is, is_not, contains, contains_not, matches, matches_not, has_done, has_not_done."
},
"metrics": {
"type": "array",
"items": {
"enum": [
"visitors",
"visits",
"pageviews",
"views_per_visit",
"bounce_rate",
"visit_duration",
"events",
"scroll_depth",
"percentage",
"conversion_rate",
"group_conversion_rate",
"average_revenue",
"total_revenue",
"time_on_page"
],
"type": "string"
},
"minItems": 1,
"description": "Metrics to compute. Any of: visitors, visits, pageviews, views_per_visit, bounce_rate, visit_duration, events, scroll_depth, percentage, conversion_rate, group_conversion_rate, average_revenue, total_revenue, time_on_page."
},
"site_id": {
"type": "string",
"description": "The site's domain as registered in Plausible, e.g. \"example.com\"."
},
"order_by": {
"type": "array",
"items": {
"type": "array",
"items": {}
},
"description": "Optional ordering: an array of [metric_or_dimension, \"asc\"|\"desc\"] pairs, e.g. [[\"visitors\",\"desc\"]]."
},
"property": {
"type": "string",
"description": "The single dimension to group by, e.g. visit:source, event:page, visit:country_name, visit:device."
},
"date_range": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
],
"description": "Date range: a shortcut string (\"day\", \"7d\", \"28d\", \"30d\", \"91d\", \"month\", \"6mo\", \"12mo\", \"year\", \"all\", \"24h\") OR a 2-element ISO8601 array like [\"2024-01-01\",\"2024-07-01\"] (dates or datetimes with tz)."
}
}
},
"annotations": {
"title": "Breakdown by property",
"readOnlyHint": true
}
}Get the number of current visitors on a site (active in the last 5 minutes). Returns a single integer. Plausible: GET /api/v1/stats/realtime/visitors.
| Parameter | Type | Description |
|---|---|---|
| site_id * | string | The site's domain as registered in Plausible, e.g. "example.com". |
{
"name": "plausible_realtime_visitors",
"title": "Realtime visitors",
"description": "Get the number of current visitors on a site (active in the last 5 minutes). Returns a single integer. Plausible: GET /api/v1/stats/realtime/visitors.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id"
],
"properties": {
"site_id": {
"type": "string",
"description": "The site's domain as registered in Plausible, e.g. \"example.com\"."
}
}
},
"annotations": {
"title": "Realtime visitors",
"readOnlyHint": true
}
}List the sites the API key can access (domain + timezone), with cursor pagination. Requires an enterprise plan. Plausible: GET /api/v1/sites.
| Parameter | Type | Description |
|---|---|---|
| after | string | Cursor for the next page (from meta.after). |
| limit | integer | Sites per page. |
| before | string | Cursor for the previous page (from meta.before). |
{
"name": "plausible_list_sites",
"title": "List sites",
"description": "List the sites the API key can access (domain + timezone), with cursor pagination. Requires an enterprise plan. Plausible: GET /api/v1/sites.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"after": {
"type": "string",
"description": "Cursor for the next page (from meta.after)."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Sites per page."
},
"before": {
"type": "string",
"description": "Cursor for the previous page (from meta.before)."
}
}
},
"annotations": {
"title": "List sites",
"readOnlyHint": true
}
}Get a single site by its domain (timezone, etc.). Requires an enterprise plan. Plausible: GET /api/v1/sites/{site_id}.
| Parameter | Type | Description |
|---|---|---|
| site_id * | string | The site's domain as registered in Plausible, e.g. "example.com". |
{
"name": "plausible_get_site",
"title": "Get site",
"description": "Get a single site by its domain (timezone, etc.). Requires an enterprise plan. Plausible: GET /api/v1/sites/{site_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id"
],
"properties": {
"site_id": {
"type": "string",
"description": "The site's domain as registered in Plausible, e.g. \"example.com\"."
}
}
},
"annotations": {
"title": "Get site",
"readOnlyHint": true
}
}List the goals (conversions) configured for a site. Requires an enterprise plan. Plausible: GET /api/v1/sites/goals.
| Parameter | Type | Description |
|---|---|---|
| site_id * | string | The site's domain as registered in Plausible, e.g. "example.com". |
{
"name": "plausible_list_goals",
"title": "List goals",
"description": "List the goals (conversions) configured for a site. Requires an enterprise plan. Plausible: GET /api/v1/sites/goals.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id"
],
"properties": {
"site_id": {
"type": "string",
"description": "The site's domain as registered in Plausible, e.g. \"example.com\"."
}
}
},
"annotations": {
"title": "List goals",
"readOnlyHint": true
}
}Tools for Plausible, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many visitors did my site get last month compared with the month before?"; "What are my top 10 pages by visitors this week?"; "Where is my traffic coming from this month?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Plausible data. Free plan: 50 tool calls per month. Run plausible_analytics_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run plausible_analytics_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run plausible_analytics_upgrade without a plan: it returns both plans, each with a payment link for the user to open. plausible_analytics_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.