# PeppolStatus (remote · mcp.peppolstatus.com)

Peppol market intelligence and network monitoring: migrations, provider churn, leads, and uptime.

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

## Components

- remote · `mcp.peppolstatus.com`: 65/100 (this document), [markdown](https://verifymcp.io/servers/com-peppolstatus-api/mcp.md), [page](https://verifymcp.io/servers/com-peppolstatus-api/mcp)

## Channel facts

- Endpoint: `https://mcp.peppolstatus.com`
- 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-07.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 29 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 72/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3725 tokens (~128/item across 29 items; 29 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**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### Claude

```bash
claude mcp add --transport http com-peppolstatus-api https://mcp.peppolstatus.com/
```

### Codex

```toml
[mcp_servers.com-peppolstatus-api]
url = "https://mcp.peppolstatus.com/"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-peppolstatus-api": {
      "type": "remote",
      "url": "https://mcp.peppolstatus.com/",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-peppolstatus-api --url https://mcp.peppolstatus.com/ --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-peppolstatus-api:
    url: "https://mcp.peppolstatus.com/"
```

### Other

```json
{
  "mcpServers": {
    "com-peppolstatus-api": {
      "type": "http",
      "url": "https://mcp.peppolstatus.com/"
    }
  }
}
```

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-07 (score 65, +1)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “get_adoption” rewrote its description, which is the text the model reads
- [functional improvement] Stability: unverified → 0.03
- [functional] Schema quality: good → excellent

### 2026-08-06 (score 64)

First indexed and scored.

## MCP tools (29)

### `list_hosts` (~42 tokens)

List monitored hosts

Every monitored host with its current verdict, latest hourly all-locations latency and 24h uptime, worst-first, plus a network-wide rollup.

### `get_host` (~79 tokens)

Get a host's current state

Current role, verdict, network attribution (IPs/PTR), TLS certificate and operating provider for a host. `?at=` returns point-in-time state.

Input parameters:

- `at` (string): Point-in-time ISO 8601 instant; omitted returns current state.
- `hostname` (string, required): The host's fully-qualified hostname.

### `list_host_incidents` (~118 tokens)

List a host's incidents

Incidents for one host, newest-first, cursor-paginated.

Input parameters:

- `cursor` (string): Opaque pagination cursor returned as `next_cursor` by the previous page.
- `hostname` (string, required): The host's fully-qualified hostname.
- `limit` (integer): Page size, clamped to [1, 200]. Defaults to 50.
- `since` (string): Only include items at or after this ISO 8601 instant.
- `status` (string): Filter by incident lifecycle state.

### `get_host_uptime` (~186 tokens)

Get a host's uptime aggregates

The aggregate ladder for a host at a chosen resolution, per-location plus the `__all__` rollup, optionally windowed by `[from, to)`, cursor-paginated.

Input parameters:

- `cursor` (string): Opaque pagination cursor returned as `next_cursor` by the previous page.
- `from` (string): Inclusive lower bound (ISO 8601). Must not be after `to`.
- `hostname` (string, required): The host's fully-qualified hostname.
- `limit` (integer): Page size, clamped to [1, 200]. Defaults to 50.
- `location` (string): Restrict to one probe location, or `__all__` for the rollup.
- `resolution` (string): Aggregate tier. Defaults to hourly.
- `to` (string): Exclusive upper bound (ISO 8601).

### `list_incidents` (~113 tokens)

List incidents

The global incident feed, newest-first, cursor-paginated.

Input parameters:

- `cursor` (string): Opaque pagination cursor returned as `next_cursor` by the previous page.
- `host` (string): Filter to one host's incidents.
- `limit` (integer): Page size, clamped to [1, 200]. Defaults to 50.
- `since` (string): Only include items at or after this ISO 8601 instant.
- `status` (string): Filter by incident lifecycle state.

### `get_participant` (~91 tokens)

Get a participant's current state

Directory presence, SML registration + current SMP, business card, the company-register enrichment block, endpoints and serving seats for a Peppol participant. Discovered participants carry no card; unmatched participants carry company: null.

Input parameters:

- `id` (string, required): Canonical `scheme::value` Peppol identifier (e.g. `0208::0762747721`).

### `list_participant_events` (~94 tokens)

List a participant's change events

The participant's typed change events, newest-first, cursor-paginated.

Input parameters:

- `cursor` (string): Opaque pagination cursor returned as `next_cursor` by the previous page.
- `id` (string, required): Canonical `scheme::value` Peppol identifier.
- `limit` (integer): Page size, clamped to [1, 200]. Defaults to 50.

### `get_participant_history` (~103 tokens)

List a participant's temporal history

The participant's temporal rows across the directory/card/registration/SMP fact families, newest-first, cursor-paginated.

Input parameters:

- `cursor` (string): Opaque pagination cursor returned as `next_cursor` by the previous page.
- `id` (string, required): Canonical `scheme::value` Peppol identifier.
- `limit` (integer): Page size, clamped to [1, 200]. Defaults to 50.

### `get_network_summary` (~30 tokens)

Get the network summary

Current host verdict counts, open incidents and anomalies in the last 24h.

### `get_adoption` (~191 tokens)

Get a country's adoption aggregates

Peppol adoption for one country as one bare object: headline totals (universe, on_peppol, penetration), the single-dimension cuts (sector with a NACE section rollup, region, FR-only département + size class, and legal-form family — companies vs sole traders vs associations) and the trend (monthly new adopters plus per-run penetration history). Region cells carry ISO 3166-2 (BE) / INSEE région (FR) codes and sector cells the NACE division code, so the choropleth joins geometry with no string matching. Numerator cells below 10 matched companies are suppressed (`on_peppol`/`penetration` null, `suppressed` true); denominators are never suppressed. Cached for a day (data moves monthly).

Input parameters:

- `country` (string, required): Country code — `be` or `fr`.

### `list_providers` (~55 tokens)

List providers

The OpenPeppol member registry with role flags, country, mapped hostnames and per-provider participant counts (market share), busiest first. Not paginated (the envelope's `next_cursor` is always null).

### `get_provider` (~39 tokens)

Get a curated provider

A curated provider navigable to its seats and each seat's observed hosts.

Input parameters:

- `slug` (string, required): The curated provider slug.

### `get_provider_sla` (~108 tokens)

List provider SLA scorecards

Per-provider SLA scorecards for one trailing period: checks-weighted uptime across each provider's mapped hosts, incident count, total downtime minutes and the single worst host. Ordered worst uptime first (providers with no checks in the window last). Materialized hourly by the batch runner. Not paginated (the envelope's `next_cursor` is always null).

Input parameters:

- `period` (string): Trailing window: `30d` (default) or `90d`.

### `get_provider_sla_by_key` (~83 tokens)

Get a provider's SLA scorecards

One provider's SLA scorecards, one per trailing period (30d and 90d). `key` is the provider's natural key (as reported by `GET /v1/providers`). Empty `items` when the provider has no SLA data yet.

Input parameters:

- `key` (string, required): The provider natural key.

### `list_provider_certs` (~77 tokens)

Get a provider's certificate posture

A curated provider's whole-fleet certificate posture in one call: per-Seat cert counts, soonest expiry, expired / expiring-within-30-days counts, observed cert organisations and last identity shift, plus the rolled-up fleet summary.

Input parameters:

- `slug` (string, required): The curated provider slug.

### `list_access_points` (~87 tokens)

List access points

The Access Point directory: every Provider in its serving role, with its member seats and roster size (current participant count), busiest first. A Provider is resolved from each seat with the precedence curated mapping (verified) → exact signing-cert `O=` string (unverified) → bare SeatID. Not paginated (the envelope's `next_cursor` is always null).

### `get_access_point` (~132 tokens)

Get an access point

One Provider's detail: display name, verified flag, member seats (each with its embedded provider or unverified cert-CN), roster size, and the country + document-scheme composition of its roster. A request for a STALE key (a seat since curated, so its old unverified key left the directory) resolves to the current Provider; the returned `key` is always the canonical current one.

Input parameters:

- `key` (string, required): The provider key (e.g. `c-tickstar`, `o-teamleader-nv-1f3a2b9c`).

### `get_access_point_churn` (~178 tokens)

Get an access point's churn

An Access Point's joiner / mover / leaver activity over a period: a daily category series with derived net growth, period totals, and the 'won from / lost to' counterpart breakdown. Joiners are first-ever serving seats (from 2026-08-02 onward, first-full-deep-sweep completion); movers change Provider (both sides resolved to the current identity); leavers deregister while served. Defaults to the trailing 30 days.

Input parameters:

- `from` (string): Inclusive period start, `YYYY-MM-DD` UTC. Defaults to 29 days before `to`.
- `key` (string, required): The Provider key (e.g. `c-tickstar`).
- `to` (string): Inclusive period end, `YYYY-MM-DD` UTC. Defaults to today.

### `list_access_point_churn_participants` (~110 tokens)

List participants behind a churn category

The drill-down: the participant IDs behind one churn category count for this Provider over the period. Bounded to 500 rows (never paginated; next_cursor null).

Input parameters:

- `category` (string, required): The churn category to expand.
- `from` (string): Inclusive period start, `YYYY-MM-DD` UTC.
- `key` (string, required): The Provider key.
- `to` (string): Inclusive period end, `YYYY-MM-DD` UTC.

### `list_smps` (~190 tokens)

List SMPs

The SMP directory: every current SMP hostname with the seat(s) and provider that sign its metadata, busiest first. A hostname is listed if it currently homes participants (from the participant rollup's `smp` facet) or carries an open `smp-signing` certificate. `participant_count` comes from that bounded top-N facet, so a hostname with a signing cert but outside the top-N carries a null count (unknown), not zero. The provider is resolved from the most-recent open signing cert with the precedence curated mapping (verified) → unverified cert-CN — the same as `/v1/aps`. Not paginated (the envelope's `next_cursor` is always null).

Input parameters:

- `limit` (integer): Cap on returned rows (non-negative integer). Defaults to all.
- `q` (string): Case-insensitive substring filter on the SMP hostname.

### `get_seat` (~62 tokens)

Get a seat

A Peppol certificate seat: its embedded provider (verified mapping or unverified cert-CN fallback) and the hosts it was observed operating.

Input parameters:

- `seatId` (string, required): The seat identifier (e.g. `POP000748`).

### `list_events` (~263 tokens)

List global change events

Every typed change event, newest-first, cursor-paginated. Any anomaly an event triggered is embedded on it. `cursor` walks older events; `prev_cursor` walks the newer edge (for live polling). The first page carries a `meta` block with exact type facets + filter count and an auto-bucketed timeline chart.

Input parameters:

- `cursor` (string): Opaque pagination cursor returned as `next_cursor` by the previous page.
- `host` (string): Filter to events for one host.
- `limit` (integer): Page size, clamped to [1, 200]. Defaults to 50.
- `participant` (string): Filter to one participant (`scheme::value`).
- `prev_cursor` (string): Opaque newer-direction cursor (from a page's `prev_cursor`): returns events newer than it, newest-first. Mutually exclusive with `cursor`.
- `seat` (string): Filter to events referencing one seat.
- `since` (string): Only include items at or after this ISO 8601 instant.
- `type` (array): Comma-array of change-event types (a single value is valid).
- `until` (string): Only include events at or before this ISO 8601 instant.

### `list_participants` (~574 tokens)

List participants

The participant set, keyset-paginated. Default sort is first-seen newest-first. Comma-array filters (`country`, `scheme`, `smp`, `ap`, `doctype`, `transport_profile`, `provenance`), a `registered` boolean, and a smart `q` (a `scheme::value`/bare value hits the ID index; free text runs a trigram name-contains). First-page `meta` carries estimated totals and rollup facets; `meta.filter_count` is a bounded exact count that degrades to null (never an error) if it exceeds the query timeout. Discovered participants carry no name/card fields (privacy).

Input parameters:

- `ap` (array): Comma-array of serving Access Point SeatIDs (`PBE000123,PNO000456`).
- `country` (array): Comma-array of ISO country codes (`BE,NL`).
- `cursor` (string): Opaque pagination cursor returned as `next_cursor` by the previous page.
- `doctype` (array): Comma-array of Peppol document type ids. Matches a participant if ANY of its current endpoints declares one of the given doctypes. Used ALONE (no other filter) results are ordered by identifier and `…
- `limit` (integer): Page size, clamped to [1, 200]. Defaults to 50.
- `provenance` (array): Comma-array of provenance values.
- `q` (string): Smart search: `scheme::value`/bare value → ID lookup; else name-contains.
- `registered` (boolean): Filter by current SML registration state.
- `scheme` (array): Comma-array of Peppol identifier schemes.
- `smp` (array): Comma-array of current SMP hostnames (`smp1.example,smp2.example`).
- `sort` (string): Sort + keyset key. When `doctype`/`transport_profile` is set WITHOUT any other narrowing filter, it is IGNORED — those results are driven from the endpoint index and ordered by identifier (`scheme`,…
- `transport_profile` (array): Comma-array of transport profile ids (`peppol-transport-as4-v2_0`). Matches a participant if ANY of its current endpoints uses one of the given profiles. Used ALONE (no other filter) results are orde…

### `get_participant_stats` (~63 tokens)

Participant facet stats

Global participant facet counts (per country/scheme/smp/ap/doctype/transport_profile, registered share, provenance split) plus an estimated total, from the hourly rollup. Keyless-cacheable — safe for the marketing site to hit directly.

### `get_participant_stats_history` (~185 tokens)

Participant facet history

A daily time series over one participant facet dimension (adoption curves / QoQ trends), from daily snapshots of the rollup. History accrues from the day the feature shipped. Keyless-cacheable.

Input parameters:

- `dimension` (string, required): Which series to return: `total` (whole-network count) or a facet dimension.
- `from` (string): Inclusive lower bound (YYYY-MM-DD UTC). Defaults to 90 days ago.
- `key` (array): Comma-separated facet keys to filter to (e.g. `BE,NL` for `dimension=country`). Omit for every key in the dimension.
- `limit` (integer): Max points returned, clamped to [1, 10000]. Defaults to 10000.
- `to` (string): Inclusive upper bound (YYYY-MM-DD UTC). Defaults to today.

### `get_country_churn` (~138 tokens)

Per-country participant churn

New (joiner) vs departed (leaver) participants for one country, as a daily series and an all-time monthly rollup, from the hourly churn rollup. A valid but unknown country returns empty arrays. Keyless-cacheable.

Input parameters:

- `code` (string, required): Two-letter country code (ISO 3166-1 alpha-2), case-insensitive.
- `from` (string): Inclusive lower bound of the daily series (YYYY-MM-DD UTC). Defaults to 30 days ago.
- `to` (string): Inclusive upper bound of the daily series (YYYY-MM-DD UTC). Defaults to today.

### `list_anomalies` (~145 tokens)

List anomalies

The anomaly feed, newest-first, cursor-paginated.

Input parameters:

- `acknowledged` (boolean): Filter by acknowledgement state.
- `cursor` (string): Opaque pagination cursor returned as `next_cursor` by the previous page.
- `detector` (string): Filter by detector.
- `grade` (string): Filter by grade.
- `host` (string): Filter to anomalies targeting one host.
- `limit` (integer): Page size, clamped to [1, 200]. Defaults to 50.
- `seat` (string): Filter to anomalies targeting one seat.
- `since` (string): Only include items at or after this ISO 8601 instant.

### `get_anomaly` (~33 tokens)

Get an anomaly

One anomaly by its stable content-derived key.

Input parameters:

- `id` (string, required): The stable anomaly key.

### `get_sml_status` (~48 tokens)

Get SML/SMK zone status

One entry per monitored zone: quorum verdict, per-location canary breakdown, DNAME cutover state, management-host TLS snapshot and zone incidents.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-peppolstatus-api/mcp#diagnostics

## Score history

- 2026-08-07: 65
- 2026-08-06: 64

## Links

- Remote endpoint: https://mcp.peppolstatus.com/
- Website: https://peppolstatus.com/mcp
- Changelog RSS feed: https://verifymcp.io/servers/com-peppolstatus-api/mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-peppolstatus-api/mcp.json
- HTML version of this page: https://verifymcp.io/servers/com-peppolstatus-api/mcp