Skip to content

Hetzner Cloud MCP Server — 123 tools

The Hetzner Cloud DADL turns Hetzner Cloud's API into an MCP server that Claude, GPT or any MCP-compatible agent can consume directly. One YAML file declares all 123 tools — server, load, floating, primary, volume, firewall, and more — and ToolMesh serves them at runtime. No Python boilerplate, no per-endpoint code, no separate MCP server process.

Below: the endpoint coverage matrix, a two-block ToolMesh setup, the full tool reference grouped by Hetzner Cloud feature area, required credential scopes.

Source: Hetzner Cloud API

Credits: Dunkel Cloud GmbH -- maintainerUpdated: 2026-04-01

Which Hetzner Cloud endpoints are covered?

61% (122 of ~200 endpoints)

Focus: servers, server actions, server metrics, volumes, networks, firewalls, load balancers, load balancer metrics, floating IPs, primary IPs, images, SSH keys, placement groups, certificates, datacenters, locations, server types, ISOs, pricing

Missing: storage boxes (separate API at api.hetzner.com), DNS zones/rrsets (separate API), S3 credential management

Last reviewed: 2026-04-01

How do you configure the Hetzner Cloud DADL?

  1. Log in to Hetzner Cloud Console at https://console.hetzner.cloud
  2. Select or create a project
  3. Navigate to Security -> API Tokens
  4. Click 'Generate API Token'
  5. Enter a description and select Read or Read & Write permissions
  6. Copy the token immediately -- it is shown only once

Environment variable: CREDENTIAL_HETZNER_CLOUD_TOKEN

Authentication docs ↗

API tokens are scoped to a single project. To manage multiple projects, create one token per project. Tokens have either Read or Read & Write permission -- there are no per-resource scopes.

How do you install the Hetzner Cloud MCP server with ToolMesh?

Add to your backends.yaml:

- name: hetzner-cloud
  transport: rest
  dadl: /app/dadl/hetzner-cloud.dadl

Set the credential:

CREDENTIAL_HETZNER_CLOUD_TOKEN=your-token-here

What 123 tools does the Hetzner Cloud DADL expose?

