Hetzner Cloud MCP by usefulapi
Servers, volumes, networks, firewalls, load balancers, pricing and safe power operations.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (3)
- LOWin hetzner_reboot_server
- LOWin hetzner_create_image_from_server
- LOWin hetzner_change_server_protection
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"hetzner-cloud": {
"url": "https://hetzner-cloud.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://hetzner-cloud.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (32)
🟢hetzner_list_servers(name, status, label_selector, page, per_page)
List the servers in the token's project, optionally filtered by name, status or a label selector. Hetzner Cloud: GET /servers.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the server with this exact name.",
"type": "string"
},
"status": {
"description": "Only servers in this power state.",
"type": "string",
"enum": [
"running",
"initializing",
"starting",
"stopping",
"off",
"deleting",
"migrating",
"rebuilding",
"unknown"
]
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_server(server_id)
Fetch a single server with its type, image, IPs, volumes, networks and protection flags. Hetzner Cloud: GET /servers/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server's numeric id."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_server_metrics(server_id, type, start, end, step)
Fetch CPU, disk or network time series for one server over a window. Hetzner Cloud: GET /servers/{id}/metrics.
Eingabe-Schema
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server's numeric id."
},
"type": {
"type": "string",
"enum": [
"cpu",
"disk",
"network"
],
"description": "Which metric family to return."
},
"start": {
"type": "string",
"description": "ISO-8601 start of the window."
},
"end": {
"type": "string",
"description": "ISO-8601 end of the window."
},
"step": {
"description": "Resolution in seconds.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"server_id",
"type",
"start",
"end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_server_types(name, page, per_page)
List the available server types with their cores, memory, disk and hourly and monthly prices — read this before creating a server. Hetzner Cloud: GET /server_types.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the type with this name, e.g. cx22.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_images(type, name, architecture, label_selector, page, ...)
List OS images, snapshots and backups you can boot or restore from. Hetzner Cloud: GET /images.
Eingabe-Schema
{
"type": "object",
"properties": {
"type": {
"description": "Only images of this kind.",
"type": "string",
"enum": [
"system",
"snapshot",
"backup",
"app"
]
},
"name": {
"description": "Only the image with this name, e.g. ubuntu-24.04.",
"type": "string"
},
"architecture": {
"description": "Only images for this CPU architecture.",
"type": "string",
"enum": [
"x86",
"arm"
]
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_locations(name)
List the datacentre locations (city, country, network zone) servers can run in. Hetzner Cloud: GET /locations.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the location with this name, e.g. fsn1.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_pricing
Fetch the full price list for the project's currency — server types, volumes, traffic, floating IPs, load balancers and backups. Hetzner Cloud: GET /pricing.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_action(action_id)
Fetch the status of one asynchronous action. Every write tool here returns an action id — poll it with this to see whether the operation finished. Hetzner Cloud: GET /actions/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"action_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The action's numeric id."
}
},
"required": [
"action_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_volumes(name, label_selector, page, per_page)
List block-storage volumes, their size and which server they are attached to. Hetzner Cloud: GET /volumes.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_volumes(id)
Fetch a single resource by id. Hetzner Cloud: GET /volumes/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_networks(name, label_selector, page, per_page)
List private networks, their IP ranges, subnets and routes. Hetzner Cloud: GET /networks.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_networks(id)
Fetch a single resource by id. Hetzner Cloud: GET /networks/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_firewalls(name, label_selector, page, per_page)
List firewalls, their rules and which resources they are applied to. Hetzner Cloud: GET /firewalls.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_firewalls(id)
Fetch a single resource by id. Hetzner Cloud: GET /firewalls/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_load_balancers(name, label_selector, page, per_page)
List load balancers, their services, targets and health status. Hetzner Cloud: GET /load_balancers.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_load_balancers(id)
Fetch a single resource by id. Hetzner Cloud: GET /load_balancers/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_ssh_keys(name, label_selector, page, per_page)
List the SSH public keys available to inject when creating a server. Hetzner Cloud: GET /ssh_keys.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_ssh_keys(id)
Fetch a single resource by id. Hetzner Cloud: GET /ssh_keys/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_floating_ips(name, label_selector, page, per_page)
List floating IPs and which server each is assigned to. Hetzner Cloud: GET /floating_ips.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_floating_ips(id)
Fetch a single resource by id. Hetzner Cloud: GET /floating_ips/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_primary_ips(name, label_selector, page, per_page)
List primary IPs and their assignments. Hetzner Cloud: GET /primary_ips.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_primary_ips(id)
Fetch a single resource by id. Hetzner Cloud: GET /primary_ips/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_list_certificates(name, label_selector, page, per_page)
List TLS certificates, managed or uploaded, and their expiry. Hetzner Cloud: GET /certificates.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Only the resource with this exact name.",
"type": "string"
},
"label_selector": {
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Page size, 1-50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hetzner_get_certificates(id)
Fetch a single resource by id. Hetzner Cloud: GET /certificates/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The resource's numeric id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_create_server(name, server_type, image, location, ssh_keys, ...)
Provision a new server. THIS STARTS BILLING: the chosen server type is charged by the hour from the moment it boots. Call hetzner_list_server_types first to see prices, and hetzner_list_images for a bootable image. Hetzner Cloud: POST /servers.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "A unique name for the server (also its hostname)."
},
"server_type": {
"type": "string",
"description": "Server type name, e.g. cx22. See hetzner_list_server_types."
},
"image": {
"type": "string",
"description": "Image name or id to boot, e.g. ubuntu-24.04."
},
"location": {
"description": "Location name, e.g. fsn1. Defaults to Hetzner's choice.",
"type": "string"
},
"ssh_keys": {
"description": "SSH key names or ids to authorise. Without one, Hetzner emails a root password.",
"type": "array",
"items": {
"type": "string"
}
},
"start_after_create": {
"description": "Boot the server immediately. Defaults to true.",
"type": "boolean"
},
"user_data": {
"description": "cloud-init user data to run on first boot.",
"type": "string"
},
"labels": {
"description": "Labels for filtering later.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"name",
"server_type",
"image"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_poweron_server(server_id)
Power on a stopped server. Returns an action id — poll it with hetzner_get_action. Hetzner Cloud: POST /servers/{id}/actions/poweron.
Eingabe-Schema
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to start."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_shutdown_server(server_id)
Ask the guest OS to shut down gracefully via ACPI. Prefer this over a hard power-off. Note that a stopped server still costs money — only deleting it stops the bill. Hetzner Cloud: POST /servers/{id}/actions/shutdown.
Eingabe-Schema
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to shut down."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_reboot_server(server_id)
Reboot a server gracefully via ACPI. Hetzner Cloud: POST /servers/{id}/actions/reboot.
Eingabe-Schema
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to reboot."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_create_image_from_server(server_id, description, type)
Create a snapshot image from a server's disk — the safe thing to do BEFORE a risky change. Snapshots are billed for the space they use. Hetzner Cloud: POST /servers/{id}/actions/create_image.
Eingabe-Schema
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to snapshot."
},
"description": {
"description": "A label for the snapshot.",
"type": "string"
},
"type": {
"description": "snapshot (kept until deleted) or backup (uses a backup slot). Defaults to snapshot.",
"type": "string",
"enum": [
"snapshot",
"backup"
]
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_enable_server_backup(server_id)
Turn on automatic backups for a server. This adds roughly 20% to the server's price. Hetzner Cloud: POST /servers/{id}/actions/enable_backup.
Eingabe-Schema
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to protect."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_disable_server_backup(server_id)
Turn off automatic backups for a server. Existing backups are DELETED. Hetzner Cloud: POST /servers/{id}/actions/disable_backup.
Eingabe-Schema
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to stop backing up."
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hetzner_change_server_protection(server_id, delete, rebuild)
Turn deletion and rebuild protection on or off for a server. Turning protection ON is the safest write in this server. Hetzner Cloud: POST /servers/{id}/actions/change_protection.
Eingabe-Schema
{
"type": "object",
"properties": {
"server_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The server to protect."
},
"delete": {
"description": "Protect the server from deletion.",
"type": "boolean"
},
"rebuild": {
"description": "Protect the server from rebuild.",
"type": "boolean"
}
},
"required": [
"server_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis