# Secrets

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

# Secrets

MCP tools for the Secrets module. See the [Secrets module docs](/docs/modules/secrets) for permissions and data model.

### `list-secrets`

List secrets

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `project_id` | `string` | no | Project ID (required if not using project key auth) |
| `limit` | `number` | no | Number of results per page |
| `offset` | `number` | no | Number of results to skip |

### `create-secret`

Create a secret

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `project_id` | `string` | no | Project ID (required if not using project key auth) |
| `name` | `string` | yes | Secret name |
| `value` | `string` | yes | Secret value (will be encrypted) |

### `get-secret`

Get a secret

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `secret_id` | `string` | yes | Secret ID |

### `update-secret`

Update a secret

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `secret_id` | `string` | yes | Secret ID |
| `name` | `string` | no | New secret name |
| `value` | `string` | no | New secret value |

### `delete-secret`

Delete a secret

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `secret_id` | `string` | yes | Secret ID |
| `force` | `boolean` | no | Delete the secret even when AI providers reference it, destroying those providers too. Without it a referenced secret answers SECRET_HAS_DEPENDENTS. |