Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNodebug, info, warn or error. Logs are JSON on stderr; stdout carries the MCP protocol. Default: warn
HTTP_TIMEOUT_MSNoWall-clock budget for one API request, all attempts and retry delays included. Default: 30000
HETZNER_API_BASENoAPI base URL. Must be https; plain http only for localhost, 127.0.0.1 or ::1. Any other value stops the server at startup. Default: https://api.hetzner.cloud/v1
MAX_OUTPUT_BYTESNoLargest tool result text in bytes, counted as sent (JSON-escaped). A longer result is cut and ends with [output truncated by MAX_OUTPUT_BYTES=...]. Values above the default are lowered to it. Default: 8388608
HETZNER_API_TOKENYesHetzner Cloud API token, sent as a bearer token on every request. Required. The server can do exactly what this token allows.
HETZNER_READ_ONLYNotrue, 1 or yes: every tool that is not annotated read-only, and hcloud_raw_request with a method other than GET, returns isError without sending a request. Any value other than true, 1, yes, false, 0, no or empty stops the server at startup. Default: false
HETZNER_DENY_TOOLSNoComma-separated tool name globs (* any characters, ? one character, whole name, case-sensitive), for example hcloud_delete_*,hcloud_raw_request. A matching tool returns isError without sending a request. A pattern that matches no tool stops the server at startup. Default: empty
PAGINATION_MAX_ITEMSNoSoft cap on the items an auto-paginated list collects; a capped list reports truncated: true. Default: 500
PAGINATION_MAX_PAGESNoSoft cap on the pages an auto-paginated list requests. Default: 10
PAGINATION_TIMEOUT_MSNoWall-clock budget of one auto-paginated list. When it ends, the pages read so far come back with truncated: true and a note. Default: 45000
ACTION_POLL_TIMEOUT_MSNoWall-clock budget of a wait: true call, measured from the start of the call. Also the ceiling for the timeout_ms argument of hcloud_wait_action. Default: 45000
HETZNER_CONFIRM_WRITESNotrue, 1 or yes: every tool that is not read-only returns a preview unless the call carries confirm: "YES". Default: false
ACTION_POLL_INTERVAL_MSNoPause between two polls. The interval_ms argument of hcloud_wait_action cannot go below 1000 or this value, whichever is lower. Default: 2000
HTTP_MAX_RETRY_DELAY_MSNoLongest single retry delay. A 429 whose Retry-After asks for more is returned at once as an error. Default: 10000
MCP_SERVE_MODERN_PROTOCOLNotrue, 1 or yes: also serve the MCP 2026-07-28 revision over stdio. A client that opens with initialize gets the same 2025-era session as with false. Default: false

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
hcloud_apply_firewall_to_serverB

Apply a firewall (by id or by name) to a server. Hand-tuned wrapper around POST /firewalls/{id}/actions/apply_to_resources.

hcloud_certificate_retry_actionA

Retry Issuance or Renewal

Retry a failed Certificate issuance or renewal.

Only applicable if the type of the Certificate is managed and the issuance or renewal status is failed.

Operation specific errors

Status

Code

Description

caa_record_does_not_allow_ca

CAA record does not allow certificate authority

ca_dns_validation_failed

Certificate Authority: DNS validation failed

ca_too_many_authorizations_failed_recently

Certificate Authority: Too many authorizations failed recently

ca_too_many_certificates_issued_for_registered_domain

Certificate Authority: Too many certificates issued for registered domain

ca_too_many_duplicate_certificates

Certificate Authority: Too many duplicate certificates

could_not_verify_domain_delegated_to_zone

Could not verify domain delegated to zone

dns_zone_not_found

DNS zone not found

dns_zone_is_secondary_zone

DNS zone is a secondary zone

hcloud_create_certificateA

Create a Certificate

Creates a new Certificate.

The default type uploaded allows for uploading your existing certificate and private_key in PEM format. You have to monitor its expiration date and handle renewal yourself.

In contrast, type managed requests a new Certificate from Let's Encrypt for the specified domain_names. Only domains managed by Hetzner DNS are supported. We handle renewal and timely alert the project owner via email if problems occur.

For type managed Certificates the action key of the response contains the Action that allows for tracking the issuance process. For type uploaded Certificates the action is always null.

hcloud_create_firewallC

Create a Firewall

Create a Firewall.

Operation specific errors

Status

Code

Description

422

server_already_added

The Server was applied more than once.

422

incompatible_network_type

The resources network type is not supported by Firewalls.

422

firewall_resource_not_found

The resource the Firewall should be attached to was not found.

hcloud_create_floating_ipB

Create a Floating IP

Create a Floating IP.

Provide the server attribute to assign the Floating IP to that server or provide a home_location to locate the Floating IP at. Note that the Floating IP can be assigned to a Server in any Location later on. For optimal routing it is advised to use the Floating IP in the same Location it was created in.

hcloud_create_load_balancerC

Create a Load Balancer

Creates a Load Balancer.

Operation specific errors

Status

Code

Description

412

source_port_already_used

The source port you are trying to add is already in use

412

primary_ip_version_mismatch

The specified Primary IP has the wrong IP version

422

ip_not_owned

The IP is not owned by the owner of the project of the Load Balancer

422

load_balancer_not_attached_to_network

The Load Balancer is not attached to a network

422

resolve_cloud_private_targets_error

The server you are trying to add as a target is not attached to the same network as the Load Balancer

422

resolve_cloud_public_targets_error

The server that you are trying to add as a public target does not have a public IPv4 address

422

target_already_defined

The Load Balancer target you are trying to define is already defined

422

primary_ip_assigned

The specified Primary IP is already assigned to a resource

422

primary_ip_blocked

The specified Primary IP is blocked

422

primary_ip_location_mismatch

