Skip to main content
All MCP tools

MCP tools · Operator agents and approvals

whats_waiting_for_approval

With approval_id (from a held message, case start, call or campaign), says whether a person approved it and what happened. Without it, lists the organization's pending approvals. It cannot approve or decline anything; that happens in Finn's Approvals inbox.

Scope needed
approvals:read or chat:write or operator:write
Changes data
No, read only
Held for approval
No
Available to
Switched on per organization (MCP task tools)

With the r2 call and campaign tools, voice:write also grants it.

Inputs

NameTypeDescription
org_idstringOrganization id. Leave out when the user belongs to one organization; otherwise the error lists theirs.
approval_idstringThe approval id (a UUID) from a held action.
cursorstringnext_cursor from the previous page.