Hetzner Cloud MCP by usefulapi is an MCP server published by io.usefulapi, hosted at hetzner-cloud.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 32 tools, including hetzner_list_servers, hetzner_get_server, hetzner_get_server_metrics, hetzner_list_server_types, hetzner_list_images.
Servers, volumes, networks, firewalls, load balancers, pricing and safe power operations.
4,130 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the servers in the token's project, optionally filtered by name, status or a label selector. Hetzner Cloud: GET /servers.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the server with this exact name. |
| page | integer | 1-based page number. |
| status | string | Only servers in this power state. |
| per_page | integer | Page size, 1-50. |
| label_selector | string | Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom. |
{
"name": "hetzner_list_servers",
"title": "List servers",
"description": "List the servers in the token's project, optionally filtered by name, status or a label selector. Hetzner Cloud: GET /servers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the server with this exact name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"status": {
"enum": [
"running",
"initializing",
"starting",
"stopping",
"off",
"deleting",
"migrating",
"rebuilding",
"unknown"
],
"type": "string",
"description": "Only servers in this power state."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
},
"label_selector": {
"type": "string",
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom."
}
}
},
"annotations": {
"title": "List servers",
"readOnlyHint": true
}
}Fetch a single server with its type, image, IPs, volumes, networks and protection flags. Hetzner Cloud: GET /servers/{id}.
| Parameter | Type | Description |
|---|---|---|
| server_id * | integer | The server's numeric id. |
{
"name": "hetzner_get_server",
"title": "Get one server",
"description": "Fetch a single server with its type, image, IPs, volumes, networks and protection flags. Hetzner Cloud: GET /servers/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"server_id"
],
"properties": {
"server_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The server's numeric id."
}
}
},
"annotations": {
"title": "Get one server",
"readOnlyHint": true
}
}Fetch CPU, disk or network time series for one server over a window. Hetzner Cloud: GET /servers/{id}/metrics.
| Parameter | Type | Description |
|---|---|---|
| end * | string | ISO-8601 end of the window. |
| step | integer | Resolution in seconds. |
| type * | string | Which metric family to return. |
| start * | string | ISO-8601 start of the window. |
| server_id * | integer | The server's numeric id. |
{
"name": "hetzner_get_server_metrics",
"title": "Get server metrics",
"description": "Fetch CPU, disk or network time series for one server over a window. Hetzner Cloud: GET /servers/{id}/metrics.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"server_id",
"type",
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"description": "ISO-8601 end of the window."
},
"step": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Resolution in seconds."
},
"type": {
"enum": [
"cpu",
"disk",
"network"
],
"type": "string",
"description": "Which metric family to return."
},
"start": {
"type": "string",
"description": "ISO-8601 start of the window."
},
"server_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The server's numeric id."
}
}
},
"annotations": {
"title": "Get server metrics",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the type with this name, e.g. cx22. |
| page | integer | 1-based page number. |
| per_page | integer | Page size, 1-50. |
{
"name": "hetzner_list_server_types",
"title": "List server types",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the type with this name, e.g. cx22."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
}
}
},
"annotations": {
"title": "List server types",
"readOnlyHint": true
}
}List OS images, snapshots and backups you can boot or restore from. Hetzner Cloud: GET /images.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the image with this name, e.g. ubuntu-24.04. |
| page | integer | 1-based page number. |
| type | string | Only images of this kind. |
| per_page | integer | Page size, 1-50. |
| architecture | string | Only images for this CPU architecture. |
| label_selector | string | Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom. |
{
"name": "hetzner_list_images",
"title": "List images",
"description": "List OS images, snapshots and backups you can boot or restore from. Hetzner Cloud: GET /images.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the image with this name, e.g. ubuntu-24.04."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"type": {
"enum": [
"system",
"snapshot",
"backup",
"app"
],
"type": "string",
"description": "Only images of this kind."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
},
"architecture": {
"enum": [
"x86",
"arm"
],
"type": "string",
"description": "Only images for this CPU architecture."
},
"label_selector": {
"type": "string",
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom."
}
}
},
"annotations": {
"title": "List images",
"readOnlyHint": true
}
}List the datacentre locations (city, country, network zone) servers can run in. Hetzner Cloud: GET /locations.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the location with this name, e.g. fsn1. |
{
"name": "hetzner_list_locations",
"title": "List locations",
"description": "List the datacentre locations (city, country, network zone) servers can run in. Hetzner Cloud: GET /locations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the location with this name, e.g. fsn1."
}
}
},
"annotations": {
"title": "List locations",
"readOnlyHint": true
}
}Fetch the full price list for the project's currency — server types, volumes, traffic, floating IPs, load balancers and backups. Hetzner Cloud: GET /pricing.
No parameters.
{
"name": "hetzner_get_pricing",
"title": "Get pricing",
"description": "Fetch the full price list for the project's currency — server types, volumes, traffic, floating IPs, load balancers and backups. Hetzner Cloud: GET /pricing.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get pricing",
"readOnlyHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| action_id * | integer | The action's numeric id. |
{
"name": "hetzner_get_action",
"title": "Get one action",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"action_id"
],
"properties": {
"action_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The action's numeric id."
}
}
},
"annotations": {
"title": "Get one action",
"readOnlyHint": true
}
}List block-storage volumes, their size and which server they are attached to. Hetzner Cloud: GET /volumes.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the resource with this exact name. |
| page | integer | 1-based page number. |
| per_page | integer | Page size, 1-50. |
| label_selector | string | Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom. |
{
"name": "hetzner_list_volumes",
"title": "List volumes",
"description": "List block-storage volumes, their size and which server they are attached to. Hetzner Cloud: GET /volumes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the resource with this exact name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
},
"label_selector": {
"type": "string",
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom."
}
}
},
"annotations": {
"title": "List volumes",
"readOnlyHint": true
}
}Fetch a single resource by id. Hetzner Cloud: GET /volumes/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The resource's numeric id. |
{
"name": "hetzner_get_volumes",
"title": "Get one volume",
"description": "Fetch a single resource by id. Hetzner Cloud: GET /volumes/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The resource's numeric id."
}
}
},
"annotations": {
"title": "Get one volume",
"readOnlyHint": true
}
}List private networks, their IP ranges, subnets and routes. Hetzner Cloud: GET /networks.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the resource with this exact name. |
| page | integer | 1-based page number. |
| per_page | integer | Page size, 1-50. |
| label_selector | string | Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom. |
{
"name": "hetzner_list_networks",
"title": "List networks",
"description": "List private networks, their IP ranges, subnets and routes. Hetzner Cloud: GET /networks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the resource with this exact name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
},
"label_selector": {
"type": "string",
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom."
}
}
},
"annotations": {
"title": "List networks",
"readOnlyHint": true
}
}Fetch a single resource by id. Hetzner Cloud: GET /networks/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The resource's numeric id. |
{
"name": "hetzner_get_networks",
"title": "Get one network",
"description": "Fetch a single resource by id. Hetzner Cloud: GET /networks/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The resource's numeric id."
}
}
},
"annotations": {
"title": "Get one network",
"readOnlyHint": true
}
}List firewalls, their rules and which resources they are applied to. Hetzner Cloud: GET /firewalls.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the resource with this exact name. |
| page | integer | 1-based page number. |
| per_page | integer | Page size, 1-50. |
| label_selector | string | Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom. |
{
"name": "hetzner_list_firewalls",
"title": "List firewalls",
"description": "List firewalls, their rules and which resources they are applied to. Hetzner Cloud: GET /firewalls.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the resource with this exact name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
},
"label_selector": {
"type": "string",
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom."
}
}
},
"annotations": {
"title": "List firewalls",
"readOnlyHint": true
}
}Fetch a single resource by id. Hetzner Cloud: GET /firewalls/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The resource's numeric id. |
{
"name": "hetzner_get_firewalls",
"title": "Get one firewall",
"description": "Fetch a single resource by id. Hetzner Cloud: GET /firewalls/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The resource's numeric id."
}
}
},
"annotations": {
"title": "Get one firewall",
"readOnlyHint": true
}
}List load balancers, their services, targets and health status. Hetzner Cloud: GET /load_balancers.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the resource with this exact name. |
| page | integer | 1-based page number. |
| per_page | integer | Page size, 1-50. |
| label_selector | string | Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom. |
{
"name": "hetzner_list_load_balancers",
"title": "List load balancers",
"description": "List load balancers, their services, targets and health status. Hetzner Cloud: GET /load_balancers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the resource with this exact name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
},
"label_selector": {
"type": "string",
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom."
}
}
},
"annotations": {
"title": "List load balancers",
"readOnlyHint": true
}
}Fetch a single resource by id. Hetzner Cloud: GET /load_balancers/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The resource's numeric id. |
{
"name": "hetzner_get_load_balancers",
"title": "Get one load balancer",
"description": "Fetch a single resource by id. Hetzner Cloud: GET /load_balancers/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The resource's numeric id."
}
}
},
"annotations": {
"title": "Get one load balancer",
"readOnlyHint": true
}
}List the SSH public keys available to inject when creating a server. Hetzner Cloud: GET /ssh_keys.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the resource with this exact name. |
| page | integer | 1-based page number. |
| per_page | integer | Page size, 1-50. |
| label_selector | string | Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom. |
{
"name": "hetzner_list_ssh_keys",
"title": "List SSH keys",
"description": "List the SSH public keys available to inject when creating a server. Hetzner Cloud: GET /ssh_keys.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the resource with this exact name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
},
"label_selector": {
"type": "string",
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom."
}
}
},
"annotations": {
"title": "List SSH keys",
"readOnlyHint": true
}
}Fetch a single resource by id. Hetzner Cloud: GET /ssh_keys/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The resource's numeric id. |
{
"name": "hetzner_get_ssh_keys",
"title": "Get one SSH key",
"description": "Fetch a single resource by id. Hetzner Cloud: GET /ssh_keys/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The resource's numeric id."
}
}
},
"annotations": {
"title": "Get one SSH key",
"readOnlyHint": true
}
}List floating IPs and which server each is assigned to. Hetzner Cloud: GET /floating_ips.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the resource with this exact name. |
| page | integer | 1-based page number. |
| per_page | integer | Page size, 1-50. |
| label_selector | string | Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom. |
{
"name": "hetzner_list_floating_ips",
"title": "List floating IPs",
"description": "List floating IPs and which server each is assigned to. Hetzner Cloud: GET /floating_ips.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the resource with this exact name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
},
"label_selector": {
"type": "string",
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom."
}
}
},
"annotations": {
"title": "List floating IPs",
"readOnlyHint": true
}
}Fetch a single resource by id. Hetzner Cloud: GET /floating_ips/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The resource's numeric id. |
{
"name": "hetzner_get_floating_ips",
"title": "Get one floating IP",
"description": "Fetch a single resource by id. Hetzner Cloud: GET /floating_ips/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The resource's numeric id."
}
}
},
"annotations": {
"title": "Get one floating IP",
"readOnlyHint": true
}
}List primary IPs and their assignments. Hetzner Cloud: GET /primary_ips.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the resource with this exact name. |
| page | integer | 1-based page number. |
| per_page | integer | Page size, 1-50. |
| label_selector | string | Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom. |
{
"name": "hetzner_list_primary_ips",
"title": "List primary IPs",
"description": "List primary IPs and their assignments. Hetzner Cloud: GET /primary_ips.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the resource with this exact name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
},
"label_selector": {
"type": "string",
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom."
}
}
},
"annotations": {
"title": "List primary IPs",
"readOnlyHint": true
}
}Fetch a single resource by id. Hetzner Cloud: GET /primary_ips/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The resource's numeric id. |
{
"name": "hetzner_get_primary_ips",
"title": "Get one primary IP",
"description": "Fetch a single resource by id. Hetzner Cloud: GET /primary_ips/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The resource's numeric id."
}
}
},
"annotations": {
"title": "Get one primary IP",
"readOnlyHint": true
}
}List TLS certificates, managed or uploaded, and their expiry. Hetzner Cloud: GET /certificates.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only the resource with this exact name. |
| page | integer | 1-based page number. |
| per_page | integer | Page size, 1-50. |
| label_selector | string | Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom. |
{
"name": "hetzner_list_certificates",
"title": "List certificates",
"description": "List TLS certificates, managed or uploaded, and their expiry. Hetzner Cloud: GET /certificates.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only the resource with this exact name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"per_page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1-50."
},
"label_selector": {
"type": "string",
"description": "Label selector, e.g. env=prod or env!=dev — Hetzner's filter idiom."
}
}
},
"annotations": {
"title": "List certificates",
"readOnlyHint": true
}
}Fetch a single resource by id. Hetzner Cloud: GET /certificates/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The resource's numeric id. |
{
"name": "hetzner_get_certificates",
"title": "Get one certificate",
"description": "Fetch a single resource by id. Hetzner Cloud: GET /certificates/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The resource's numeric id."
}
}
},
"annotations": {
"title": "Get one certificate",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | A unique name for the server (also its hostname). |
| image * | string | Image name or id to boot, e.g. ubuntu-24.04. |
| labels | object | Labels for filtering later. |
| location | string | Location name, e.g. fsn1. Defaults to Hetzner's choice. |
| ssh_keys | array | SSH key names or ids to authorise. Without one, Hetzner emails a root password. |
| user_data | string | cloud-init user data to run on first boot. |
| server_type * | string | Server type name, e.g. cx22. See hetzner_list_server_types. |
| start_after_create | boolean | Boot the server immediately. Defaults to true. |
Power on a stopped server. Returns an action id — poll it with hetzner_get_action. Hetzner Cloud: POST /servers/{id}/actions/poweron.
| Parameter | Type | Description |
|---|---|---|
| server_id * | integer | The server to start. |
{
"name": "hetzner_poweron_server",
"title": "Power on a server",
"description": "Power on a stopped server. Returns an action id — poll it with hetzner_get_action. Hetzner Cloud: POST /servers/{id}/actions/poweron.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"server_id"
],
"properties": {
"server_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The server to start."
}
}
},
"annotations": {
"title": "Power on a server",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| server_id * | integer | The server to shut down. |
{
"name": "hetzner_shutdown_server",
"title": "Shut down a server",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"server_id"
],
"properties": {
"server_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The server to shut down."
}
}
},
"annotations": {
"title": "Shut down a server",
"destructiveHint": true
}
}Reboot a server gracefully via ACPI. Hetzner Cloud: POST /servers/{id}/actions/reboot.
| Parameter | Type | Description |
|---|---|---|
| server_id * | integer | The server to reboot. |
{
"name": "hetzner_reboot_server",
"title": "Reboot a server",
"description": "Reboot a server gracefully via ACPI. Hetzner Cloud: POST /servers/{id}/actions/reboot.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"server_id"
],
"properties": {
"server_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The server to reboot."
}
}
},
"annotations": {
"title": "Reboot a server",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| type | string | snapshot (kept until deleted) or backup (uses a backup slot). Defaults to snapshot. |
| server_id * | integer | The server to snapshot. |
| description | string | A label for the snapshot. |
{
"name": "hetzner_create_image_from_server",
"title": "Snapshot a server to an image",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"server_id"
],
"properties": {
"type": {
"enum": [
"snapshot",
"backup"
],
"type": "string",
"description": "snapshot (kept until deleted) or backup (uses a backup slot). Defaults to snapshot."
},
"server_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The server to snapshot."
},
"description": {
"type": "string",
"description": "A label for the snapshot."
}
}
},
"annotations": {
"title": "Snapshot a server to an image",
"destructiveHint": true
}
}Turn on automatic backups for a server. This adds roughly 20% to the server's price. Hetzner Cloud: POST /servers/{id}/actions/enable_backup.
| Parameter | Type | Description |
|---|---|---|
| server_id * | integer | The server to protect. |
{
"name": "hetzner_enable_server_backup",
"title": "Enable server backups",
"description": "Turn on automatic backups for a server. This adds roughly 20% to the server's price. Hetzner Cloud: POST /servers/{id}/actions/enable_backup.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"server_id"
],
"properties": {
"server_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The server to protect."
}
}
},
"annotations": {
"title": "Enable server backups",
"destructiveHint": true
}
}Turn off automatic backups for a server. Existing backups are DELETED. Hetzner Cloud: POST /servers/{id}/actions/disable_backup.
| Parameter | Type | Description |
|---|---|---|
| server_id * | integer | The server to stop backing up. |
{
"name": "hetzner_disable_server_backup",
"title": "Disable server backups",
"description": "Turn off automatic backups for a server. Existing backups are DELETED. Hetzner Cloud: POST /servers/{id}/actions/disable_backup.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"server_id"
],
"properties": {
"server_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The server to stop backing up."
}
}
},
"annotations": {
"title": "Disable server backups",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| delete | boolean | Protect the server from deletion. |
| rebuild | boolean | Protect the server from rebuild. |
| server_id * | integer | The server to protect. |
{
"name": "hetzner_change_server_protection",
"title": "Change a server's protection",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"server_id"
],
"properties": {
"delete": {
"type": "boolean",
"description": "Protect the server from deletion."
},
"rebuild": {
"type": "boolean",
"description": "Protect the server from rebuild."
},
"server_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The server to protect."
}
}
},
"annotations": {
"title": "Change a server's protection",
"destructiveHint": true
}
}Tools for Hetzner Cloud, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which of my servers are running, and what types are they?"; "How much does each server cost per month at current pricing?"; "Show me CPU usage for my web server over the last 24 hours.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Hetzner Cloud data. Free plan: 50 tool calls per month. Run hetzner_cloud_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run hetzner_cloud_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run hetzner_cloud_upgrade without a plan: it returns both plans, each with a payment link for the user to open. hetzner_cloud_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "hetzner_create_server",
"title": "Create a server",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"server_type",
"image"
],
"properties": {
"name": {
"type": "string",
"description": "A unique name for the server (also its hostname)."
},
"image": {
"type": "string",
"description": "Image name or id to boot, e.g. ubuntu-24.04."
},
"labels": {
"type": "object",
"description": "Labels for filtering later.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"location": {
"type": "string",
"description": "Location name, e.g. fsn1. Defaults to Hetzner's choice."
},
"ssh_keys": {
"type": "array",
"items": {
"type": "string"
},
"description": "SSH key names or ids to authorise. Without one, Hetzner emails a root password."
},
"user_data": {
"type": "string",
"description": "cloud-init user data to run on first boot."
},
"server_type": {
"type": "string",
"description": "Server type name, e.g. cx22. See hetzner_list_server_types."
},
"start_after_create": {
"type": "boolean",
"description": "Boot the server immediately. Defaults to true."
}
}
},
"annotations": {
"title": "Create a server",
"destructiveHint": true
}
}