The specified Primary IP is bound to a different Location than the Load Balancer

hcloud_create_networkA

Create a Network

Creates a Network.

The provided ip_range can only be extended later on, but not reduced.

Subnets can be added now or later on using the add subnet action. If you do not specify an ip_range for the subnet the first available /24 range will be used.

Routes can be added now or later by using the add route action.

hcloud_create_placement_groupC

Create a PlacementGroup

Creates a new Placement Group.

hcloud_create_primary_ipA

Create a Primary IP

Create a new Primary IP.

Can optionally be assigned to a resource by providing an assignee_id and assignee_type.

If not assigned to a resource the location key needs to be provided. This can be either the ID or the name of the Location this Primary IP shall be created in.

A Primary IP can only be assigned to resource in the same Location later on.

Operation specific errors

Status

Code

Description

422

server_not_stopped

The specified Server is running, but needs to be powered off

422

server_has_ipv4

The Server already has an ipv4 address

422

server_has_ipv6

The Server already has an ipv6 address

hcloud_create_serverB

Create a Server

Creates a new Server. Returns preliminary information about the Server as well as an Action that covers progress of creation.

Operation specific errors

Status

Code

Description

412

primary_ip_version_mismatch

The specified Primary IP has the wrong IP Version

422

placement_error

An error during the placement occurred

422

primary_ip_assigned

The specified Primary IP is already assigned to a server

422

primary_ip_datacenter_mismatch

The specified Primary IP is in a different location

hcloud_create_ssh_keyB

Create an SSH key

Creates a new SSH key with the given name and public_key. Once an SSH key is created, it can be used in other calls such as creating Servers.

hcloud_create_volumeA

Create a Volume

Creates a new Volume attached to a Server. If you want to create a Volume that is not attached to a Server, you need to provide the location key instead of server. This can be either the ID or the name of the Location this Volume will be created in. Note that a Volume can be attached to a Server only in the same Location as the Volume itself.

Specifying the Server during Volume creation will automatically attach the Volume to that Server after it has been initialized. In that case, the next_actions key in the response is an array which contains a single attach_volume action.

The minimum Volume size is 10GB and the maximum size is 10TB (10240GB).

A volume’s name can consist of alphanumeric characters, dashes, underscores, and dots, but has to start and end with an alphanumeric character. The total length is limited to 64 characters. Volume names must be unique per Project.

Operation specific errors

Status

Code

Description

422

no_space_left_in_location

There is no volume space left in the given location

hcloud_create_zoneB

Create a Zone

Creates a Zone.

A default SOA and three NS resource records with the assigned Hetzner nameservers are created automatically.

hcloud_delete_certificateC

Delete a Certificate

Deletes a Certificate.

hcloud_delete_firewallA

Delete a Firewall

Deletes the Firewall.

Operation specific errors

Status

Code

Description

422

resource_in_use

Firewall still applied to a resource

hcloud_delete_floating_ipA

Delete a Floating IP

Deletes a Floating IP.

If assigned to a Server the Floating IP will be unassigned automatically until 1 May 2026. After this date, the Floating IP needs to be unassigned before it can be deleted.

Operation specific errors

Status

Code

Description

422

must_be_unassigned

Error when IP is still assigned to a Resource. This error will appear as of 1 May 2026.

hcloud_delete_imageA

Delete an Image

Deletes an Image. Only Images of type snapshot and backup can be deleted.

hcloud_delete_load_balancerC

Delete a Load Balancer

Deletes a Load Balancer.

hcloud_delete_networkB

Delete a Network

Deletes a Network.

Attached resources will be detached automatically.

hcloud_delete_placement_groupC

Delete a PlacementGroup

Deletes a Placement Group.

hcloud_delete_primary_ipA

Delete a Primary IP

Deletes a Primary IP.

The Server must be powered off (status off) in order for this operation to succeed. If assigned to a Server the Primary IP will be unassigned automatically until 1 May 2026. After this date, the Primary IP needs to be unassigned before it can be deleted.

Operation specific errors

Status

Code

Description

422

must_be_unassigned

Error when IP is still assigned to a Resource. This error will appear as of 1 May 2026.

hcloud_delete_serverB

Delete a Server

Deletes a Server.

This immediately removes the Server from your account, and it is no longer accessible. Any resources attached to the server (like Volumes, Primary IPs, Floating IPs, Firewalls, Placement Groups) are detached while the server is deleted.

hcloud_delete_ssh_keyB

Delete an SSH key

Deletes an SSH key. It cannot be used anymore.

hcloud_delete_volumeA

Delete a Volume

Deletes a volume. All Volume data is irreversibly destroyed. The Volume must not be attached to a Server and it must not have delete protection enabled.

hcloud_delete_zoneC

Delete a Zone

Deletes a Zone.

hcloud_delete_zone_rrsetA

Delete an RRSet

Deletes an RRSet from the Zone.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_firewall_apply_to_resources_actionA

Apply to Resources

Applies a Firewall to multiple resources.

Supported resources:

A Server can be applied to a maximum of 5 Firewalls. This limit applies to Servers applied via a matching Label Selector as well.

Updates to resources matching or no longer matching a Label Selector can take up to a few seconds to be processed.

A Firewall is applied to a resource once the related Action with command apply_firewall successfully finished.

Operation specific errors

Status

Code

Description

404

firewall_resource_not_found

The resource the Firewall should be applied to was not found

422

firewall_already_applied

Firewall is already applied to resource

422

incompatible_network_type

The network type of the resource is not supported by Firewalls

422

private_net_only_server

The Server the Firewall should be applied to has no public interface

hcloud_firewall_remove_from_resources_actionA

Remove from Resources

Removes a Firewall from multiple resources.

Supported resources:

  • Servers (with a public network interface)

