Create Morpheus cluster
create_morpheus_clusterCreate and provision a new Kubernetes cluster on HPE Morpheus. Requires an HPE Morpheus credential, an SSH key credential, and the numeric Morpheus placement ids (group, cloud, network, layout) plus service-plan ids for the bastion, control plane, and workers. Use list_morpheus_options to resolve every id. The cluster will begin provisioning immediately after confirmation.
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>",
"group_id": "<group_id>",
"cloud_id": "<cloud_id>",
"network_id": "<network_id>",
"layout_id": "<layout_id>",
"bastion_plan_id": "<bastion_plan_id>",
"control_plane_plan_id": "<control_plane_plan_id>",
"worker_plan_id": "<worker_plan_id>"
},
"name": "create_morpheus_cluster"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cni | No | Cluster CNI. Default: 'cilium' when the distribution is kubeadm (the default distribution), 'flannel' when it is k3s. The kubeadm install sets up cilium only. | |
| name | Yes | Cluster name. Must be unique within the organisation. | |
| cloud_id | Yes | Morpheus cloud id (from list_morpheus_options). | |
| group_id | Yes | Morpheus group id (from list_morpheus_options). | |
| layout_id | Yes | Morpheus instance layout id (from list_morpheus_options). | |
| network_id | Yes | Morpheus network id (from list_morpheus_options). | |
| 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. | |
| node_groups | No | Optional heterogeneous worker pools. When provided, worker_count and worker_plan_id are ignored. Each entry creates `count` workers on the given service plan with the given labels and taints. | |
| distribution | No | Kubernetes distribution. Default: 'kubeadm'. | |
| etcd_plan_id | No | Optional service-plan id for external etcd nodes. Falls back to control_plane_plan_id. | |
| worker_count | No | Number of worker nodes when node_groups is not provided. Must be at least 1 unless node_groups is supplied. Default: 1. | |
| credential_id | Yes | UUID of the HPE Morpheus credential. | |
| etcd_topology | No | etcd topology. 'external' requires distribution 'kubeadm'. Default: 'stacked'. | |
| worker_plan_id | Yes | Service-plan id for worker nodes (from list_morpheus_options). | |
| bastion_plan_id | Yes | Service-plan id for the bastion VM (from list_morpheus_options). | |
| etcd_node_count | No | Number of external etcd nodes (3 or 5). Only used when etcd_topology is 'external'. Default: 3. | |
| virtual_image_id | No | Optional Morpheus virtual image id to clone the VMs from. | |
| include_networking | No | Publish the Ankra networking stack after bootstrap (disables the k3s-bundled Traefik). Default: true. | |
| kubernetes_version | No | Kubernetes version. If not specified, uses the latest stable version. | |
| control_plane_count | No | Number of control plane nodes (1 or 3 for HA). Default: 1. | |
| control_plane_plan_id | Yes | Service-plan id for control plane nodes (from list_morpheus_options). | |
| ssh_key_credential_id | Yes | UUID of the SSH key credential to authorise on the cluster servers. |