list_recovery_operations
List every Disaster Recovery operation of the creator the token acts for — by the creator, the platform or on demand — with its state and whether it can still be undone.
Answer "what has recovery done for me, and can I still undo it?". An operation is one recovery ever run: by the creator, by the platform on their behalf (automatic, the failover you sleep through) or on demand (on_demand, a Swap & Grant of a healthy resource). Each row carries its kind, its state, the connector and project, when it started and finished, the failure reason when it failed, and its undo state: revertible for whether it can be undone right now and revert_window_ends_at for when that closes. The rows are the ones GET /v1/recovery/operations returns.
Requires ability
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
It reads and never changes anything.
Arguments
kindstringoptionalOnly recoveries of this kind: `account`, `bot` or `resources`. Omit for every kind.
accountbotresourcesstatusstringoptionalOnly operations in this state: `started`, `completed`, `failed` or `reverted`. Omit for every state.
startedcompletedfailedrevertedlimitintegeroptionalOperations per page (1..100, default 25).
1max100pageintegeroptional1-indexed page number.
1What it returns
{ "data": [ { "id": "9a4d2e71-5b38-4c6f-8e12-3d7c9b0a5f21", "kind": "resources", "kind_label": "Channels and Groups", "status": "completed", "status_label": "Completed", "connector": "telegram", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "project_name": "Research Premium", "grant_id": null, "automatic": true, "on_demand": false, "failure_reason": null, "started_at": "2026-09-12T03:19:10Z", "completed_at": "2026-09-12T03:19:42Z", "reverted_at": null, "revertible": true, "revert_window_ends_at": "2026-09-13T03:19:42Z" } ], "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }}How it fails
VALIDATION_FAILEDkind or status is not one of the accepted values; the context names them.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-recovery:view-any.
How is this guide?
Last updated on
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.
notify_members_of_recovery
Email every member the project can reach that its bot changed after a bot replacement, at the per-email fee. Sent once per recovery.