# Documentation for `scw mcp`


:::note{title="The CLI documentation pages are currently under construction"}
The content is up to date. We're making improvements to the site over the next few weeks for a better experience.
:::

<!-- DO NOT EDIT: this file is automatically generated using scw-doc-gen -->
Commands for managing the MCP server that exposes Scaleway CLI commands as AI tools.

- [MCP server management commands](#mcp-server-management-commands)
  - [List available MCP resources](#list-available-mcp-resources)
  - [List available MCP tools](#list-available-mcp-tools)
  - [Start the MCP server](#start-the-mcp-server)


## MCP server management commands

Commands for managing the MCP server that exposes Scaleway CLI commands as AI tools.


### List available MCP resources

Lists all CLI commands that would be exposed as MCP resources by the server. Resources are read-only endpoints for list commands that can be accessed via URI. Use filters to see which resources are available for specific namespaces or resources.

**Usage:**

```shell
scw mcp server list-resources [arg=value ...]
```


**Args:**

| Name |   | Description |
|------|---|-------------|
| namespaces |  | Filter by namespaces (e.g., instance, iam, object) |
| resources |  | Filter by resources (e.g., server, volume, bucket) |
| read-only | Default: `false` | Only list read-only resources |


**Examples:**


List all available MCP resources
```shell
scw mcp server list-resources
```

List resources for a specific namespace
```shell
scw mcp server list-resources namespaces=instance
```

List resources for a specific resource type
```shell
scw mcp server list-resources resources=server
```

List only read-only resources
```shell
scw mcp server list-resources read-only=true
```




### List available MCP tools

Lists all CLI commands that would be exposed as MCP tools by the server. Use filters to see which commands are available for specific namespaces, resources, or verbs.

**Usage:**

```shell
scw mcp server list-tools [arg=value ...]
```


**Args:**

| Name |   | Description |
|------|---|-------------|
| namespaces |  | Filter by namespaces (e.g., instance, iam, object) |
| resources |  | Filter by resources (e.g., server, volume, bucket) |
| verbs |  | Filter by verbs (e.g., get, list, create) |
| read-only | Default: `false` | Only list read-only tools (get, list operations) |


**Examples:**


List all available MCP tools
```shell
scw mcp server list-tools
```

List tools for specific namespaces (comma-separated)
```shell
scw mcp server list-tools namespaces=instance
```

List tools for specific resources (comma-separated)
```shell
scw mcp server list-tools resources=server
```

List only read-only tools (get/list operations)
```shell
scw mcp server list-tools read-only=true
```

List tools with specific verbs (comma-separated)
```shell
scw mcp server list-tools verbs=get,list
```




### Start the MCP server

Runs the MCP server, exposing all CLI commands as MCP tools for AI assistants. Supports stdio (default) and streamable HTTP transports.

**Usage:**

```shell
scw mcp server serve [arg=value ...]
```


**Args:**

| Name |   | Description |
|------|---|-------------|
| transport | Default: `stdio` | Transport mode: stdio (default) or streamable-http |
| address | Default: `:8080` | Address to bind for streamable-http transports (e.g., :8080) |
| read-only | Default: `false` | Only register read-only commands (get, list operations) |
| namespaces |  | Only serve commands from specified namespaces (comma-separated) |
| resources |  | Only serve commands from specified resources (comma-separated) |
| verbs |  | Only serve commands with specified verbs (comma-separated) |


**Examples:**


Start the MCP server with stdio transport (default)
```shell
scw mcp server serve
```

Start the MCP server in read-only mode (only get/list operations)
```shell
scw mcp server serve --read-only
```

Only serve commands from specific namespaces
```shell
scw mcp server serve namespaces=instance,iam,object
```

Only serve commands from specific resources
```shell
scw mcp server serve resources=server,volume,bucket
```

Only serve commands with specific verbs
```shell
scw mcp server serve verbs=get,list,create
```

Combine filters to serve only instance server get/list commands
```shell
scw mcp server serve namespaces=instance resources=server verbs=get,list
```