A Firewall is removed from a resource once the related Action with command remove_firewall successfully finished.

Operation specific errors

Status

Code

Description

404

firewall_resource_not_found

The resource the Firewall should be removed from was not found

422

firewall_managed_by_label_selector

Firewall is applied via a Label Selector and cannot be removed manually

hcloud_firewall_set_rules_actionA

Set Rules

Set the rules of a Firewall.

Overwrites the existing rules with the given ones. Pass an empty array to remove all rules.

Rules are limited to 50 entries per Firewall and 500 effective rules.

hcloud_floating_ip_assign_actionC

Assign a Floating IP to a Server

Assigns a Floating IP to a Server.

Operation specific errors

Status

Code

Description

422

floating_ip_assigned

The Floating IP is already assigned

hcloud_floating_ip_change_dns_ptr_actionC

Change reverse DNS records for a Floating IP

Change the reverse DNS records for this Floating IP.

Allows to modify the PTR records set for the IP address.

hcloud_floating_ip_change_protection_actionC

Change Floating IP Protection

Changes the protection settings configured for the Floating IP.

hcloud_floating_ip_unassign_actionA

Unassign a Floating IP

Unassigns a Floating IP.

Results in the IP being unreachable. Can be assigned to another resource again.

hcloud_get_actionC

Get an Action

Returns a specific Action object.

hcloud_get_certificateC

Get a Certificate

Gets a specific Certificate object.

hcloud_get_certificate_actionA

Get an Action for a Certificate

Deprecated: This operation is deprecated, see our changelog for more details.

Returns a specific Action for a Certificate. Only type managed Certificates have Actions.

hcloud_get_certificates_actionsC

List Actions

Returns all Action objects. You can sort the results by using the sort URI parameter, and filter them with the status and id parameter.

hcloud_get_certificates_actions_idC

Get an Action

Returns a specific Action object.

hcloud_get_datacenterA

Get a Data Center

Deprecated: This endpoint is deprecated as of 01 June 2026 and will be removed after 01 October 2026.

Returns a single Data Center.

hcloud_get_firewallC

Get a Firewall

Returns a single Firewall.

hcloud_get_firewall_actionA

Get an Action for a Firewall

Deprecated: This operation is deprecated, see our changelog for more details.

Returns a specific Action for a Firewall.

hcloud_get_firewalls_actionsC

List Actions

Returns all Actions for Firewalls.

Use the provided URI parameters to modify the result.

hcloud_get_firewalls_actions_idC

Get an Action

Returns the specific Action.

hcloud_get_floating_ipB

Get a Floating IP

Returns a single Floating IP.

hcloud_get_floating_ip_actionB

Get an Action for a Floating IP

Deprecated: This operation is deprecated, see our changelog for more details.

Returns a specific Action for a Floating IP.

hcloud_get_floating_ips_actionsC

List Actions

Lists multiple Actions.

Use the provided URI parameters to modify the result.

hcloud_get_floating_ips_actions_idC

Get an Action

Returns a single Action.

hcloud_get_imageC

Get an Image

Returns a specific Image object.

hcloud_get_image_actionA

Get an Action for an Image

Deprecated: This operation is deprecated, see our changelog for more details.

Returns a specific Action for an Image.

hcloud_get_images_actionsC

List Actions

Returns all Action objects. You can sort the results by using the sort URI parameter, and filter them with the status and id parameter.

hcloud_get_images_actions_idC

Get an Action

Returns a specific Action object.

hcloud_get_isoC

Get an ISO

Returns a specific ISO object.

hcloud_get_load_balancerC

Get a Load Balancer

Gets a specific Load Balancer object.

hcloud_get_load_balancer_actionA

Get an Action for a Load Balancer

Deprecated: This operation is deprecated, see our changelog for more details.

Returns a specific Action for a Load Balancer.

hcloud_get_load_balancer_metricsA

Get Metrics for a LoadBalancer

You must specify the type of metric to get: open_connections, connections_per_second, requests_per_second or bandwidth. You can also specify more than one type by comma separation, e.g. requests_per_second,bandwidth.

Depending on the type you will get different time series data:

Type

Timeseries

Unit

Description

open_connections

open_connections

number

Open connections

connections_per_second

connections_per_second

connections/s

Connections per second

requests_per_second

requests_per_second

requests/s

Requests per second

bandwidth

bandwidth.in

bytes/s

Ingress bandwidth

bandwidth.out

bytes/s

Egress bandwidth

Metrics are available for the last 30 days only.

If you do not provide the step argument we will automatically adjust it so that 200 samples are returned.

We limit the number of samples to a maximum of 500 and will adjust the step parameter accordingly.

hcloud_get_load_balancer_typeC

Get a Load Balancer Type

Gets a specific Load Balancer type object.

hcloud_get_load_balancers_actionsC

List Actions

Returns all Action objects. You can sort the results by using the sort URI parameter, and filter them with the status and id parameter.

hcloud_get_load_balancers_actions_idC

Get an Action

Returns a specific Action object.

hcloud_get_locationC

Get a Location

Returns a Location.

hcloud_get_networkC

Get a Network

Get a specific Network.

hcloud_get_network_actionA

Get an Action for a Network

Deprecated: This operation is deprecated, see our changelog for more details.

Returns a specific Action for a Network.

hcloud_get_network_membersB

List Members of a Network

List the resources attached to a specific Network.

Use the provided URI parameters to modify the result.

hcloud_get_networks_actionsC

List Actions

Lists multiple Actions.

Use the provided URI parameters to modify the result.

hcloud_get_networks_actions_idC

Get an Action

Returns a single Action.

hcloud_get_placement_groupC

Get a PlacementGroup

Gets a specific Placement Group object.

hcloud_get_pricingA

Get all prices

Returns prices for all resources available on the platform. VAT and currency of the Project owner are used for calculations.

