Version
READ

list_recovery_incidents

List the Disaster Recovery incidents of the creator the token acts for — what the health probes found broken, open by default, with the reason in the connector's words.

Answer "is anything of mine banned or broken right now?". An incident is one problem a probe detected and has not yet seen fixed: the creator's sign-in account unreachable (account), a project's installation refused by the platform (bot), or a space the project sells gone or no longer administered (resources). Each row names the connector, the project and resource, the reason as the connector's code and in words, when it was detected and, once healed or fixed, when and by which operation it was resolved. The rows are the ones GET /v1/recovery/incidents returns.

The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.

Runs the same action as

The REST endpoint and this tool share one action, so validation, permissions and events are identical.

Annotations

Read-only

It reads and never changes anything.

Arguments

statusstringoptional

Which incidents: `open` (default: still needing attention), `resolved`, or `all`.

openresolvedall
limitintegeroptional

Incidents per page (1..100, default 25).

min1max100
pageintegeroptional

1-indexed page number.

min1

What it returns

{  "data": [    {      "id": "6f1e9b27-4c3a-4d58-9e02-b7a1c5d38f64",      "kind": "resources",      "kind_label": "Channels and Groups",      "status": "open",      "status_label": "Open",      "connector": "telegram",      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",      "project_name": "Research Premium",      "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",      "resource_title": "Signals",      "reason": "chat_not_found",      "reason_label": "Channel not found",      "reason_explanation": "**Most likely cause:** Telegram deleted or banned the channel. Replace it with a new one.",      "detected_at": "2026-09-12T03:19:04Z",      "resolved_at": null,      "resolved_by_operation_id": null    }  ],  "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }}

How it fails

AUTHENTICATION_REQUIRED

no authenticated user on the request.

TOKEN_MISSING_ABILITY

token lacks project-recovery:view-any.

How is this guide?

Last updated on