MCP tools: remote-escalation

All tool groups

remote-escalation

Registered when: org: escalation.enabled (off on every plan: real phone spend, can wake people; a platform admin turns it on per org).

escalation_cancel

Cancel an emergency THIS key raised (for example a false alarm). A bot cannot cancel anyone else's.

Parameter	Type	Required	Description
escalationId	string	yes

Example call:

{"name":"escalation_cancel","arguments":{"escalationId":"<escalationId>"}}

Related: escalation_status, escalation_raise, escalation_list, escalation_get.

escalation_get

One emergency with its timeline: who was contacted, how, when, delivery status and acknowledgements.

Parameter	Type	Required	Description
escalationId	string	yes

Example call:

{"name":"escalation_get","arguments":{"escalationId":"<escalationId>"}}

Related: escalation_status, escalation_raise, escalation_list, escalation_cancel.

escalation_list

List emergencies this key can see (newest first).

Parameter	Type	Required	Description
state	"pending_confirm" \	"open" \	"acked" \
limit	integer	no

Example call:

{"name":"escalation_list","arguments":{}}

Related: escalation_status, escalation_raise, escalation_get, escalation_cancel.

escalation_raise

Raise an EMERGENCY that pages people (push, email, then SMS, WhatsApp and phone calls) until someone acknowledges. Only for real emergencies: the organization's agent routing policy decides which severities this bot may raise, requires a ticket link and evidence (e.g. evidence.reason), and caps raises per day; every refusal is audited. A sev1 from a bot waits for a person to confirm. Use idempotencyKey so a retry does not page twice.

Parameter	Type	Required	Description
title	string	yes	One line a person can act on, no secrets.
severity	"sev1" \	"sev2" \	"sev3" \
issueId	string	no	The ticket this is about (usually required by policy).
projectId	string	no
summary	string	no
evidence	object	no	Evidence fields the policy requires, e.g. { reason, logUrl }.
idempotencyKey	string	no

Example call:

{"name":"escalation_raise","arguments":{"title":"<title>","severity":"sev1"}}

Related: escalation_status, escalation_list, escalation_get, escalation_cancel.

escalation_status

Whether emergency escalation is on for this key's organization, which channels are configured, and whether bots may raise.

No parameters.

Example call:

{"name":"escalation_status","arguments":{}}

Related: escalation_raise, escalation_list, escalation_get, escalation_cancel.