Both net and gross prices are included in the response.

hcloud_get_primary_ipC

Get a Primary IP

Returns a Primary IP.

hcloud_get_primary_ip_actionA

Get an Action for a Primary IP

Deprecated: This operation is deprecated, see our changelog for more details.

Returns a specific Action for a Primary IP.

hcloud_get_primary_ips_actionsC

List Actions

Lists multiple Actions.

Use the provided URI parameters to modify the result.

hcloud_get_primary_ips_actions_idC

Get an Action

Returns a single Action.

hcloud_get_serverA

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.

hcloud_get_server_actionB

Get an Action for a Server

Deprecated: This operation is deprecated, see our changelog for more details.

Returns a specific Action object for a Server.

hcloud_get_server_metricsB

Fetch a server's metrics (cpu / disk / network). Accept id OR name. Defaults to the last hour with step=60s. Hand-tuned wrapper.

hcloud_get_server_metrics_rawA

Get Metrics for a Server

Get Metrics for specified Server.

You must specify the type of metric to get: cpu, disk or network. You can also specify more than one type by comma separation, e.g. cpu,disk.

Depending on the type you will get different time series data

Type

Timeseries

Unit

Description

cpu

cpu

percent

Percent CPU usage

disk

disk.0.iops.read

iop/s

Number of read IO operations per second

disk.0.iops.write

iop/s

Number of write IO operations per second

disk.0.bandwidth.read

bytes/s

Bytes read per second

disk.0.bandwidth.write

bytes/s

Bytes written per second

network

network.0.pps.in

packets/s

Public Network interface packets per second received

network.0.pps.out

packets/s

Public Network interface packets per second sent

network.0.bandwidth.in

bytes/s

Public Network interface bytes/s received

network.0.bandwidth.out

bytes/s

Public Network interface bytes/s sent

Note that the CPU value is not normalized to a fixed 0-100% scale. It is calculated per vCPU: a value of 100 represents full utilization on a 1-vCPU server, and 25% utilization on a 4-vCPU server. To calculate the overall CPU usage, divide the metric value by the number of vCPUs.

Metrics are available for the last 30 days only.

If you do not provide the step argument we will automatically adjust it so that a maximum of 200 samples are returned.

We limit the number of samples returned to a maximum of 500 and will adjust the step parameter accordingly.

hcloud_get_server_rawB

Get a Server

Returns a specific Server object. The Server must exist inside the Project.

hcloud_get_server_typeC

Get a Server Type

Gets a specific Server type object.

hcloud_get_servers_actionsC

List Actions

Returns all Action objects. You can sort the results by using the sort URI parameter, and filter them with the status and id parameter.

hcloud_get_servers_actions_idC

Get an Action

Returns a specific Action object.

hcloud_get_ssh_keyC

Get a SSH key

Returns a specific SSH key object.

hcloud_get_volumeC

Get a Volume

Gets a specific Volume object.

hcloud_get_volume_actionA

Get an Action for a Volume

Deprecated: This operation is deprecated, see our changelog for more details.

Returns a specific Action for a Volume.

hcloud_get_volumes_actionsC

List Actions

Returns all Action objects. You can sort the results by using the sort URI parameter, and filter them with the status and id parameter.

hcloud_get_volumes_actions_idC

Get an Action

Returns a specific Action object.

hcloud_get_zoneC

Get a Zone

Returns a single Zone.

hcloud_get_zone_actionA

Get an Action for a Zone

Deprecated: This operation is deprecated, see our changelog for more details.

Returns a specific Action for a Zone.

hcloud_get_zone_rrsetA

Get an RRSet

Returns a single RRSet from the Zone.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_get_zone_rrsetsA

List RRSets

Returns all RRSets in the Zone.

Use the provided URI parameters to modify the result.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_get_zone_zonefileA

Export a Zone file

Returns a generated Zone file in BIND (RFC 1034/1035) format.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_get_zones_actionsB

List Actions

Returns all Zone Actions.

Use the provided URI parameters to modify the result.

hcloud_get_zones_actions_idC

Get an Action

Returns a specific Action.

hcloud_image_change_protection_actionB

Change Image Protection

Changes the protection configuration of the Image. Can only be used on snapshots.

hcloud_list_actionsA

Get multiple Actions

Returns multiple Action objects specified by the id parameter.

Note: This endpoint previously allowed listing all actions in the project. This functionality was deprecated in July 2023 and removed on 30 January 2025.

hcloud_list_certificate_actionsA

List Actions for a Certificate

Returns all Action objects for a Certificate. You can sort the results by using the sort URI parameter, and filter them with the status parameter.

Only type managed Certificates can have Actions. For type uploaded Certificates the actions key will always contain an empty array.

hcloud_list_certificatesC

List Certificates

Returns all Certificate objects.

hcloud_list_datacentersA

List Data Centers

Deprecated: This endpoint is deprecated as of 01 June 2026 and will be removed after 01 October 2026.

Returns all Data Centers.

hcloud_list_firewall_actionsC

List Actions for a Firewall

Returns all Actions for the Firewall.

Use the provided URI parameters to modify the result.

hcloud_list_firewallsB

List Firewalls

Returns all Firewalls.

Use the provided URI parameters to modify the result.

hcloud_list_floating_ip_actionsB

List Actions for a Floating IP

Lists Actions for a Floating IP.

Use the provided URI parameters to modify the result.

hcloud_list_floating_ipsB

List Floating IPs

List multiple Floating IPs.

Use the provided URI parameters to modify the result.

hcloud_list_image_actionsA

List Actions for an Image

Returns all Action objects for an Image. You can sort the results by using the sort URI parameter, and filter them with the status parameter.

hcloud_list_imagesB

List Images

