Version
WRITE

nudge_pending_readmissions

Send one reminder, with a fresh link, to every member a channel recovery re-admitted who has not joined the new chat yet.

After a swap, get_recovery_roll_call shows who is still outside (pending) and whether a reminder may go out (can_nudge). This sends it: one message per straggler with a fresh link, recorded on the operation so the cooldown can be enforced. Every reminder reaches a real person, so do not loop it. The REST twin is POST /v1/recovery/operations/{operation}/nudge.

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.

Arguments

operation_id*string

UUID of the completed channel recovery whose stragglers to remind.

What it returns

{  "data": {    "operation_id": "9a4d2e71-5b38-4c6f-8e12-3d7c9b0a5f21",    "nudged": 2  },  "meta": {}}

How it fails

VALIDATION_FAILED

nobody is waiting, the last reminder is too recent, the recovery is not a completed channel swap, or not the creator's own; the context carries the reason.

RESOURCE_NOT_FOUND

operation_id is not in this creator's ledger.

AUTHENTICATION_REQUIRED

no authenticated user on the request.

TOKEN_MISSING_ABILITY

token lacks project-recovery:update.

How is this guide?

Last updated on