mcp-scaleway

v0.2.3

Published

2 months ago

MCP server for Scaleway cloud provider

0High
0Medium
0Low

mcp-scaleway

An MCP (Model Context Protocol) server that gives AI assistants like Claude full access to the Scaleway cloud platform. Manage compute instances, databases, Kubernetes clusters, serverless functions, object storage, and 30+ more Scaleway services through natural language.

Overview

mcp-scaleway is a stateless MCP server that acts as a bridge between AI assistants and the Scaleway cloud platform. It exposes 539 tools across 36 Scaleway services, enabling AI agents to provision infrastructure, manage databases, deploy applications, and operate cloud resources on your behalf.

Why use this?

Natural language cloud management - Ask your AI assistant to "create a Kubernetes cluster with 3 nodes" instead of writing API calls
Full Scaleway coverage - 36 services, 539 operations, from compute to AI to networking
Zero state - Pure proxy to Scaleway APIs; no data stored, no side effects beyond what you request
Type-safe - Every input validated with Zod schemas before reaching Scaleway

Features

Supports 36 Scaleway service areas organized across 8 categories:

| Category | Services | |----------|----------| | Compute | Instances, Elastic Metal, Apple Silicon | | Storage & Databases | Block Storage, Object Storage, RDB (PostgreSQL/MySQL), MongoDB, Redis, Serverless SQL DB | | Networking | VPC, Load Balancer, Public Gateway, DNS, Domain Registrar, IPAM, Edge Services | | Serverless & Containers | Containers, Functions, Jobs, Kubernetes (K8s) | | AI & Machine Learning | Inference, Generative APIs, Cockpit (Observability) | | Security & Identity | IAM, Secret Manager, Key Manager | | Managed Services | NATS, SQS, SNS, TEM (Transactional Email), IoT Hub, Container Registry, Marketplace | | Account & Billing | Account, Billing, Web Hosting |

Quick Start

# Set your Scaleway credentials
export SCW_ACCESS_KEY="SCWxxxxxxxxxxxxxxxxx"
export SCW_SECRET_KEY="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
export SCW_DEFAULT_PROJECT_ID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

# Run the server
npx mcp-scaleway

Then configure your MCP client (see Configuration below).

Installation

Prerequisites

Node.js 18+ (or Bun 1.x)
A Scaleway account with API credentials

Via npx (no install needed)

npx mcp-scaleway

Global install

npm install -g mcp-scaleway
mcp-scaleway

From source

git clone https://github.com/feedback-loop-ai/mcp-scaleway.git
cd mcp-scaleway
bun install
bun run start

Authentication

The server authenticates with Scaleway using environment variables. You can generate API keys from the Scaleway console.

Required

| Variable | Description | |----------|-------------| | SCW_ACCESS_KEY | Your Scaleway API access key (starts with SCW) | | SCW_SECRET_KEY | Your Scaleway API secret key (UUID format) | | SCW_DEFAULT_PROJECT_ID | Default project UUID for operations |

Optional

| Variable | Description | Default | |----------|-------------|---------| | SCW_DEFAULT_ORGANIZATION_ID | Organization UUID (for multi-org accounts) | (none) | | SCW_DEFAULT_REGION | Default region for regional resources | fr-par | | SCW_DEFAULT_ZONE | Default availability zone for zonal resources | fr-par-1 |

Available Regions

| Region | Location | |--------|----------| | fr-par | Paris, France | | nl-ams | Amsterdam, Netherlands | | pl-waw | Warsaw, Poland |

Each region has multiple zones (e.g., fr-par-1, fr-par-2, fr-par-3).

Configuration

Claude Desktop