Returns all Image objects. You can select specific Image types only and sort the results by using URI parameters.

hcloud_list_isosC

List ISOs

Returns all available ISO objects.

hcloud_list_load_balancer_actionsA

List Actions for a Load Balancer

Returns all Action objects for a Load Balancer. You can sort the results by using the sort URI parameter, and filter them with the status parameter.

hcloud_list_load_balancer_typesC

List Load Balancer Types

Gets all Load Balancer type objects.

hcloud_list_load_balancersB

List Load Balancers

Gets all existing Load Balancers that you have available.

hcloud_list_locationsC

List Locations

Returns all Locations.

hcloud_list_network_actionsC

List Actions for a Network

Lists Actions for a Network.

Use the provided URI parameters to modify the result.

hcloud_list_networksC

List Networks

List multiple Networks.

Use the provided URI parameters to modify the result.

hcloud_list_placement_groupsC

List Placement Groups

Returns all Placement Group objects.

hcloud_list_primary_ip_actionsB

List Actions for a Primary IP

Returns all Actions for a Primary IP.

Use the provided URI parameters to modify the result.

hcloud_list_primary_ipsC

List Primary IPs

List multiple Primary IPs.

Use the provided URI parameters to modify the result.

hcloud_list_server_actionsB

List Actions for a Server

Returns all Action objects for a Server. You can sort the results by using the sort URI parameter, and filter them with the status parameter.

hcloud_list_server_typesC

List Server Types

Gets all Server type objects.

hcloud_list_serversA

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.

hcloud_list_servers_rawC

List Servers

Returns all existing Server objects.

hcloud_list_ssh_keysB

List SSH keys

Returns all SSH key objects.

hcloud_list_volume_actionsA

List Actions for a Volume

Returns all Action objects for a Volume. You can sort the results by using the sort URI parameter, and filter them with the status parameter.

hcloud_list_volumesC

List Volumes

Gets all existing Volumes that you have available.

hcloud_list_zone_actionsB

List Actions for a Zone

Returns all Actions for a Zone.

Use the provided URI parameters to modify the result.

hcloud_list_zonesC

List Zones

Returns all Zones.

Use the provided URI parameters to modify the result.

hcloud_load_balancer_add_service_actionB

Add Service

Adds a service to a Load Balancer.

Operation specific errors

Status

Code

Description

412

source_port_already_used

The source port you are trying to add is already in use

hcloud_load_balancer_add_target_actionB

Add Target

Adds a target to a Load Balancer.

Operation specific errors

Status

Code

Description

422

ip_not_in_vswitch_subnet

The IP you are trying to add does not belong to the vswitch subnet of the attached network

422

ip_not_owned

The IP you are trying to add as a target is not owned by the Project owner

422

ip_not_assigned_to_server

The specified IP is neither the Primary IPv4 address nor in the IPv6 subnet of the given Server

422

load_balancer_public_interface_disabled

The Load Balancer's public network interface is disabled

422

load_balancer_not_attached_to_network

The Load Balancer is not attached to a network

422

network_has_no_vswitch_subnet

The given IP is private but attached network does not have a vswitch subnet

422

resolve_cloud_private_targets_error

The server you are trying to add as a target is not attached to the same network as the Load Balancer

422

resolve_cloud_public_targets_error

The server that you are trying to add as a public target does not have a public IPv4 address

422

target_already_defined

The Load Balancer target you are trying to define is already defined

hcloud_load_balancer_attach_to_network_actionB

Attach a Load Balancer to a Network

Attach a Load Balancer to a Network.

Operation specific errors

Status

Code

Description

422

load_balancer_already_attached

The Load Balancer is already attached to a network

422

ip_not_available

The provided Network IP is not available

422

no_subnet_available

No Subnet or IP is available for the Load Balancer within the network

hcloud_load_balancer_change_algorithm_actionB

Change Algorithm

Change the algorithm that determines to which target new requests are sent.

hcloud_load_balancer_change_dns_ptr_actionB

Change reverse DNS entry for this Load Balancer

Changes the hostname that will appear when getting the hostname belonging to the public IPs (IPv4 and IPv6) of this Load Balancer.

Floating IPs assigned to the Server are not affected by this.

hcloud_load_balancer_change_protection_actionC

Change Load Balancer Protection

Changes the protection configuration of a Load Balancer.

hcloud_load_balancer_change_type_actionB

Change the Type of a Load Balancer

Changes the type (Max Services, Max Targets and Max Connections) of a Load Balancer.

Operation specific errors

Status

Code

Description

422

invalid_load_balancer_type

The Load Balancer type does not fit for the given Load Balancer

hcloud_load_balancer_delete_service_actionC

Delete Service

Delete a service of a Load Balancer.

hcloud_load_balancer_detach_from_network_actionC

Detach a Load Balancer from a Network

Detaches a Load Balancer from a network.

hcloud_load_balancer_disable_public_interface_actionA

Disable the public interface of a Load Balancer

Disable the public interface of a Load Balancer. The Load Balancer will be not accessible from the internet via its public IPs.

Operation specific errors

Status

Code

Description

422

load_balancer_not_attached_to_network

The Load Balancer is not attached to a network

422

targets_without_use_private_ip

The Load Balancer has targets that use the public IP instead of the private IP

hcloud_load_balancer_enable_public_interface_actionB

Enable the public interface of a Load Balancer

Enable the public interface of a Load Balancer. The Load Balancer will be accessible from the internet via its public IPs.

hcloud_load_balancer_remove_target_actionC

Remove Target

Removes a target from a Load Balancer.

hcloud_load_balancer_update_service_actionB

Update Service

Updates a Load Balancer Service.

Operation specific errors

Status

Code

Description

422

source_port_already_used

The source port you are trying to add is already in use

hcloud_network_add_route_actionB

Add a route to a Network

