# Approvals

> MCP tools for the Approvals module. See the [Approvals module docs](/docs/modules/approvals) for permissions and data model.

# Approvals

MCP tools for the Approvals module. See the [Approvals module docs](/docs/modules/approvals) 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

This tool takes no arguments.

### `approve-approval`

Approve an approval item

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `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. |

### `reject-approval`

Reject an approval item

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `reason` | `string` | yes | Why the item is being rejected (required) |