GETlist_serversList all servers. Supports label_selector, name, sort, and status filtering.
GETget_serverGet details of a specific server
POSTcreate_serverCreate a new server. Returns server object and root_password (if no SSH keys). Action is async -- poll the returned action.
PUTupdate_serverUpdate a server's name or labels
DELETEdelete_serverDelete a server immediately. All data on the server is lost. Irreversible.
POSTpower_on_serverPower on a server
POSTpower_off_serverHard power off a server (like pulling the power cord). Use shutdown for graceful stop.
POSTreboot_serverSoft reboot a server (sends ACPI signal)
POSTreset_serverHard reset a server (like pressing the reset button). Use reboot for graceful restart.
POSTshutdown_serverGracefully shut down a server (sends ACPI shutdown signal)
POSTenable_rescue_serverEnable rescue mode. Returns root_password for the rescue system. Reboot to enter rescue.
POSTdisable_rescue_serverDisable rescue mode
POSTrebuild_serverRebuild a server from an image. All data is destroyed. Irreversible.
POSTchange_server_typeChange server type (resize). Server must be off. Disk can only be upgraded, not downgraded.
POSTcreate_image_from_serverCreate a snapshot image from a server
POSTattach_iso_to_serverAttach an ISO to a server
POSTdetach_iso_from_serverDetach any ISO from a server
POSTchange_server_protectionChange delete and rebuild protection for a server
POSTchange_server_dns_ptrChange reverse DNS entry for a server IP
POSTattach_server_to_networkAttach a server to a network
POSTdetach_server_from_networkDetach a server from a network
POSTenable_server_backupEnable automatic backups for a server
POSTdisable_server_backupDisable automatic backups for a server. Existing backups are kept until their expiry.
POSTadd_server_to_placement_groupAdd a server to a placement group. Server must be stopped.
POSTremove_server_from_placement_groupRemove a server from its placement group
GETlist_server_actionsList all actions for a server
GETget_server_actionGet details of a specific server action
GETget_server_metricsGet metrics (time series) for a server. Returns Prometheus-style data points for the requested metric types within the given time range.
GETget_load_balancer_metricsGet metrics for a load balancer. Returns time series for open connections, connections/s, requests/s, and bandwidth.
GETlist_volumesList all volumes
GETget_volumeGet details of a specific volume
POSTcreate_volumeCreate a new volume. Set server to auto-attach, or leave unattached.
PUTupdate_volumeUpdate a volume's name or labels
DELETEdelete_volumeDelete a volume. Must be detached first.
POSTattach_volumeAttach a volume to a server
POSTdetach_volumeDetach a volume from a server
POSTresize_volumeResize a volume. Can only increase size, not decrease.
POSTchange_volume_protectionChange delete protection for a volume
GETlist_networksList all networks
GETget_networkGet details of a specific network
POSTcreate_networkCreate a new network with an RFC 1918 IP range
PUTupdate_networkUpdate a network's name or labels
DELETEdelete_networkDelete a network. All subnets and routes are removed.
POSTadd_subnet_to_networkAdd a subnet to a network
POSTdelete_subnet_from_networkDelete a subnet from a network
POSTadd_route_to_networkAdd a route to a network
POSTdelete_route_from_networkDelete a route from a network
POSTchange_network_protectionChange delete protection for a network
GETlist_firewallsList all firewalls
GETget_firewallGet details of a specific firewall including its rules
POSTcreate_firewallCreate a new firewall with optional initial rules and resource assignments
PUTupdate_firewallUpdate a firewall's name or labels
DELETEdelete_firewallDelete a firewall. Must be unapplied from all resources first.
POSTset_firewall_rulesOverwrite all rules of a firewall. This replaces all existing rules.
POSTapply_firewall_to_resourcesApply a firewall to servers or label selectors
POSTremove_firewall_from_resourcesRemove a firewall from servers or label selectors
GETlist_load_balancersList all load balancers
GETget_load_balancerGet details of a specific load balancer
POSTcreate_load_balancerCreate a new load balancer
PUTupdate_load_balancerUpdate a load balancer's name or labels
DELETEdelete_load_balancerDelete a load balancer
POSTadd_load_balancer_serviceAdd a service (listener) to a load balancer
POSTupdate_load_balancer_serviceUpdate a service on a load balancer
POSTdelete_load_balancer_serviceDelete a service from a load balancer
POSTadd_load_balancer_targetAdd a target to a load balancer
POSTremove_load_balancer_targetRemove a target from a load balancer
POSTchange_load_balancer_typeChange the type of a load balancer
POSTchange_load_balancer_protectionChange delete protection for a load balancer
POSTattach_load_balancer_to_networkAttach a load balancer to a network
POSTdetach_load_balancer_from_networkDetach a load balancer from a network
POSTchange_load_balancer_algorithmChange the balancing algorithm
POSTchange_load_balancer_dns_ptrChange reverse DNS entry for a load balancer IP
GETlist_floating_ipsList all floating IPs
GETget_floating_ipGet details of a specific floating IP
POSTcreate_floating_ipCreate a new floating IP
PUTupdate_floating_ipUpdate a floating IP's name, description, or labels
DELETEdelete_floating_ipDelete a floating IP. Must be unassigned first.
POSTassign_floating_ipAssign a floating IP to a server
POSTunassign_floating_ipUnassign a floating IP from a server
POSTchange_floating_ip_protectionChange delete protection for a floating IP
POSTchange_floating_ip_dns_ptrChange reverse DNS entry for a floating IP
GETlist_primary_ipsList all primary IPs
GETget_primary_ipGet details of a specific primary IP
POSTcreate_primary_ipCreate a new primary IP
PUTupdate_primary_ipUpdate a primary IP's name, labels, or auto_delete setting
DELETEdelete_primary_ipDelete a primary IP. Must be unassigned first.
POSTassign_primary_ipAssign a primary IP to a server
POSTunassign_primary_ipUnassign a primary IP from a server
POSTchange_primary_ip_protectionChange delete protection for a primary IP
POSTchange_primary_ip_dns_ptrChange reverse DNS entry for a primary IP
GETlist_imagesList all images (system, snapshot, backup, app)
GETget_imageGet details of a specific image
PUTupdate_imageUpdate an image's description, type, or labels. Only for snapshot/backup images.
DELETEdelete_imageDelete an image. Only snapshot and backup images can be deleted.
POSTchange_image_protectionChange delete protection for an image
GETlist_ssh_keysList all SSH keys
GETget_ssh_keyGet details of a specific SSH key
POSTcreate_ssh_keyCreate (upload) a new SSH key
PUTupdate_ssh_keyUpdate an SSH key's name or labels
DELETEdelete_ssh_keyDelete an SSH key
GETlist_certificatesList all certificates
GETget_certificateGet details of a specific certificate
POSTcreate_certificateCreate a certificate (upload or request managed via Let's Encrypt)
PUTupdate_certificateUpdate a certificate's name or labels
DELETEdelete_certificateDelete a certificate
GETlist_placement_groupsList all placement groups
GETget_placement_groupGet details of a specific placement group
POSTcreate_placement_groupCreate a new placement group
PUTupdate_placement_groupUpdate a placement group's name or labels
DELETEdelete_placement_groupDelete a placement group. Must have no servers assigned.
GETlist_actionsList all actions across all resources
GETget_actionGet details of a specific action
GETlist_server_typesList all available server types with specs and pricing
GETget_server_typeGet details of a specific server type
GETlist_locationsList all available locations
GETget_locationGet details of a specific location
GETlist_datacentersList all available datacenters
GETget_datacenterGet details of a specific datacenter
GETlist_isosList all available ISO images
GETget_isoGet details of a specific ISO image
GETlist_load_balancer_typesList all available load balancer types
GETget_load_balancer_typeGet details of a specific load balancer type
GETget_pricingGet all pricing information for server types, images, volumes, floating IPs, load balancers, and traffic