Approvals
MCP tools for the Approvals module. See the Approvals module docs for permissions and data model.
list-approvals
List approval items
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (required if not using project key auth) |
status | string | no | Filter by lifecycle status |
origin | string | no | Filter by producer origin |
expires_before | string | no | Return only items expiring at or before this timestamp |
limit | number | no | Maximum number of results to return |
offset | number | no | Number of results to skip |
list-approval-recurrences
List recurring approval groups
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (required if not using project key auth) |
status | string | no | Lifecycle status the groups are built from (default rejected) |
min_count | number | no | Minimum items in a group for it to be returned |
limit | number | no | Maximum number of groups to return |
offset | number | no | Number of groups to skip |
get-approval
Get an approval item
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
approval_id | string | yes | Approval item ID |
approve-approval
Approve an approval item
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
approval_id | string | yes | Approval item ID |
arguments | object | no | Edited arguments to execute instead of the proposed ones. Editing composes a new call, so it additionally requires permission to make that call: tools:CallTool on the tool, and for a builtin proposal the action's own IAM action. |
tool_context | object | no | Key-value pairs forwarded as context headers on the approved action and on every tool call of the continuation turn, as on a generation's tool_context. Never stored on the item: supply it on the approve call itself, for a tool that authorizes with a credential minted at decision time. The server-pinned identity keys (session_id, actor_id, actor_external_id) are dropped. An invalid or colliding key is rejected with 400 INVALID_TOOL_CONTEXT_KEY and nothing is resolved. |
reject-approval
Reject an approval item
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
approval_id | string | yes | Approval item ID |
reason | string | yes | Why the item is being rejected (required) |