Contents of the docs
hetzner-mcp · Docs
Configuration
All environment variables of hetzner-mcp with defaults, tool filters and API token.
Environment variables
hetzner-mcp is configured entirely through environment variables. A template is in .env.example.
| Name | Default | Description |
|---|---|---|
HETZNER_API_TOKEN |
– | API token of a Hetzner Cloud project. Required unless only HETZNER_STORAGE_API_TOKEN is set. |
HETZNER_STORAGE_API_TOKEN |
– | Separate token for Storage Boxes. Falls back to HETZNER_API_TOKEN. |
HOST |
0.0.0.0 |
Listen address. |
PORT |
3000 |
Listen port. |
MCP_PATH |
/mcp |
Path of the MCP endpoint. |
MCP_SPLITS |
all |
all or a comma separated list of servers, networking, load-balancers, ips, storage, storage-boxes, config, dns. |
MCP_READ_ONLY |
true |
Expose only tools with readOnlyHint: true. Accepts true/false, 1/0, yes/no, on/off. |
MCP_TOOLS_ALLOW |
– | Comma separated tool names to keep. * is a wildcard. |
MCP_TOOLS_DENY |
– | Comma separated tool names to remove. * is a wildcard. |
MCP_AUTH_TOKEN |
– | If set, /mcp requires the header Authorization: Bearer <token>. |
Invalid values (unknown group, bad port, broken boolean) stop the server at startup with a clear error.
Get an API token
- Open the project in the Hetzner Console.
- Security → API tokens → Generate API token.
- Choose permission Read. That is enough for the default mode.
- Copy the token and set it as
HETZNER_API_TOKEN.
Important
Hetzner shows the token only once. Store it right away in your password manager or the .env on your server.
You only need Read & Write if you set MCP_READ_ONLY=false and really want Claude to change things. Read Security first.
Tool filters
Filters are applied in this order:
MCP_SPLITSloads only the selected groups.MCP_READ_ONLYdrops all write tools.MCP_TOOLS_ALLOWkeeps only matching tools (if set).MCP_TOOLS_DENYremoves matching tools.
Examples:
# Only servers, IPs and prices
MCP_SPLITS=servers,ips
# Only list and get tools
MCP_TOOLS_ALLOW=hetzner_list_*,hetzner_get_*
# Writing allowed, but no deletes
MCP_READ_ONLY=false
MCP_TOOLS_DENY=hetzner_delete_*See Tools for which tools belong to which group.
Example
HETZNER_API_TOKEN=your-read-token
MCP_SPLITS=all
MCP_READ_ONLY=true
MCP_TOOLS_DENY=hetzner_get_server_metrics