Copy page

Commands

Documentation for `scw mcp`

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

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:

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

Arguments:

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

Examples:

List all available MCP resources

Code
scw mcp server list-resources

List resources for a specific namespace

Code
scw mcp server list-resources namespaces=instance

List resources for a specific resource type

Code
scw mcp server list-resources resources=server

List only read-only resources

Code
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:

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

Arguments:

Name	Description	Argument Specifications
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	Only list read-only tools (get, list operations)	Default: false

Examples:

List all available MCP tools

Code
scw mcp server list-tools

List tools for specific namespaces (comma-separated)

Code
scw mcp server list-tools namespaces=instance

List tools for specific resources (comma-separated)

Code
scw mcp server list-tools resources=server

List only read-only tools (get/list operations)

Code
scw mcp server list-tools read-only=true

List tools with specific verbs (comma-separated)

Code
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:

Code
scw mcp server serve [arg=value ...]

Arguments:

Name	Description	Argument Specifications
transport	Transport mode: stdio (default) or streamable-http	Default: stdio
address	Address to bind for streamable-http transports (e.g., :8080)	Default: :8080
read-only	Only register read-only commands (get, list operations)	Default: false
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)

Code
scw mcp server serve

Start the MCP server in read-only mode (only get/list operations)

Code
scw mcp server serve --read-only

Only serve commands from specific namespaces

Code
scw mcp server serve namespaces=instance,iam,object

Only serve commands from specific resources

Code
scw mcp server serve resources=server,volume,bucket

Only serve commands with specific verbs

Code
scw mcp server serve verbs=get,list,create

Combine filters to serve only instance server get/list commands

Code
scw mcp server serve namespaces=instance resources=server verbs=get,list