Create DigitalOcean cluster
create_digitalocean_clusterCreate and provision a new Kubernetes cluster on DigitalOcean. Requires a DigitalOcean API credential, SSH key credential, and a region. The cluster will begin provisioning immediately after creation. Use list_provider_credentials to find credential IDs; sizes are DigitalOcean droplet size slugs (e.g. 's-2vcpu-4gb') - list_instance_types does not cover DigitalOcean.
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>"
},
"name": "create_digitalocean_cluster"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Cluster name. Must be unique within the organisation. | |
| region | Yes | DigitalOcean region slug (e.g., 'nyc3', 'ams3', 'fra1', 'sfo3'). | |
| 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_size | No | DigitalOcean droplet size for worker nodes. Default: 's-2vcpu-4gb'. | |
| bastion_size | No | DigitalOcean droplet size for the bastion host. Default: 's-1vcpu-1gb'. | |
| distribution | No | Kubernetes distribution. Default: 'kubeadm' (vanilla upstream Kubernetes with Cilium). 'k3s' is the lightweight alternative. | |
| worker_count | No | Number of worker nodes. Default: 1. | |
| credential_id | Yes | UUID of the DigitalOcean API credential. Get from list_provider_credentials with provider='digitalocean'. | |
| control_plane_size | No | DigitalOcean droplet size for control plane nodes. Default: 's-2vcpu-4gb'. | |
| kubernetes_version | No | Version for the chosen distribution. With the default distribution (kubeadm) pass a plain upstream tag such as v1.36.4, from list_kubernetes_versions with engine 'kubeadm'. With distribution 'k3s' pass a k3s build such as v1.35.7+k3s1, from engine 'k3s' (a bare patch resolves to its newest +k3sN build). A +k3sN build without distribution 'k3s' is refused. Omit it to install the catalogue's stable version for the distribution. | |
| 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'. |