Create Scaleway cluster
create_scaleway_clusterCreate and provision a new self-hosted Kubernetes cluster on Scaleway Instances. Requires a Scaleway credential, SSH key credential, region, and zone. Creates a new private network by default; pass private_network_id to attach an existing one. The default public gateway type is 'VPC-GW-S'. Use list_provider_credentials to find credential IDs and list_instance_types with provider='scaleway' for instance sizes (e.g. 'DEV1-M', 'GP1-S'). Kapsule (managed) creation remains available in the portal and CLI. Only available to organisations with Scaleway enabled.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"credential_id": "<credential_id>",
"ssh_key_credential_id": "<ssh_key_credential_id>",
"region": "<region>",
"zone": "<zone>"
},
"name": "create_scaleway_cluster"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Cluster name. Must be unique within the organisation. | |
| zone | Yes | Scaleway zone within the region (e.g., 'fr-par-1', 'nl-ams-1'). | |
| region | Yes | Scaleway region (e.g., 'fr-par', 'nl-ams', 'pl-waw'). | |
| description | No | Optional cluster description. | |
| environment | No | What the cluster is for. Ankra's autonomy gates treat a cluster like production until a person confirms what it is for. A label named here is that confirmation only when a member confirms this call's card in Ankra chat; over MCP, or with no member's confirmation, it is recorded as set by automation and confirms nothing (a production label is still honoured). Omit it and the cluster is labelled development, recorded as a default nobody confirmed. | |
| gateway_api | No | Also serve the Kubernetes Gateway API: the cluster's Traefik serves Gateway API routes (HTTPRoute) next to Ingress, and Ingress keeps working. Adds the Gateway API CRDs, a shared traefik-gateway Gateway in the traefik namespace (a plain HTTP listener that accepts routes from every namespace), and cert-manager and external-dns support for those routes. Needs the networking stack (on by default): asking for it with include_networking=false is refused. Default: false. Set at create only; no tool turns it on or off on an existing cluster. | |
| worker_type | No | Instance type for worker nodes. Default: 'DEV1-M'. | |
| bastion_port | No | Managed bastion SSH port on the gateway: 1024-59999, or exactly 61000. Default: 61000. | |
| distribution | No | Kubernetes distribution. Default: 'kubeadm' (vanilla upstream Kubernetes with Cilium). 'k3s' is the lightweight alternative. | |
| gateway_type | No | Scaleway VPC public gateway type (e.g., 'VPC-GW-S', 'VPC-GW-M'). Default: 'VPC-GW-S'. | |
| worker_count | No | Number of worker nodes. Default: 1. | |
| credential_id | Yes | UUID of the Scaleway API credential. Get from list_provider_credentials with provider='scaleway'. | |
| network_ip_range | No | Optional CIDR for the new private network (e.g., '10.64.0.0/20'). | |
| retention_policy | No | Storage retention on teardown. Default: 'retain'. | |
| control_plane_type | No | Instance type for control plane nodes. Default: 'DEV1-M'. | |
| kubernetes_version | No | Kubernetes version. If not specified, uses the latest supported version. | |
| private_network_id | No | Existing Scaleway private network ID to attach; omit to create a new private network. | |
| control_plane_count | No | Number of control plane nodes. Default: 1. | |
| ssh_key_credential_id | Yes | UUID of the SSH key credential. Get from list_provider_credentials with provider='ssh-key'. |