Version
READ

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.

The switches the Prevention page holds per project. auto_failover_enabled says whether the platform may swap a banned channel for its standby on its own, and auto_failover_email_consented_at when the creator accepted the per-email fee that failover may charge; email_delivery says how members are told after a channel swap the creator ran (self: the creator tells them; platform: Subscriby emails them at the fee); standby_installation_registered whether a spare bot is kept. The payload is exactly what the REST endpoint returns. The REST twin is GET /v1/projects/{project}/recovery/settings.

Requires ability

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

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

project_id*string

UUID of the project whose recovery settings to read.

What it returns

{  "data": {    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",    "auto_failover_enabled": true,    "auto_failover_email_consented_at": "2026-09-01T14:20:00Z",    "email_delivery": "platform",    "email_delivery_label": "Subscriby emails them",    "standby_installation_registered": true  },  "meta": {}}

How it fails

RESOURCE_NOT_FOUND

project_id is not a project the token can see.

AUTHENTICATION_REQUIRED

no authenticated user on the request.

TOKEN_MISSING_ABILITY

token lacks project-recovery:view.

How is this guide?

Last updated on