Adds a route entry to a Network.

If a change is currently being performed on this Network, a error response with code conflict will be returned.

hcloud_network_add_subnet_actionA

Add a subnet to a Network

Adds a new subnet to the Network.

If the subnet ip_range is not provided, the first available /24 IP range will be used.

If a change is currently being performed on this Network, a error response with code conflict will be returned.

hcloud_network_change_ip_range_actionA

Change IP range of a Network

Changes the IP range of a Network.

The following restrictions apply to changing the IP range:

  • IP ranges can only be extended and never shrunk.

  • IPs can only be added to the end of the existing range, therefore only the netmask is allowed to be changed.

To update the routes on the connected Servers, they need to be rebooted or the routes to be updated manually.

For example if the Network has a range of 10.0.0.0/16 to extend it the new range has to start with the IP 10.0.0.0 as well. The netmask /16 can be changed to a smaller one then 16 therefore increasing the IP range. A valid entry would be 10.0.0.0/15, 10.0.0.0/14 or 10.0.0.0/13 and so on.

If a change is currently being performed on this Network, a error response with code conflict will be returned.

hcloud_network_change_protection_actionB

Change Network Protection

Changes the protection settings of a Network.

If a change is currently being performed on this Network, a error response with code conflict will be returned.

hcloud_network_delete_route_actionB

Delete a route from a Network

Delete a route entry from a Network.

If a change is currently being performed on this Network, a error response with code conflict will be returned.

hcloud_network_delete_subnet_actionA

Delete a subnet from a Network

Deletes a single subnet entry from a Network.

Subnets containing attached resources can not be deleted, they must be detached beforehand.

If a change is currently being performed on this Network, a error response with code conflict will be returned.

hcloud_post_zone_rrsetsA

Create an RRSet

Create an RRSet in the Zone.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_primary_ip_assign_actionA

Assign a Primary IP to a resource

Assign a Primary IP to a resource.

A Server can only have one Primary IP of type ipv4 and one of type ipv6 assigned. If you need more IPs use Floating IPs.

A Server must be powered off (status off) in order for this operation to succeed.

Operation specific errors

Status

Code

Description

422

server_not_stopped

The Server is running, but needs to be powered off

422

primary_ip_already_assigned

Primary IP is already assigned to a different Server

422

server_has_ipv4

The Server already has an IPv4 address

422

server_has_ipv6

The Server already has an IPv6 address

hcloud_primary_ip_change_dns_ptr_actionC

Change reverse DNS records for a Primary IP

Change the reverse DNS records for this Primary IP.

Allows to modify the PTR records set for the IP address.

hcloud_primary_ip_change_protection_actionB

Change Primary IP Protection

Changes the protection configuration of a Primary IP.

A Primary IPs deletion protection can only be enabled if its auto_delete property is set to false.

hcloud_primary_ip_unassign_actionA

Unassign a Primary IP from a resource

Unassign a Primary IP from a resource.

A Server must be powered off (status off) in order for this operation to succeed.

A Server requires at least one network interface (public or private) to be powered on.

Operation specific errors

Status

Code

Description

422

server_not_stopped

The Server is running, but needs to be powered off

422

server_is_load_balancer_target

The Server IPv4 address is a loadbalancer target

hcloud_raw_requestA

Escape hatch: issue an arbitrary request against the Hetzner Cloud API. The configured API token is sent and the client retries a 429, and a 5xx on methods other than POST, like every other tool. Pagination and action polling are not applied, and an HTTP error comes back as { status, body } instead of an error result. Use only when no dedicated tool fits.

hcloud_server_add_to_placement_group_actionA

Add a Server to a Placement Group

Adds a Server to a Placement Group.

Server must be powered off for this command to succeed.

Operation specific errors

Status

Code

Description

422

server_not_stopped

The action requires a stopped server

422

already_in_placement_group

The server is already part of a placement group

hcloud_server_attach_iso_actionA

Attach an ISO to a Server

Attaches an ISO to a Server. The Server will immediately see it as a new disk. An already attached ISO will automatically be detached before the new ISO is attached.

Servers with attached ISOs have a modified boot order: They will try to boot from the ISO first before falling back to hard disk.

hcloud_server_attach_to_network_actionA

Attach a Server to a Network

Attaches a Server to a network. This will complement the fixed public Server interface by adding an additional ethernet interface to the Server which is connected to the specified network.

The Server will get an IP auto assigned from a subnet of type server in the same network_zone.

Using the alias_ips attribute you can also define one or more additional IPs to the Servers. Please note that you will have to configure these IPs by hand on your Server since only the primary IP will be given out by DHCP.

Operation specific errors

Status

Code

Description

422

server_already_attached

The server is already attached to the network

422

ip_not_available

The provided Network IP is not available

422

no_subnet_available

No Subnet or IP is available for the Server within the network

422

networks_overlap

The network IP range overlaps with one of the server networks

hcloud_server_backupC

Toggle Hetzner-managed automatic backups on a server. Hand-tuned wrapper around enable_backup / disable_backup actions.

hcloud_server_change_alias_ips_actionA

Change alias IPs of a Network

Changes the alias IPs of an already attached Network. Note that the existing aliases for the specified Network will be replaced with these provided in the request body. So if you want to add an alias IP, you have to provide the existing ones from the Network plus the new alias IP in the request body.

hcloud_server_change_dns_ptr_actionA

Change reverse DNS entry for this Server

Changes the hostname that will appear when getting the hostname belonging to the primary IPs (IPv4 and IPv6) of this Server.

Floating IPs assigned to the Server are not affected by this.

hcloud_server_change_protection_actionC

Change Server Protection

Changes the protection configuration of the Server.

hcloud_server_change_typeB

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.

hcloud_server_change_type_actionA

Change the Type of a Server

