productivity
Hetzner Cloud CLI for CI
Use the Hetzner Cloud CLI for CI with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write Bearer token auth
Hetzner Cloud CLI for CI
Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status.
Use this shape when a pipeline needs to read or update an external service. The Hetzner Cloud CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Hetzner Cloud CLI for CI
kosmokrator integrations:configure hetzner --set access_token="$HETZNER_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call hetzner.hetzner_list_servers '{"per_page":1,"page":1}' --json Discovery Before Execution
Agents and scripts can inspect Hetzner Cloud docs and schemas before choosing a function.
kosmo integrations:docs hetzner --json
kosmo integrations:docs hetzner.hetzner_list_servers --json
kosmo integrations:schema hetzner.hetzner_list_servers --json
kosmo integrations:search "Hetzner Cloud" --json
kosmo integrations:list --json Useful Hetzner Cloud CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
hetzner.hetzner_list_servers | Read | per_page, page | List Hetzner Cloud servers. Supports pagination with per_page and page parameters. |
hetzner.hetzner_get_server | Read | id | Get details for a specific Hetzner Cloud server by ID. |
hetzner.hetzner_create_server | Write | name, server_type, image, location, ssh_keys, networks, labels, user_data | Create a new Hetzner Cloud server with specified name, type, and image. |
hetzner.hetzner_list_volumes | Read | per_page, page | List Hetzner Cloud volumes. Supports pagination with per_page and page parameters. |
hetzner.hetzner_list_networks | Read | per_page, page | List Hetzner Cloud networks. Supports pagination with per_page and page parameters. |
hetzner.hetzner_list_ssh_keys | Read | per_page, page | List Hetzner Cloud SSH keys. Supports pagination with per_page and page parameters. |
hetzner.hetzner_get_current_user | Read | none | Get the profile of the currently authenticated Hetzner Cloud user. Useful for verifying credentials and displaying account information. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.