skycloak_create_cluster
Provisions a new Keycloak cluster asynchronously, returning it in provisioning state; poll skycloak_get_cluster until its status becomes available.
Instructions
Provision a new Keycloak cluster. Asynchronous: the returned cluster starts in a provisioning state — poll skycloak_get_cluster until its status is 'available'. Requires --allow-writes.
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>",
"size": "<size>",
"version": "<version>",
"location": "<location>"
},
"name": "skycloak_create_cluster"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | human-readable cluster name | |
| size | Yes | instance size: small, medium, or large (case-insensitive) | |
| type | No | cluster type: keycloak or tidecloak (case-insensitive); defaults to keycloak | |
| version | Yes | Keycloak version, e.g. 26.1 | |
| location | Yes | region: us (US East), us-west (US West, only for workspaces granted access), ca, au, or eu (case-insensitive); skycloak_list_cluster_locations shows which ones this workspace can use | |
| auto_upgrade_enabled | No | enable automatic patch upgrades | |
| maintenance_window_enabled | No | whether the creation maintenance window is active | |
| maintenance_window_timezone | No | maintenance-window IANA timezone, e.g. Europe/Berlin | |
| maintenance_window_end_local | No | maintenance-window local end time in HH:MM format | |
| maintenance_window_start_local | No | maintenance-window local start time in HH:MM format | |
| maintenance_window_days_of_week | No | maintenance-window days, 0=Sunday through 6=Saturday |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| url | No | ||
| name | Yes | ||
| size | Yes | ||
| type | Yes | ||
| status | Yes | ||
| version | Yes | ||
| location | Yes | ||
| created_at | No | ||
| updated_at | No | ||
| auto_upgrade_enabled | Yes |