Add the server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "scaleway": {
      "command": "npx",
      "args": ["mcp-scaleway"],
      "env": {
        "SCW_ACCESS_KEY": "SCWxxxxxxxxxxxxxxxxx",
        "SCW_SECRET_KEY": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "SCW_DEFAULT_PROJECT_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

Claude Code

Add to your project's .mcp.json file (or ~/.claude/mcp.json for global access):

{
  "mcpServers": {
    "scaleway": {
      "command": "npx",
      "args": ["mcp-scaleway"],
      "env": {
        "SCW_ACCESS_KEY": "SCWxxxxxxxxxxxxxxxxx",
        "SCW_SECRET_KEY": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "SCW_DEFAULT_PROJECT_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

Other MCP Clients

The server uses stdio transport (reads from stdin, writes to stdout). Any MCP-compatible client can connect by running:

SCW_ACCESS_KEY=... SCW_SECRET_KEY=... SCW_DEFAULT_PROJECT_ID=... npx mcp-scaleway

The server follows the MCP specification and works with any client that supports the protocol.

Usage Examples

Once configured, you can ask your AI assistant to manage Scaleway resources using natural language:

Compute - Managing Instances

"List all my running instances in the fr-par-1 zone"

"Create a DEV1-S instance named 'web-server' with an Ubuntu image in fr-par-1"

"Stop the instance with ID xxx and then create a snapshot of its volume"

Storage - Object Storage

"List all my S3 buckets and show how many objects are in each one"

"Create a new bucket called 'app-backups' in the fr-par region"

"Set a lifecycle policy on the 'logs' bucket to expire objects after 30 days"

Kubernetes - Cluster Management

"Create a Kubernetes cluster named 'production' with version 1.28 and a pool of 3 PRO2-S nodes"

"Get the kubeconfig for my 'staging' cluster"

"List all node pools and their autoscaling status"

Serverless - Functions & Containers

"List all function namespaces in the fr-par region"

"Deploy the container 'api-gateway' in namespace 'prod' and set up a cron trigger for every hour"

"Create a new serverless job definition with 2 vCPUs and 2GB memory"

AI - Inference & Generative APIs

"List available inference models in fr-par"

"Create an inference deployment using Llama 3 on a GPU-3070-S node"

"Send a chat completion request using the Scaleway generative API"

Security - Secrets & IAM

"List all secrets in the default project"

"Create a new secret called 'database-password' and add a version with the value 'supersecure'"

"List all IAM users and show which groups they belong to"

Tool Reference

Compute

| Tool | Description | |------|-------------| | scaleway_instances_list_servers | List Instance servers in a zone with optional filtering by name, tags, state, and project | | scaleway_instances_get_server | Get details of a specific Instance server by its ID and zone | | scaleway_instances_create_server | Create a new Instance server with the specified type, image, and configuration | | scaleway_instances_delete_server | Delete an Instance server (must be stopped first) | | scaleway_instances_server_action | Perform an action: poweron, poweroff, reboot, terminate, stop_in_place, or backup | | scaleway_instances_list_volumes | List Instance volumes in a zone with optional filtering | | scaleway_instances_get_volume | Get details of a specific Instance volume | | scaleway_instances_create_volume | Create a new Instance volume (l_ssd or b_ssd) | | scaleway_instances_delete_volume | Delete an Instance volume (must not be attached) | | scaleway_instances_list_security_groups | List Instance security groups in a zone | | scaleway_instances_get_security_group | Get details of a specific security group | | scaleway_instances_create_security_group | Create a new security group with inbound/outbound policies | | scaleway_instances_delete_security_group | Delete a security group | | scaleway_instances_list_ips | List Instance IPs in a zone | | scaleway_instances_create_ip | Reserve a new IP address (routed_ipv4 or routed_ipv6) | | scaleway_instances_delete_ip | Release an IP address | | scaleway_instances_attach_ip | Attach an IP address to a server | | scaleway_instances_list_snapshots | List Instance snapshots in a zone | | scaleway_instances_create_snapshot | Create a snapshot from a volume | | scaleway_instances_delete_snapshot | Delete a snapshot |

| Tool | Description | |------|-------------| | scaleway_elastic_metal_list_servers | List Elastic Metal servers in a zone | | scaleway_elastic_metal_get_server | Get detailed information about a specific server | | scaleway_elastic_metal_create_server | Create a new Elastic Metal dedicated server | | scaleway_elastic_metal_delete_server | Delete an Elastic Metal server | | scaleway_elastic_metal_install_server | Install an operating system on a server | | scaleway_elastic_metal_reboot_server | Reboot a server | | scaleway_elastic_metal_start_server | Start a stopped server | | scaleway_elastic_metal_stop_server | Stop a running server | | scaleway_elastic_metal_list_offers | List available server offers in a zone | | scaleway_elastic_metal_list_oss | List available operating systems | | scaleway_elastic_metal_get_bmc_access | Get BMC access credentials (time-limited) | | scaleway_elastic_metal_list_ips | List flexible IPs for Elastic Metal | | scaleway_elastic_metal_create_ip | Create a new flexible IP | | scaleway_elastic_metal_delete_ip | Delete a flexible IP |

| Tool | Description | |------|-------------| | scaleway_apple_silicon_list_servers | List Apple Silicon servers | | scaleway_apple_silicon_get_server | Get details of a specific server | | scaleway_apple_silicon_create_server | Create a new Apple Silicon server (24h minimum lease) | | scaleway_apple_silicon_delete_server | Delete a server (after 24h minimum period) | | scaleway_apple_silicon_reboot_server | Reboot a server | | scaleway_apple_silicon_reinstall_server | Reinstall the OS (all data erased) | | scaleway_apple_silicon_list_server_types | List available server types with specs | | scaleway_apple_silicon_list_os | List available macOS versions |

Storage & Databases

| Tool | Description | |------|-------------| | scaleway_block_storage_list_volumes | List block storage volumes in a zone | | scaleway_block_storage_get_volume | Get details of a specific volume | | scaleway_block_storage_create_volume | Create a new volume from scratch or from a snapshot | | scaleway_block_storage_update_volume | Update a volume (name, size, IOPS, or tags) | | scaleway_block_storage_delete_volume | Delete a volume | | scaleway_block_storage_list_snapshots | List block storage snapshots in a zone | | scaleway_block_storage_get_snapshot | Get details of a specific snapshot | | scaleway_block_storage_create_snapshot | Create a snapshot from a volume | | scaleway_block_storage_update_snapshot | Update a snapshot (name or tags) | | scaleway_block_storage_delete_snapshot | Delete a snapshot | | scaleway_block_storage_list_volume_types | List available volume types and specs |

| Tool | Description | |------|-------------| | scaleway_object_storage_list_buckets | List all S3 buckets in a region | | scaleway_object_storage_create_bucket | Create a new S3 bucket | | scaleway_object_storage_delete_bucket | Delete a bucket (must be empty) | | scaleway_object_storage_get_bucket_info | Get bucket details including versioning and object count | | scaleway_object_storage_list_objects | List objects with optional prefix filtering and pagination | | scaleway_object_storage_get_object_info | Get metadata for a specific object | | scaleway_object_storage_put_object | Upload a small object (base64-encoded) | | scaleway_object_storage_delete_object | Delete an object | | scaleway_object_storage_get_bucket_policy | Get the bucket policy (JSON) | | scaleway_object_storage_set_bucket_policy | Set or replace the bucket policy | | scaleway_object_storage_get_bucket_lifecycle | Get lifecycle rules | | scaleway_object_storage_set_bucket_lifecycle | Set lifecycle rules (expiration, transitions) | | scaleway_object_storage_get_bucket_versioning | Get versioning status | | scaleway_object_storage_set_bucket_versioning | Enable or suspend versioning |

| Tool | Description | |------|-------------| | scaleway_rdb_list_instances | List RDB instances in a region | | scaleway_rdb_get_instance | Get details of an RDB instance | | scaleway_rdb_create_instance | Create a new RDB instance (PostgreSQL or MySQL) | | scaleway_rdb_update_instance | Update an RDB instance | | scaleway_rdb_delete_instance | Delete an RDB instance | | scaleway_rdb_upgrade_instance | Upgrade node type, volume, or engine version | | scaleway_rdb_list_databases | List databases within an instance | | scaleway_rdb_create_database | Create a new database | | scaleway_rdb_delete_database | Delete a database | | scaleway_rdb_list_users | List users of an instance | | scaleway_rdb_create_user | Create a new user with optional admin privileges | | scaleway_rdb_update_user | Update a user's password or admin status | | scaleway_rdb_delete_user | Delete a user | | scaleway_rdb_list_backups | List database backups | | scaleway_rdb_create_backup | Create a manual backup | | scaleway_rdb_restore_backup | Restore a backup | | scaleway_rdb_list_endpoints | List endpoints (public, private network, load balancer) | | scaleway_rdb_create_endpoint | Create a new endpoint | | scaleway_rdb_delete_endpoint | Delete an endpoint | | scaleway_rdb_list_acl_rules | List ACL rules | | scaleway_rdb_add_acl_rules | Add ACL rules for network access | | scaleway_rdb_delete_acl_rules | Delete ACL rules | | scaleway_rdb_list_snapshots | List snapshots | | scaleway_rdb_create_snapshot | Create a snapshot | | scaleway_rdb_restore_snapshot | Restore from a snapshot | | scaleway_rdb_list_node_types | List available node types | | scaleway_rdb_list_database_engines | List available database engines and versions |

| Tool | Description | |------|-------------| | scaleway_mongodb_list_instances | List MongoDB instances | | scaleway_mongodb_get_instance | Get details of a MongoDB instance | | scaleway_mongodb_create_instance | Create a new MongoDB instance | | scaleway_mongodb_update_instance | Update a MongoDB instance | | scaleway_mongodb_delete_instance | Delete a MongoDB instance | | scaleway_mongodb_list_users | List users of an instance | | scaleway_mongodb_create_user | Create a new user | | scaleway_mongodb_update_user | Update a user's password | | scaleway_mongodb_delete_user | Delete a user | | scaleway_mongodb_list_snapshots | List MongoDB snapshots | | scaleway_mongodb_create_snapshot | Create a snapshot | | scaleway_mongodb_restore_snapshot | Restore a snapshot to a new instance | | scaleway_mongodb_delete_snapshot | Delete a snapshot | | scaleway_mongodb_list_node_types | List available node types | | scaleway_mongodb_list_versions | List available MongoDB versions |

| Tool | Description | |------|-------------| | scaleway_redis_list_clusters | List Redis clusters | | scaleway_redis_get_cluster | Get details of a Redis cluster | | scaleway_redis_create_cluster | Create a new Redis cluster | | scaleway_redis_update_cluster | Update a Redis cluster | | scaleway_redis_delete_cluster | Delete a Redis cluster | | scaleway_redis_list_cluster_metrics | Get cluster metrics (CPU, memory, connections) | | scaleway_redis_get_cluster_certificate | Get the TLS certificate | | scaleway_redis_renew_cluster_certificate | Renew the TLS certificate | | scaleway_redis_add_acl_rules | Add ACL rules | | scaleway_redis_delete_acl_rules | Delete ACL rules | | scaleway_redis_set_acl_rules | Replace all ACL rules | | scaleway_redis_add_endpoints | Add endpoints | | scaleway_redis_delete_endpoints | Delete an endpoint | | scaleway_redis_set_endpoints | Replace all endpoints | | scaleway_redis_list_node_types | List available node types | | scaleway_redis_list_cluster_versions | List available Redis versions |

| Tool | Description | |------|-------------| | scaleway_serverless_sqldb_list_databases | List Serverless SQL Databases | | scaleway_serverless_sqldb_get_database | Get details of a database | | scaleway_serverless_sqldb_create_database | Create a new database with auto-scaling CPU | | scaleway_serverless_sqldb_update_database | Update CPU scaling limits | | scaleway_serverless_sqldb_delete_database | Delete a database | | scaleway_serverless_sqldb_list_database_backups | List backups | | scaleway_serverless_sqldb_get_database_backup | Get backup details | | scaleway_serverless_sqldb_export_database_backup | Export a backup (download URL) | | scaleway_serverless_sqldb_restore_database | Restore from a backup |

Networking

| Tool | Description | |------|-------------| | scaleway_vpc_list_vpcs | List all VPCs in a region | | scaleway_vpc_get_vpc | Get details of a specific VPC | | scaleway_vpc_create_vpc | Create a new VPC | | scaleway_vpc_update_vpc | Update a VPC's name or tags | | scaleway_vpc_delete_vpc | Delete a VPC (must have no private networks) | | scaleway_vpc_list_private_networks | List private networks | | scaleway_vpc_get_private_network | Get details of a private network | | scaleway_vpc_create_private_network | Create a new private network within a VPC | | scaleway_vpc_update_private_network | Update a private network | | scaleway_vpc_delete_private_network | Delete a private network |

| Tool | Description | |------|-------------| | scaleway_lb_list_lbs | List load balancers in a zone | | scaleway_lb_get_lb | Get a specific load balancer | | scaleway_lb_create_lb | Create a new load balancer | | scaleway_lb_update_lb | Update a load balancer | | scaleway_lb_delete_lb | Delete a load balancer | | scaleway_lb_migrate_lb | Migrate to a different type | | scaleway_lb_list_frontends | List frontends | | scaleway_lb_get_frontend | Get a specific frontend | | scaleway_lb_create_frontend | Create a frontend | | scaleway_lb_update_frontend | Update a frontend | | scaleway_lb_delete_frontend | Delete a frontend | | scaleway_lb_list_backends | List backends | | scaleway_lb_get_backend | Get a specific backend | | scaleway_lb_create_backend | Create a backend | | scaleway_lb_update_backend | Update a backend | | scaleway_lb_delete_backend | Delete a backend | | scaleway_lb_add_backend_servers | Add server IPs to a backend | | scaleway_lb_remove_backend_servers | Remove server IPs from a backend | | scaleway_lb_set_backend_servers | Set the complete server IP list | | scaleway_lb_list_routes | List routes | | scaleway_lb_get_route | Get a specific route | | scaleway_lb_create_route | Create a route | | scaleway_lb_update_route | Update a route | | scaleway_lb_delete_route | Delete a route | | scaleway_lb_list_certificates | List certificates | | scaleway_lb_get_certificate | Get a specific certificate | | scaleway_lb_create_certificate | Create a certificate | | scaleway_lb_update_certificate | Update a certificate | | scaleway_lb_delete_certificate | Delete a certificate | | scaleway_lb_get_lb_stats | Get load balancer statistics | | scaleway_lb_list_lb_types | List available load balancer types |

| Tool | Description | |------|-------------| | scaleway_public_gateway_list_gateways | List Public Gateways | | scaleway_public_gateway_get_gateway | Get details of a gateway | | scaleway_public_gateway_create_gateway | Create a new gateway | | scaleway_public_gateway_update_gateway | Update a gateway | | scaleway_public_gateway_delete_gateway | Delete a gateway | | scaleway_public_gateway_list_gateway_networks | List gateway-to-private-network connections | | scaleway_public_gateway_get_gateway_network | Get a gateway network connection | | scaleway_public_gateway_create_gateway_network | Attach a gateway to a private network | | scaleway_public_gateway_update_gateway_network | Update a gateway network connection | | scaleway_public_gateway_delete_gateway_network | Detach a gateway from a private network | | scaleway_public_gateway_list_dhcps | List DHCP configurations | | scaleway_public_gateway_get_dhcp | Get a DHCP configuration | | scaleway_public_gateway_create_dhcp | Create a DHCP configuration | | scaleway_public_gateway_update_dhcp | Update a DHCP configuration | | scaleway_public_gateway_delete_dhcp | Delete a DHCP configuration | | scaleway_public_gateway_list_pat_rules | List PAT (port forwarding) rules | | scaleway_public_gateway_get_pat_rule | Get a PAT rule | | scaleway_public_gateway_create_pat_rule | Create a PAT rule | | scaleway_public_gateway_update_pat_rule | Update a PAT rule | | scaleway_public_gateway_delete_pat_rule | Delete a PAT rule | | scaleway_public_gateway_list_ips | List flexible IPs | | scaleway_public_gateway_get_ip | Get a flexible IP | | scaleway_public_gateway_create_ip | Reserve a new flexible IP | | scaleway_public_gateway_update_ip | Update a flexible IP | | scaleway_public_gateway_delete_ip | Release a flexible IP | | scaleway_public_gateway_list_gateway_types | List available gateway types |

| Tool | Description | |------|-------------| | scaleway_dns_list_zones | List DNS zones with optional filtering | | scaleway_dns_create_zone | Create a new DNS zone | | scaleway_dns_update_zone | Update a DNS zone | | scaleway_dns_delete_zone | Delete a DNS zone and all records | | scaleway_dns_clone_zone | Clone a zone to a new destination | | scaleway_dns_refresh_zone | Refresh a DNS zone | | scaleway_dns_list_records | List DNS records in a zone | | scaleway_dns_update_records | Batch update DNS records | | scaleway_dns_clear_records | Clear all records from a zone | | scaleway_dns_export_raw_zone | Export as BIND zone file | | scaleway_dns_import_raw_zone | Import from BIND zone file | | scaleway_dns_list_nameservers | List nameservers | | scaleway_dns_update_nameservers | Update nameservers | | scaleway_dns_get_ssl_certificate | Get SSL certificate | | scaleway_dns_create_ssl_certificate | Create SSL certificate | | scaleway_dns_delete_ssl_certificate | Delete SSL certificate | | scaleway_dns_get_tsig_key | Get TSIG key | | scaleway_dns_delete_tsig_key | Delete TSIG key |

| Tool | Description | |------|-------------| | scaleway_domain_registrar_list_domains | List all domains | | scaleway_domain_registrar_get_domain | Get domain details | | scaleway_domain_registrar_register_domain | Register a new domain | | scaleway_domain_registrar_renew_domain | Renew a domain | | scaleway_domain_registrar_transfer_domain | Transfer a domain from another registrar | | scaleway_domain_registrar_update_domain | Update domain contacts | | scaleway_domain_registrar_enable_auto_renew | Enable auto-renewal | | scaleway_domain_registrar_disable_auto_renew | Disable auto-renewal | | scaleway_domain_registrar_check_domain_availability | Check domain availability | | scaleway_domain_registrar_list_contacts | List registration contacts | | scaleway_domain_registrar_get_contact | Get contact details | | scaleway_domain_registrar_create_contact | Create a new contact | | scaleway_domain_registrar_update_contact | Update a contact | | scaleway_domain_registrar_list_tlds | List available TLDs with pricing | | scaleway_domain_registrar_get_tld | Get TLD details |

| Tool | Description | |------|-------------| | scaleway_ipam_list_ips | List IP addresses managed by IPAM | | scaleway_ipam_get_ip | Get details of a specific IP | | scaleway_ipam_book_ip | Book (reserve) a new IP address | | scaleway_ipam_release_ip | Release an IP reservation | | scaleway_ipam_update_ip | Update an IP (tags, reverse DNS) |

| Tool | Description | |------|-------------| | scaleway_edge_services_list_pipelines | List Edge Services pipelines | | scaleway_edge_services_get_pipeline | Get pipeline details | | scaleway_edge_services_create_pipeline | Create a new pipeline | | scaleway_edge_services_update_pipeline | Update a pipeline | | scaleway_edge_services_delete_pipeline | Delete a pipeline | | scaleway_edge_services_list_dns_stages | List DNS stages | | scaleway_edge_services_get_dns_stage | Get DNS stage details | | scaleway_edge_services_create_dns_stage | Create a DNS stage | | scaleway_edge_services_update_dns_stage | Update a DNS stage | | scaleway_edge_services_delete_dns_stage | Delete a DNS stage | | scaleway_edge_services_list_tls_stages | List TLS stages | | scaleway_edge_services_get_tls_stage | Get TLS stage details | | scaleway_edge_services_create_tls_stage | Create a TLS stage | | scaleway_edge_services_update_tls_stage | Update a TLS stage | | scaleway_edge_services_delete_tls_stage | Delete a TLS stage | | scaleway_edge_services_list_cache_stages | List cache stages | | scaleway_edge_services_get_cache_stage | Get cache stage details | | scaleway_edge_services_create_cache_stage | Create a cache stage | | scaleway_edge_services_update_cache_stage | Update a cache stage | | scaleway_edge_services_delete_cache_stage | Delete a cache stage | | scaleway_edge_services_list_backend_stages | List backend stages | | scaleway_edge_services_get_backend_stage | Get backend stage details | | scaleway_edge_services_create_backend_stage | Create a backend stage (S3 or LB origin) | | scaleway_edge_services_update_backend_stage | Update a backend stage | | scaleway_edge_services_delete_backend_stage | Delete a backend stage | | scaleway_edge_services_purge_cache | Purge cached content | | scaleway_edge_services_list_purge_requests | List purge requests | | scaleway_edge_services_get_purge_request | Get purge request details |

Serverless & Containers

| Tool | Description | |------|-------------| | scaleway_containers_list_namespaces | List container namespaces | | scaleway_containers_get_namespace | Get namespace details | | scaleway_containers_create_namespace | Create a new namespace | | scaleway_containers_update_namespace | Update a namespace | | scaleway_containers_delete_namespace | Delete a namespace | | scaleway_containers_list_containers | List containers in a namespace | | scaleway_containers_get_container | Get container details | | scaleway_containers_create_container | Create a new container | | scaleway_containers_update_container | Update container configuration | | scaleway_containers_delete_container | Delete a container | | scaleway_containers_deploy_container | Deploy a container | | scaleway_containers_list_crons | List cron triggers | | scaleway_containers_create_cron | Create a cron trigger | | scaleway_containers_update_cron | Update a cron trigger | | scaleway_containers_delete_cron | Delete a cron trigger | | scaleway_containers_list_domains | List custom domains | | scaleway_containers_create_domain | Map a custom domain | | scaleway_containers_delete_domain | Remove a custom domain | | scaleway_containers_create_token | Create an auth token | | scaleway_containers_delete_token | Delete an auth token |

| Tool | Description | |------|-------------| | scaleway_functions_list_namespaces | List function namespaces | | scaleway_functions_get_namespace | Get namespace details | | scaleway_functions_create_namespace | Create a new namespace | | scaleway_functions_update_namespace | Update a namespace | | scaleway_functions_delete_namespace | Delete a namespace | | scaleway_functions_list_functions | List functions in a namespace | | scaleway_functions_get_function | Get function details | | scaleway_functions_create_function | Create a new function | | scaleway_functions_update_function | Update a function | | scaleway_functions_delete_function | Delete a function | | scaleway_functions_deploy_function | Deploy a function (trigger build) | | scaleway_functions_list_crons | List cron triggers | | scaleway_functions_create_cron | Create a cron trigger | | scaleway_functions_update_cron | Update a cron trigger | | scaleway_functions_delete_cron | Delete a cron trigger | | scaleway_functions_list_domains | List custom domains | | scaleway_functions_create_domain | Attach a custom domain | | scaleway_functions_delete_domain | Remove a custom domain | | scaleway_functions_create_token | Create an access token | | scaleway_functions_delete_token | Delete an access token |

| Tool | Description | |------|-------------| | scaleway_jobs_list_definitions | List job definitions | | scaleway_jobs_get_definition | Get job definition details | | scaleway_jobs_create_definition | Create a new job definition | | scaleway_jobs_update_definition | Update a job definition | | scaleway_jobs_delete_definition | Delete a job definition | | scaleway_jobs_start | Start a new job run | | scaleway_jobs_list_runs | List job runs | | scaleway_jobs_get_run | Get job run details | | scaleway_jobs_stop_run | Stop a running job |

| Tool | Description | |------|-------------| | scaleway_k8s_list_clusters | List Kubernetes clusters | | scaleway_k8s_get_cluster | Get cluster details | | scaleway_k8s_create_cluster | Create a new cluster (Kapsule or Kosmos) | | scaleway_k8s_delete_cluster | Delete a cluster | | scaleway_k8s_upgrade_cluster | Upgrade cluster version | | scaleway_k8s_list_cluster_available_versions | List available upgrade versions | | scaleway_k8s_get_cluster_kubeconfig | Get the kubeconfig file | | scaleway_k8s_list_pools | List node pools | | scaleway_k8s_get_pool | Get node pool details | | scaleway_k8s_create_pool | Create a node pool | | scaleway_k8s_update_pool | Update a node pool | | scaleway_k8s_delete_pool | Delete a node pool | | scaleway_k8s_upgrade_pool | Upgrade a node pool version |

AI & Machine Learning

| Tool | Description | |------|-------------| | scaleway_inference_list_deployments | List inference deployments | | scaleway_inference_get_deployment | Get deployment details | | scaleway_inference_create_deployment | Create a new deployment | | scaleway_inference_update_deployment | Update a deployment | | scaleway_inference_delete_deployment | Delete a deployment | | scaleway_inference_list_deployment_events | List deployment events | | scaleway_inference_list_endpoints | List inference endpoints | | scaleway_inference_create_endpoint | Create an endpoint | | scaleway_inference_update_endpoint | Update an endpoint | | scaleway_inference_delete_endpoint | Delete an endpoint | | scaleway_inference_list_models | List available models | | scaleway_inference_get_model | Get model details | | scaleway_inference_list_node_types | List available node types | | scaleway_inference_get_eula | Get model EULA | | scaleway_inference_accept_eula | Accept model EULA |

| Tool | Description | |------|-------------| | scaleway_generative_apis_list_models | List available generative AI models | | scaleway_generative_apis_get_model | Get model details | | scaleway_generative_apis_chat_completion | Create a chat completion (OpenAI-compatible) | | scaleway_generative_apis_create_embedding | Create text embeddings |

| Tool | Description | |------|-------------| | scaleway_cockpit_get_cockpit | Get Cockpit info for a project | | scaleway_cockpit_activate_cockpit | Activate Cockpit | | scaleway_cockpit_deactivate_cockpit | Deactivate Cockpit | | scaleway_cockpit_list_data_sources | List data sources | | scaleway_cockpit_create_data_source | Create a data source | | scaleway_cockpit_delete_data_source | Delete a data source | | scaleway_cockpit_list_tokens | List tokens | | scaleway_cockpit_create_token | Create a token | | scaleway_cockpit_delete_token | Delete a token | | scaleway_cockpit_list_grafana_users | List Grafana users | | scaleway_cockpit_create_grafana_user | Create a Grafana user | | scaleway_cockpit_delete_grafana_user | Delete a Grafana user | | scaleway_cockpit_reset_grafana_user_password | Reset a Grafana user's password | | scaleway_cockpit_get_alert_manager | Get alert manager info | | scaleway_cockpit_enable_alert_manager | Enable alert manager | | scaleway_cockpit_disable_alert_manager | Disable alert manager | | scaleway_cockpit_list_contact_points | List alert contact points | | scaleway_cockpit_create_contact_point | Create a contact point | | scaleway_cockpit_delete_contact_point | Delete a contact point | | scaleway_cockpit_list_managed_alerts_contact_points | List managed alerts contact points | | scaleway_cockpit_enable_managed_alerts | Enable managed alerts | | scaleway_cockpit_disable_managed_alerts | Disable managed alerts |

Security & Identity

| Tool | Description | |------|-------------| | scaleway_iam_list_users | List IAM users | | scaleway_iam_get_user | Get user details | | scaleway_iam_create_user | Invite a new user | | scaleway_iam_update_user | Update a user | | scaleway_iam_delete_user | Remove a user | | scaleway_iam_list_applications | List IAM applications | | scaleway_iam_get_application | Get application details | | scaleway_iam_create_application | Create a new application | | scaleway_iam_update_application | Update an application | | scaleway_iam_delete_application | Delete an application | | scaleway_iam_list_api_keys | List API keys | | scaleway_iam_get_api_key | Get API key details | | scaleway_iam_create_api_key | Create a new API key | | scaleway_iam_update_api_key | Update an API key | | scaleway_iam_delete_api_key | Delete an API key | | scaleway_iam_list_policies | List policies | | scaleway_iam_get_policy | Get policy details | | scaleway_iam_create_policy | Create a new policy | | scaleway_iam_update_policy | Update a policy | | scaleway_iam_delete_policy | Delete a policy | | scaleway_iam_list_rules | List rules for a policy | | scaleway_iam_create_rule | Create a new rule | | scaleway_iam_update_rule | Update a rule | | scaleway_iam_delete_rule | Delete a rule | | scaleway_iam_list_groups | List groups | | scaleway_iam_get_group | Get group details | | scaleway_iam_create_group | Create a new group | | scaleway_iam_update_group | Update a group | | scaleway_iam_delete_group | Delete a group | | scaleway_iam_add_group_member | Add a user or app to a group | | scaleway_iam_remove_group_member | Remove a user or app from a group | | scaleway_iam_list_permission_sets | List available permission sets |

| Tool | Description | |------|-------------| | scaleway_secret_manager_list_secrets | List secrets with filtering | | scaleway_secret_manager_get_secret | Get secret metadata | | scaleway_secret_manager_create_secret | Create a new secret | | scaleway_secret_manager_update_secret | Update secret metadata | | scaleway_secret_manager_delete_secret | Delete a secret and all versions | | scaleway_secret_manager_list_secret_versions | List secret versions | | scaleway_secret_manager_get_secret_version | Get version metadata | | scaleway_secret_manager_create_secret_version | Create a new version | | scaleway_secret_manager_access_secret_version | Access the secret data (base64) | | scaleway_secret_manager_disable_secret_version | Disable a version | | scaleway_secret_manager_enable_secret_version | Enable a version | | scaleway_secret_manager_destroy_secret_version | Permanently destroy a version | | scaleway_secret_manager_protect_secret | Enable deletion protection | | scaleway_secret_manager_unprotect_secret | Disable deletion protection | | scaleway_secret_manager_list_tags | List tags across secrets | | scaleway_secret_manager_add_secret_owner | Grant a Scaleway product access to a secret |

| Tool | Description | |------|-------------| | scaleway_key_manager_list_keys | List cryptographic keys | | scaleway_key_manager_get_key | Get key metadata | | scaleway_key_manager_create_key | Create a new key | | scaleway_key_manager_update_key | Update key metadata and rotation policy | | scaleway_key_manager_delete_key | Permanently delete a key (irreversible) | | scaleway_key_manager_rotate_key | Rotate key material | | scaleway_key_manager_protect_key | Protect a key from deletion | | scaleway_key_manager_unprotect_key | Remove deletion protection | | scaleway_key_manager_enable_key | Enable a key | | scaleway_key_manager_disable_key | Disable a key | | scaleway_key_manager_encrypt | Encrypt data (max 64KB) | | scaleway_key_manager_decrypt | Decrypt ciphertext | | scaleway_key_manager_generate_data_key | Generate a data encryption key |

Managed Services

| Tool | Description | |------|-------------| | scaleway_nats_list_accounts | List NATS accounts | | scaleway_nats_get_account | Get account details | | scaleway_nats_create_account | Create a new NATS account | | scaleway_nats_update_account | Update an account | | scaleway_nats_delete_account | Delete an account | | scaleway_nats_list_credentials | List credentials | | scaleway_nats_get_credentials | Get credentials details | | scaleway_nats_create_credentials | Create new credentials | | scaleway_nats_delete_credentials | Delete credentials |

| Tool | Description | |------|-------------| | scaleway_sqs_activate | Activate SQS service for a project | | scaleway_sqs_deactivate | Deactivate SQS service | | scaleway_sqs_get_info | Get SQS service info and endpoint | | scaleway_sqs_create_credentials | Create SQS credentials | | scaleway_sqs_delete_credentials | Delete SQS credentials | | scaleway_sqs_get_credentials | Get credentials details | | scaleway_sqs_list_credentials | List all credentials | | scaleway_sqs_update_credentials | Update credentials |

| Tool | Description | |------|-------------| | scaleway_sns_activate | Activate SNS service for a project | | scaleway_sns_deactivate | Deactivate SNS service | | scaleway_sns_get_info | Get SNS service info and endpoint | | scaleway_sns_list_credentials | List SNS credentials | | scaleway_sns_get_credentials | Get credentials details | | scaleway_sns_create_credentials | Create SNS credentials with permissions | | scaleway_sns_update_credentials | Update credentials | | scaleway_sns_delete_credentials | Delete credentials |

| Tool | Description | |------|-------------| | scaleway_tem_list_domains | List email domains | | scaleway_tem_get_domain | Get domain details | | scaleway_tem_create_domain | Register a new domain | | scaleway_tem_revoke_domain | Revoke a domain | | scaleway_tem_check_domain | Trigger DNS verification | | scaleway_tem_get_domain_last_status | Get last DNS verification status | | scaleway_tem_list_emails | List transactional emails | | scaleway_tem_get_email | Get email details | | scaleway_tem_create_email | Send a transactional email | | scaleway_tem_cancel_email | Cancel a queued email | | scaleway_tem_get_statistics | Get email sending statistics | | scaleway_tem_list_webhooks | List webhooks | | scaleway_tem_create_webhook | Create a webhook | | scaleway_tem_update_webhook | Update a webhook | | scaleway_tem_delete_webhook | Delete a webhook |

| Tool | Description | |------|-------------| | scaleway_iot_list_hubs | List IoT hubs | | scaleway_iot_get_hub | Get hub details | | scaleway_iot_create_hub | Create a new hub | | scaleway_iot_update_hub | Update a hub | | scaleway_iot_delete_hub | Delete a hub | | scaleway_iot_enable_hub | Enable a hub | | scaleway_iot_disable_hub | Disable a hub | | scaleway_iot_get_hub_ca | Get hub CA certificate | | scaleway_iot_set_hub_ca | Set custom CA certificate | | scaleway_iot_list_devices | List devices | | scaleway_iot_get_device | Get device details | | scaleway_iot_create_device | Create a new device | | scaleway_iot_update_device | Update a device | | scaleway_iot_delete_device | Delete a device | | scaleway_iot_enable_device | Enable a device | | scaleway_iot_disable_device | Disable a device | | scaleway_iot_get_device_certificate | Get device certificate | | scaleway_iot_renew_device_certificate | Renew device certificate | | scaleway_iot_set_device_certificate | Set custom device certificate | | scaleway_iot_get_device_metrics | Get device metrics | | scaleway_iot_list_routes | List routes | | scaleway_iot_get_route | Get route details | | scaleway_iot_create_route | Create a route (S3, database, or REST) | | scaleway_iot_update_route | Update a route | | scaleway_iot_delete_route | Delete a route | | scaleway_iot_list_networks | List networks | | scaleway_iot_get_network | Get network details | | scaleway_iot_create_network | Create a network | | scaleway_iot_delete_network | Delete a network |

| Tool | Description | |------|-------------| | scaleway_registry_list_namespaces | List registry namespaces | | scaleway_registry_get_namespace | Get namespace details | | scaleway_registry_create_namespace | Create a new namespace | | scaleway_registry_update_namespace | Update a namespace | | scaleway_registry_delete_namespace | Delete a namespace | | scaleway_registry_list_images | List container images | | scaleway_registry_get_image | Get image details | | scaleway_registry_update_image | Update image visibility | | scaleway_registry_delete_image | Delete an image | | scaleway_registry_list_tags | List image tags | | scaleway_registry_get_tag | Get tag details | | scaleway_registry_delete_tag | Delete a tag |

| Tool | Description | |------|-------------| | scaleway_marketplace_list_images | List marketplace images | | scaleway_marketplace_get_image | Get image details | | scaleway_marketplace_list_local_images | List local images by zone | | scaleway_marketplace_get_local_image | Get local image details | | scaleway_marketplace_list_categories | List categories | | scaleway_marketplace_get_category | Get category details | | scaleway_marketplace_list_versions | List image versions | | scaleway_marketplace_get_version | Get version details |

Account & Billing

| Tool | Description | |------|-------------| | scaleway_account_list_projects | List projects in an organization | | scaleway_account_get_project | Get project details | | scaleway_account_create_project | Create a new project | | scaleway_account_update_project | Update a project | | scaleway_account_delete_project | Delete a project (must be empty) |

| Tool | Description | |------|-------------| | scaleway_billing_list_consumptions | List consumption data | | scaleway_billing_list_invoices | List invoices | | scaleway_billing_get_invoice | Get invoice details | | scaleway_billing_download_invoice | Download invoice as PDF | | scaleway_billing_list_discounts | List active discounts |

| Tool | Description | |------|-------------| | scaleway_webhosting_list_hostings | List web hostings | | scaleway_webhosting_get_hosting | Get hosting details | | scaleway_webhosting_create_hosting | Create a new hosting | | scaleway_webhosting_update_hosting | Update a hosting | | scaleway_webhosting_delete_hosting | Delete a hosting | | scaleway_webhosting_restore_hosting | Restore a deleted hosting | | scaleway_webhosting_get_dns_records | Get DNS records | | scaleway_webhosting_list_offers | List available offers | | scaleway_webhosting_list_control_panels | List available control panels |

Managing Tool Access

With 539 tools available, you may want to limit which tools are exposed to your AI assistant for focused sessions.

Claude Code

Use the allowedTools field in your .mcp.json to filter tools by pattern:

{
  "mcpServers": {
    "scaleway": {
      "command": "npx",
      "args": ["mcp-scaleway"],
      "env": {
        "SCW_ACCESS_KEY": "...",
        "SCW_SECRET_KEY": "...",
        "SCW_DEFAULT_PROJECT_ID": "..."
      },
      "allowedTools": ["scaleway_k8s_*", "scaleway_instances_*"]
    }
  }
}

Common Filter Patterns

| Use Case | Pattern | |----------|---------| | Kubernetes only | scaleway_k8s_* | | Compute only | scaleway_instances_*, scaleway_elastic_metal_*, scaleway_apple_silicon_* | | Databases only | scaleway_rdb_*, scaleway_mongodb_*, scaleway_redis_* | | Serverless only | scaleway_functions_*, scaleway_containers_*, scaleway_jobs_* | | Networking only | scaleway_vpc_*, scaleway_lb_*, scaleway_dns_* | | AI only | scaleway_inference_*, scaleway_generative_apis_* | | Security only | scaleway_iam_*, scaleway_secret_manager_*, scaleway_key_manager_* | | Read-only | scaleway_*_list_*, scaleway_*_get_* |

Development

Prerequisites

Bun 1.x
Node.js 18+ (for some dev tooling)

Commands

# Start the MCP server
bun run start

# Lint (Biome)
bun run lint
bun run lint:fix

# Type check
bun x tsc --noEmit

# Run unit + contract tests
bun run test

# Run tests in watch mode
bun run test:watch

# Run unit tests only (CI-safe, no external deps)
bun x vitest run --config tests/vitest.config.ts --dir tests/unit

# Run contract tests only
bun x vitest run --config tests/vitest.config.ts --dir tests/contract

# Run tests with coverage (100% enforced)
bun run test -- --coverage.enabled

# Validate API parity matrix
bun run test:parity

Testing Requirements

100% code coverage (line and branch) - enforced in CI
Full API contract parity - every Scaleway API endpoint must have a contract test
Parity matrix - tests/parity-matrix.json maps all API operations to tests

CI/CD Pipeline

| Gate | Requirement | |------|-------------| | Lint | Zero Biome violations | | Type Check | Zero TypeScript errors | | Tests | All unit + contract tests pass | | Coverage | 100% line and branch coverage | | API Parity | All operations in parity-matrix.json have tests |

Architecture

src/
├── main.ts                      # Entry point
├── server.ts                    # MCP server creation and tool registration
├── shared/
│   ├── auth.ts                 # Env var credential loading
│   ├── client.ts               # Scaleway SDK client (singleton)
│   ├── errors.ts               # HTTP error mapping
│   ├── pagination.ts           # Pagination helpers
│   └── types.ts                # Shared Zod schemas
└── tools/
    ├── index.ts                # Registers all 36 service tool groups
    └── {service}/              # One directory per Scaleway service
        ├── index.ts            # Tool registration (server.tool() calls)
        ├── types.ts            # Zod input schemas
        └── handlers.ts         # Scaleway API call logic

tests/
├── unit/                       # Unit tests (CI)
├── contract/                   # API contract tests (CI)
├── api/                        # Integration tests (local only, needs Scaleway)
├── parity-matrix.json          # API operation → test mapping
└── vitest.config.ts            # Test config (100% coverage enforced)

Each tool follows the same three-file pattern:

index.ts - Registers tools with the MCP server, validates inputs with Zod, calls handlers
types.ts - Defines Zod schemas for all tool parameters
handlers.ts - Makes Scaleway API calls and formats responses

Troubleshooting

Authentication Errors

"SCW_ACCESS_KEY environment variable is required"

Ensure all three required environment variables are set:

export SCW_ACCESS_KEY="SCWxxxxxxxxxxxxxxxxx"
export SCW_SECRET_KEY="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
export SCW_DEFAULT_PROJECT_ID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

If using Claude Desktop or Claude Code, check that the env block in your configuration file includes all three variables.

Connection Issues

Server starts but no tools appear

Verify the server is running: npx mcp-scaleway should start without errors
Check that your MCP client config is correct
Ensure node (18+) is in your PATH

"Permission denied" errors from Scaleway API

Your API key may not have permissions for the requested service
Check your IAM policies in the Scaleway console
Some operations require Organization-level permissions (set SCW_DEFAULT_ORGANIZATION_ID)

Region/Zone Errors

"Resource not found" when the resource exists

Check that you're querying the correct region or zone
Default region is fr-par, default zone is fr-par-1
Override defaults with SCW_DEFAULT_REGION and SCW_DEFAULT_ZONE
Some services are only available in specific regions

Common Issues

| Issue | Solution | |-------|----------| | bun: command not found | Install Bun: curl -fsSL https://bun.sh/install \| bash | | Cannot find module | Run bun install in the project directory | | Rate limiting errors | Scaleway has per-service rate limits; add delays between bulk operations | | Timeout errors | Some operations (server creation, cluster provisioning) take time; check status with get/list tools |

Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/my-feature)
Make your changes
Run lint and tests (bun run lint && bun run test)
Commit your changes (git commit -m 'Add my feature')
Push to your branch (git push origin feature/my-feature)
Open a Pull Request

Support

If you find this project useful, consider sponsoring its development:

Your support helps maintain and improve the MCP Scaleway server.

License

MIT

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

mcp-scaleway

Table of Contents

Overview

Features

Quick Start

Installation

Prerequisites

Via npx (no install needed)

Global install

From source

Authentication

Required

Optional

Available Regions

Configuration

Claude Desktop

Claude Code

Other MCP Clients

Usage Examples

Compute - Managing Instances

Storage - Object Storage

Kubernetes - Cluster Management

Serverless - Functions & Containers

AI - Inference & Generative APIs

Security - Secrets & IAM

Tool Reference

Compute

Storage & Databases

Networking

Serverless & Containers

AI & Machine Learning

Security & Identity

Managed Services

Account & Billing

Managing Tool Access

Claude Code

Common Filter Patterns

Development

Prerequisites

Commands

Testing Requirements

CI/CD Pipeline

Architecture

Troubleshooting

Authentication Errors

Connection Issues

Region/Zone Errors

Common Issues

Contributing

Support

License