Changes the type (Cores, RAM and disk sizes) of a Server.

Server must be powered off for this command to succeed.

This copies the content of its disk, and starts it again.

You can only migrate to Server types with the same storage_type and equal or bigger disks. Shrinking disks is not possible as it might destroy data.

If the disk gets upgraded, the Server type can not be downgraded any more. If you plan to downgrade the Server type, set upgrade_disk to false.

Operation specific errors

Status

Code

Description

422

invalid_server_type

The server type does not fit for the given server or is deprecated

422

server_not_stopped

The action requires a stopped server

hcloud_server_create_image_actionA

Create Image from a Server

Creates an Image (snapshot) from a Server by copying the contents of its disks. This creates a snapshot of the current state of the disk and copies it into an Image. If the Server is currently running you must make sure that its disk content is consistent. Otherwise, the created Image may not be readable.

To make sure disk content is consistent, we recommend to shut down the Server prior to creating an Image.

You can either create a backup Image that is bound to the Server and therefore will be deleted when the Server is deleted, or you can create a snapshot Image which is completely independent of the Server it was created from and will survive Server deletion. Backup Images are only available when the backup option is enabled for the Server. Snapshot Images are billed on a per GB basis.

hcloud_server_detach_from_network_actionC

Detach a Server from a Network

Detaches a Server from a network. The interface for this network will vanish.

hcloud_server_detach_iso_actionB

Detach an ISO from a Server

Detaches an ISO from a Server. In case no ISO Image is attached to the Server, the status of the returned Action is immediately set to success.

hcloud_server_disable_backup_actionA

Disable Backups for a Server

Disables the automatic backup option and deletes all existing Backups for a Server. No more additional charges for backups will be made.

Caution: This immediately removes all existing backups for the Server!

hcloud_server_disable_rescue_actionA

Disable Rescue Mode for a Server

Disables the Hetzner Rescue System for a Server. This makes a Server start from its disks on next reboot.

Rescue Mode is automatically disabled when you first boot into it or if you do not use it for 60 minutes.

Disabling rescue mode will not reboot your Server - you will have to do this yourself.

hcloud_server_enable_backup_actionA

Enable and Configure Backups for a Server

Enables and configures the automatic daily backup option for the Server. Enabling automatic backups will increase the price of the Server by 20%. In return, you will get seven slots where Images of type backup can be stored.

Backups are automatically created daily.

hcloud_server_enable_rescue_actionA

Enable Rescue Mode for a Server

Enable the Hetzner Rescue System for this Server. The next time a Server with enabled rescue mode boots it will start a special minimal Linux distribution designed for repair and reinstall.

In case a Server cannot boot on its own you can use this to access a Server’s disks.

Rescue Mode is automatically disabled when you first boot into it or if you do not use it for 60 minutes.

Enabling rescue mode will not reboot your Server - you will have to do this yourself.

hcloud_server_powerC

Run a power operation on a server (poweron / poweroff / reboot / shutdown / reset). Hand-tuned wrapper that polls the resulting action by default.

hcloud_server_poweroff_actionA

Power off a Server

Cuts power to the Server. This forcefully stops it without giving the Server operating system time to gracefully stop. May lead to data loss, equivalent to pulling the power cord. Power off should only be used when shutdown does not work.

hcloud_server_poweron_actionC

Power on a Server

Starts a Server by turning its power on.

hcloud_server_reboot_actionA

Soft-reboot a Server

Reboots a Server gracefully by sending an ACPI request. The Server operating system must support ACPI and react to the request, otherwise the Server will not reboot.

hcloud_server_rebuildB

Rebuild a server from an image. Accept image_id (integer) OR image_name (string). Hand-tuned wrapper; polls the resulting action by default.

hcloud_server_rebuild_actionA

Rebuild a Server from an Image

Rebuilds a Server overwriting its disk with the content of an Image, thereby destroying all data on the target Server

The Image can either be one you have created earlier (backup or snapshot Image) or it can be a completely fresh system Image provided by us. You can get a list of all available Images with GET /images.

Your Server will automatically be powered off before the rebuild command executes.

hcloud_server_remove_from_placement_group_actionC

Remove from Placement Group

Removes a Server from a Placement Group.

hcloud_server_request_console_actionA

Request Console for a Server

Requests credentials for remote access via VNC over websocket to keyboard, monitor, and mouse for a Server. The provided URL is valid for 1 minute, after this period a new url needs to be created to connect to the Server. How long the connection is open after the initial connect is not subject to this timeout.

hcloud_server_rescueB

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.

hcloud_server_reset_actionA

Reset a Server

Cuts power to a Server and starts it again. This forcefully stops it without giving the Server operating system time to gracefully stop. This may lead to data loss, it’s equivalent to pulling the power cord and plugging it in again. Reset should only be used when reboot does not work.

hcloud_server_reset_password_actionA

Reset root Password of a Server

Resets the root password. Only works for Linux systems that are running the qemu guest agent. Server must be powered on (status running) in order for this operation to succeed.

This will generate a new password for this Server and return it.

If this does not succeed you can use the rescue system to netboot the Server and manually change your Server password by hand.

hcloud_server_shutdown_actionA

Shutdown a Server

Shuts down a Server gracefully by sending an ACPI shutdown request. The Server operating system must support ACPI and react to the request, otherwise the Server will not shut down. Please note that the action status in this case only reflects whether the action was sent to the server. It does not mean that the server actually shut down successfully. If you need to ensure that the server is off, use the poweroff action.

hcloud_server_snapshotB

Create an image (snapshot or backup) of a server. Default type is 'snapshot'. Hand-tuned wrapper that polls the resulting action.

hcloud_update_certificateC

Update a Certificate

Updates the Certificate properties.

Note: if the Certificate object changes during the request, the response will be a “conflict” error.

