get_recovery_allowances
Read how many self-service Disaster Recoveries of each kind the creator the token acts for may still run, what support has released on top, and when the allowance returns. Takes no input.
Answer "can I still run a recovery, or do I need support?". Self-service recovery is allowed once per kind (account, bot, resources) inside a rolling window; beyond that, support reviews the account and may release a grant. Each row carries what the window still allows (self_service_remaining), what support has released and not yet spent (grant_remaining), their sum (remaining), whether a recovery of that kind would be allowed right now (allowed), whether the next one would spend a grant (uses_grant), when the kind was last recovered and when the self-service allowance returns. meta carries the window itself. The rows are the ones GET /v1/recovery/allowances 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
This tool takes no arguments.
What it returns
{ "data": [ { "kind": "resources", "kind_label": "Channels and Groups", "self_service_remaining": 0, "grant_remaining": 1, "remaining": 1, "allowed": true, "uses_grant": true, "last_used_at": "2026-09-12T03:19:10Z", "next_self_service_at": "2026-12-11T03:19:10Z" } ], "meta": { "window_days": 90, "self_service_uses": 1 }}One row per kind, in the order account, bot, resources.
How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-recovery:view-any.
How is this guide?
Last updated on
Disaster Recovery Tools
Disaster Recovery is Subscriby's answer to a connector outage or a lost channel: what the probes found, what was recovered and whether it can still be undone.
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.