get_recovery_roll_call
Read where the re-admission after one Disaster Recovery operation stands — how many members hold a fresh link, how many have joined, who is still outside, and whether a reminder may go out now.
After a channel or group is swapped, every active member is re-admitted through a fresh link, and this is the live tally: how many the swap set out to re-admit (total), how many hold a new link (regranted), how many could not be given one (failed), how many the installation could not message (unreachable) and were told by email instead (emailed), how many have joined (joined), who is still outside (pending), how many reminders went out (nudged), whether the queue has handled everyone (settled), and whether the creator may remind the stragglers right now (can_nudge, with nudge_available_at while the cooldown runs). The payload is exactly what GET /v1/recovery/operations/{operation}/roll-call returns.
A recovery of a kind that re-admits nobody (an account relink, a bot replacement) answers the same shape with every counter at zero.
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
operation_id*stringUUID of the recovery operation, from `list_recovery_operations`.
What it returns
{ "data": { "total": 340, "regranted": 340, "failed": 0, "unreachable": 12, "emailed": 12, "joined": 338, "pending": 2, "nudged": 1, "settled": true, "cooling_down": false, "can_nudge": true, "last_nudged_at": "2026-09-12T09:00:00Z", "nudge_available_at": "2026-09-12T10:00:00Z" }, "meta": { "operation_id": "9a4d2e71-5b38-4c6f-8e12-3d7c9b0a5f21" }}How it fails
RESOURCE_NOT_FOUNDoperation_id is not an operation in this creator's ledger.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-recovery:view.
How is this guide?
Last updated on
get_recovery_readiness
Read the Disaster Recovery readiness checklist for the creator the token acts for — every line with its state, and the totals the dashboard card shows. Takes no input.
get_recovery_settings
Read one project's Disaster Recovery settings — automatic failover and its fee consent, how members are told after a swap, and whether a standby installation is kept.