hcloud_update_firewallB

Update a Firewall

Update a Firewall.

In case of a parallel running change on the Firewall a conflict error will be returned.

hcloud_update_floating_ipC

Update a Floating IP

Update a Floating IP.

hcloud_update_imageA

Update an Image

Updates the Image. You may change the description, convert a Backup Image to a Snapshot Image or change the Image labels. Only Images of type snapshot and backup can be updated.

hcloud_update_load_balancerB

Update a Load Balancer

Updates a Load Balancer. You can update a Load Balancer’s name and a Load Balancer’s labels.

Note: if the Load Balancer object changes during the request, the response will be a “conflict” error.

hcloud_update_networkC

Update a Network

Update a Network.

If a change is currently being performed on this Network, a error response with code conflict will be returned.

hcloud_update_placement_groupC

Update a PlacementGroup

Updates the Placement Group properties.

Note: if the Placement Group object changes during the request, the response will be a “conflict” error.

hcloud_update_primary_ipC

Update a Primary IP

Update a Primary IP.

If another change is concurrently performed on this Primary IP, a error response with code conflict will be returned.

hcloud_update_serverB

Update a Server

Updates a Server. You can update a Server’s name and a Server’s labels.

Please note that Server names must be unique per Project and valid hostnames as per RFC 1123 (i.e. may only contain letters, digits, periods, and dashes).

hcloud_update_ssh_keyC

Update an SSH key

Updates an SSH key. You can update an SSH key name and an SSH key labels.

hcloud_update_volumeC

Update a Volume

Updates the Volume properties.

hcloud_update_zoneC

Update a Zone

Updates a Zone.

To modify resource record sets (RRSets), use the RRSet Actions endpoints.

hcloud_update_zone_rrsetA

Update an RRSet

Updates an RRSet in the Zone.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_volume_attach_actionA

Attach Volume to a Server

Attaches a Volume to a Server. Works only if the Server is in the same Location as the Volume.

hcloud_volume_change_protection_actionC

Change Volume Protection

Changes the protection configuration of a Volume.

hcloud_volume_detach_actionA

Detach Volume

Detaches a Volume from the Server it’s attached to. You may attach it to a Server again at a later time.

hcloud_volume_resize_actionB

Resize Volume

Changes the size of a Volume. Note that downsizing a Volume is not possible.

hcloud_wait_actionA

Poll an existing Hetzner Cloud action until it reaches terminal status (success/error) or the timeout elapses. Returns the final action plus a polling_timed_out flag.

hcloud_zone_change_primary_nameservers_actionA

Change a Zone's Primary Nameservers

Overwrites the primary nameservers of a Zone.

Only applicable for Zones in secondary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_zone_change_protection_actionC

Change a Zone's Protection

Changes the protection configuration of a Zone.

hcloud_zone_change_ttl_actionA

Change a Zone's Default TTL

Changes the default Time To Live (TTL) of a Zone.

This TTL is used for RRSets that do not explicitly define a TTL.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_zone_import_zonefile_actionA

Import a Zone file

Imports a zone file, replacing all resource record sets (RRSets).

The import will fail if existing RRSet are change protected.

See Zone file import for more details. Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_zone_rrset_add_records_actionA

Add Records to an RRSet

Adds resource records (RRs) to an RRSet in the Zone.

For convenience, the RRSet will be automatically created if it doesn't exist. Otherwise, the new records are appended to the existing RRSet.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_zone_rrset_change_protection_actionA

Change an RRSet's Protection

Changes the protection of an RRSet in the Zone.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_zone_rrset_change_ttl_actionA

Change an RRSet's TTL

Changes the Time To Live (TTL) of an RRSet in the Zone.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_zone_rrset_remove_records_actionA

Remove Records from an RRSet

Removes resource records (RRs) from an existing RRSet in the Zone.

For convenience, the RRSet will be automatically deleted if it doesn't contain any RRs afterwards.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_zone_rrset_set_records_actionA

Set Records of an RRSet

Overwrites the resource records (RRs) of an existing RRSet in the Zone.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

hcloud_zone_rrset_update_records_actionA

Update Records of an RRSet

Updates resource records' (RRs) comments of an existing RRSet in the Zone.

Only applicable for Zones in primary mode.

Operation specific errors

Status

Code

Description

422

incorrect_zone_mode

This operation is not supported for this Zone's mode.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.6/5.0

Scored across 202 tools

Disambiguation2/5

Many tools have near-identical or overlapping purposes: parallel hand-tuned/generated pairs (hcloud_get_server vs hcloud_get_server_raw, hcloud_server_change_type vs _action, hcloud_server_rebuild vs _action, hcloud_server_power vs individual power on/off/reboot/shutdown/reset actions). The numerous per-resource action-listing tools (list_*_actions, get_*_actions, get_*_actions_id, get_*_action) are hard to tell apart, forcing misselection.

Naming Consistency2/5

A hcloud_ prefix is present, but conventions are mixed: some tools are bare get_/list_ while others append _action or _raw; pluralization is inconsistent (e.g. hcloud_get_load_balancers_actions vs hcloud_list_load_balancer_actions) and get_/list_ are used interchangeably for the same concept.

Tool Count1/5

202 tools for one cloud provider API is an extreme mismatch, far exceeding the typical 3-15 range. Much of the surface is redundant per-resource action-listing endpoints and duplicate raw/wrapped variants that bloat the set.

Completeness4/5

Coverage of the Hetzner Cloud domain is essentially complete: full CRUD for servers, networks, firewalls, load balancers, floating/primary IPs, volumes, certificates, and DNS zones/RRSets, plus actions and a raw escape hatch. Minor gaps are deprecated endpoints and some hand-tuned/generated inconsistency, but core lifecycle operations are all present.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues