Local MCP server (stdio) covering the entire Hetzner Cloud API as 201 typed tools — read and write.
Strong hand-tuned wrappers with clear naming (verb_noun pattern), comprehensive schemas, and good parameter descriptions. All 10 tools have explicit input schemas with type constraints and enums where appropriate. Descriptions are concise (50-150 chars) and action-oriented. Tool annotations (readOnlyHint, destructiveHint) are present. However, output schemas are not documented, LLMs cannot predict response structure. Error handling is minimal; no recovery guidance. Some parameter descriptions lack format/constraint details (e.g., 'ISO-8601 timestamp' in hcloud_get_server_metrics but no validation shown). Missing batch operations and some convenience parameters.
Apply a firewall (by id or by name) to a server. Hand-tuned wrapper around POST /firewalls/{id}/actions/apply_to_resources.
Fetch a single Hetzner Cloud server by numeric id OR by exact name. Hand-tuned wrapper; use hcloud_get_server_raw for the id-only generated tool.
Fetch a server's metrics (cpu / disk / network). Accept id OR name. Defaults to the last hour with step=60s. Hand-tuned wrapper.
List Hetzner Cloud servers. Hand-tuned wrapper around GET /servers with an optional client-side name_contains filter and a default sort of 'name'. Use hcloud_list_servers_raw for the unfiltered, generator-built tool.
Toggle Hetzner-managed automatic backups on a server. Hand-tuned wrapper around enable_backup / disable_backup actions.
Output schemas not documented. LLMs cannot predict response structure (fields, types, pagination). Forces agents to guess what data is available after each call.
Error handling lacks recovery guidance. No indication of retryability, user-fixable vs fatal errors, or next steps. Raw API errors (4xx/5xx) converted to ToolResult but no actionable messages.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | <=2025-11-25 | v2 |
Change a server's hardware type. Defaults upgrade_disk to false (disk size kept; safer to downgrade later). Hand-tuned wrapper; polls the resulting action by default.
Run a power operation on a server (poweron / poweroff / reboot / shutdown / reset). Hand-tuned wrapper that polls the resulting action by default.
Rebuild a server from an image. Accept image_id (integer) OR image_name (string). Hand-tuned wrapper; polls the resulting action by default.
Toggle Hetzner rescue mode on a server. When enabling, defaults type to 'linux64' and accepts ssh_keys (array of SSH-key ids). Hand-tuned wrapper.
Create an image (snapshot or backup) of a server. Default type is 'snapshot'. Hand-tuned wrapper that polls the resulting action.
Destructive operations (rebuild, change_type, power) lack confirmation/dry-run support. Agents can irreversibly modify infrastructure without explicit user approval.
Parameter descriptions lack format/constraint details. E.g., 'ISO-8601 timestamp' in hcloud_get_server_metrics but no validation shown; 'server_type' in hcloud_server_change_type has no enum or examples.
No batch operations. Agents must call hcloud_server_power 10 times to reboot 10 servers sequentially, wasting tokens and latency. Batch variants would improve efficiency.