<!-- DO NOT EDIT: this file is automatically generated using scw-doc-gen -->
# Documentation for `scw mcp`
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:**

```
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
```
scw mcp server list-resources
```

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

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

List only read-only resources
```
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:**

```
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
```
scw mcp server list-tools
```

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

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

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

List tools with specific verbs (comma-separated)
```
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:**

```
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)
```
scw mcp server serve
```

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

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

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

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

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




