# io.usefulapi/plausible-analytics (remote · plausible-analytics.usefulapi.io)

Query site stats, realtime visitors, breakdowns and goals from Plausible Analytics.

- Trust score: 67/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `plausible-analytics.usefulapi.io`: 67/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-plausible-analytics/plausible-analytics.md), [page](https://verifymcp.io/servers/io-usefulapi-plausible-analytics/plausible-analytics)

## Channel facts

- Endpoint: `https://plausible-analytics.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 78/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 63/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1733 tokens (~216/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 3/100
  - Stability observed for 1 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http io-usefulapi-plausible-analytics https://plausible-analytics.usefulapi.io/mcp
```

### Codex

```toml
[mcp_servers.io-usefulapi-plausible-analytics]
url = "https://plausible-analytics.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-plausible-analytics": {
      "type": "remote",
      "url": "https://plausible-analytics.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-plausible-analytics --url https://plausible-analytics.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-plausible-analytics:
    url: "https://plausible-analytics.usefulapi.io/mcp"
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-plausible-analytics": {
      "type": "http",
      "url": "https://plausible-analytics.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 67, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-08-02 (score 67, +49)

- [security improvement] Authorization: unverified → pass
- [security improvement] Transport: fail → pass
- [security] First check of Authorization: partial
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail

### 2026-08-01 (score 18)

First indexed and scored.

## MCP tools (8)

### `plausible_query_stats` (~483 tokens)

Query stats

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.

Input parameters:

- `date_range` (required): 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 t…
- `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:coun…
- `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: i…
- `include` (object): Optional include flags: { imports?, time_labels?, total_rows? }.
- `metrics` (array, required): 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…
- `order_by` (array): Optional ordering: an array of [metric_or_dimension, "asc"|"desc"] pairs, e.g. [["visitors","desc"]].
- `pagination` (object): Optional pagination: { limit?, offset? }.
- `site_id` (string, required): The site's domain as registered in Plausible, e.g. "example.com".

### `plausible_aggregate` (~286 tokens)

Aggregate totals

Convenience: aggregate totals for the given metrics over a date range (no group-by). Plausible: POST /api/v2/query with no dimensions.

Input parameters:

- `date_range` (required): 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 t…
- `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: i…
- `metrics` (array, required): 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…
- `site_id` (string, required): The site's domain as registered in Plausible, e.g. "example.com".

### `plausible_timeseries` (~299 tokens)

Timeseries

Convenience: metrics over time, grouped by a time interval. Plausible: POST /api/v2/query with dimensions=[interval].

Input parameters:

- `date_range` (required): 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 t…
- `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: i…
- `interval` (string): Time bucket to group by. Default time:day.
- `metrics` (array, required): 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…
- `site_id` (string, required): The site's domain as registered in Plausible, e.g. "example.com".

### `plausible_breakdown` (~378 tokens)

Breakdown by property

Convenience: break metrics down by a single property (dimension), e.g. visit:source or event:page. Plausible: POST /api/v2/query with dimensions=[property].

Input parameters:

- `date_range` (required): 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 t…
- `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: i…
- `limit` (integer): Max rows to return — maps to pagination.limit.
- `metrics` (array, required): 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…
- `order_by` (array): Optional ordering: an array of [metric_or_dimension, "asc"|"desc"] pairs, e.g. [["visitors","desc"]].
- `property` (string, required): The single dimension to group by, e.g. visit:source, event:page, visit:country_name, visit:device.
- `site_id` (string, required): The site's domain as registered in Plausible, e.g. "example.com".

### `plausible_realtime_visitors` (~75 tokens)

Realtime visitors

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.

Input parameters:

- `site_id` (string, required): The site's domain as registered in Plausible, e.g. "example.com".

### `plausible_list_sites` (~84 tokens)

List sites

List the sites the API key can access (domain + timezone), with cursor pagination. Requires an enterprise plan. Plausible: GET /api/v1/sites.

Input parameters:

- `after` (string): Cursor for the next page (from meta.after).
- `before` (string): Cursor for the previous page (from meta.before).
- `limit` (integer): Sites per page.

### `plausible_get_site` (~64 tokens)

Get site

Get a single site by its domain (timezone, etc.). Requires an enterprise plan. Plausible: GET /api/v1/sites/{site_id}.

Input parameters:

- `site_id` (string, required): The site's domain as registered in Plausible, e.g. "example.com".

### `plausible_list_goals` (~64 tokens)

List goals

List the goals (conversions) configured for a site. Requires an enterprise plan. Plausible: GET /api/v1/sites/goals.

Input parameters:

- `site_id` (string, required): The site's domain as registered in Plausible, e.g. "example.com".

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-plausible-analytics/plausible-analytics#diagnostics

## Score history

- 2026-08-03: 67
- 2026-08-02: 67
- 2026-08-01: 18

## Links

- Remote endpoint: https://plausible-analytics.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-plausible-analytics/plausible-analytics/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-plausible-analytics/plausible-analytics/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-plausible-analytics/plausible-analytics