server_manage
Manage server lifecycle: add existing servers to local config, unregister without affecting running instances, or permanently delete from cloud provider. Supports Coolify, Dokploy, or bare servers.
Instructions
Manage Kastell servers. Actions: 'add' registers an existing Coolify or bare server to local config (validates API token, optionally verifies Coolify via SSH — pass mode:'bare' for servers without Coolify). 'remove' unregisters a server from local config only (cloud server keeps running). 'destroy' PERMANENTLY DELETES the server from the cloud provider and removes from local config. Requires provider API tokens as environment variables. Destroy is blocked when KASTELL_SAFE_MODE=true. Server mode for 'add' action: 'coolify', 'dokploy', or 'bare'. Default: coolify
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action: 'add' register an existing server, 'remove' unregister from local config (server stays running), 'destroy' permanently delete from cloud provider AND local config | |
| server | No | Server name or IP (required for 'remove' and 'destroy' actions) | |
| provider | No | Cloud provider: 'hetzner', 'digitalocean', 'vultr', 'linode' (required for 'add' action). If omitted and client supports elicitation, a form will be shown. | |
| ip | No | Server public IP address (required for 'add' action). If omitted and client supports elicitation, a form will be shown. | |
| name | No | Server name, 3-63 chars, lowercase alphanumeric and hyphens (required for 'add' action). If omitted and client supports elicitation, a form will be shown. | |
| skipVerify | No | Skip Coolify SSH verification when adding a server (only for 'add' action) | |
| mode | No | Server mode for 'add' action: 'coolify', 'dokploy', or 'bare'. Default: coolify | coolify |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |