# AI Providers

> MCP tools for the AI Providers module. See the [AI Providers module docs](/docs/modules/ai-providers) for permissions and data model.

# AI Providers

MCP tools for the AI Providers module. See the [AI Providers module docs](/docs/modules/ai-providers) for permissions and data model.

### `list-ai-providers`

List AI providers

#### 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-ai-provider`

Create an AI provider

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `project_id` | `string` | no | Project ID (required if not using project key auth) |
| `name` | `string` | yes | Provider configuration name |
| `provider` | `string` | yes | LLM provider |
| `default_model` | `string` | yes | Default model to use |
| `secret_id` | `string` | no | Secret ID containing API credentials. Required for `bedrock` and `vertex` unless `config.apiKey` carries one. |
| `base_url` | `string` | no | Custom base URL for the provider |
| `config` | `object` | no | Additional provider-specific configuration |

### `get-ai-provider`

Get an AI provider

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `ai_provider_id` | `string` | yes | AI Provider ID |

### `update-ai-provider`

Update an AI provider

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `ai_provider_id` | `string` | yes | AI Provider ID |
| `name` | `string` | no | — |
| `provider` | `string` | no | LLM provider |
| `default_model` | `string` | no | — |
| `secret_id` | `string \| null` | no | — |
| `base_url` | `string` | no | — |
| `config` | `object` | no | — |

### `delete-ai-provider`

Delete an AI provider

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `ai_provider_id` | `string` | yes | AI Provider ID |
| `force` | `boolean` | no | When `true`, delete the provider's price overrides and unlink its usage history so a provider with only soft dependents can be removed. Has no effect on live references (chats, agents, model routes), which always block deletion. |

### `list-ai-provider-models`

List the models this provider can run

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `ai_provider_id` | `string` | yes | AI Provider ID |

### `get-ai-provider-prices`

List per-provider price overrides

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `ai_provider_id` | `string` | yes | AI Provider ID |

### `update-ai-provider-prices`

Upsert per-provider price overrides

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `ai_provider_id` | `string` | yes | AI Provider ID |
| `prices` | `array<object>` | yes | — |