KosmoKrator

productivity

Hetzner Cloud MCP Gateway for AI Agents

Expose Hetzner Cloud tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

Hetzner Cloud MCP Gateway

Expose Hetzner Cloud to MCP clients with `kosmokrator mcp:serve --integration=hetzner`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server.

Install KosmoKrator
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
Install gateway entry
kosmokrator mcp:gateway:install --integration=hetzner --write=deny --json
MCP configuration
{
  "mcpServers": {
    "kosmokrator-hetzner": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=hetzner",
        "--write=deny"
      ]
    }
  }
}
Serve manually
kosmokrator mcp:serve --integration=hetzner --write=deny

Client Notes

Use one scoped MCP gateway entry, then adapt the config location to the client or framework.

Claude Code Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry. Claude Code can launch the local kosmo binary directly from the project MCP config.
Cursor Expose selected local integrations to Cursor through KosmoKrator without configuring each service as its own MCP server. Use the same KosmoKrator install and integration credentials that power terminal and headless runs.
Codex Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy. Keep write access denied or ask-based unless the workspace is trusted.
OpenAI Agents SDK Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway. Use headless JSON commands for CI-style execution and MCP for agent tool discovery.
Claude Agent SDK Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server. Use a narrow integration list so the agent does not load unrelated tools.
Vercel AI SDK Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts. Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.
LangChain Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls. Keep the gateway scoped to the integration and operation class needed by the chain.
LangGraph Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions. Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.
CrewAI Expose KosmoKrator integrations to CrewAI workers as scoped local tools. Use per-worker integration scopes to avoid giving every worker every tool.
Generic MCP Clients Connect any stdio-compatible MCP client to local KosmoKrator integration tools. Start with read-only write policy and expand only for trusted projects.

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names.

MCP toolSource functionType
integration__hetzner__hetzner_get_actions hetzner.hetzner_get_actions Read read
integration__hetzner__hetzner_get_action hetzner.hetzner_get_action Read read
integration__hetzner__hetzner_list_certificates hetzner.hetzner_list_certificates Read read
integration__hetzner__hetzner_create_certificate hetzner.hetzner_create_certificate Write write
integration__hetzner__hetzner_list_certificates_actions hetzner.hetzner_list_certificates_actions Read read
integration__hetzner__hetzner_get_certificates_action hetzner.hetzner_get_certificates_action Read read
integration__hetzner__hetzner_get_certificate hetzner.hetzner_get_certificate Read read
integration__hetzner__hetzner_update_certificate hetzner.hetzner_update_certificate Write write
integration__hetzner__hetzner_delete_certificate hetzner.hetzner_delete_certificate Write write
integration__hetzner__hetzner_list_certificate_actions hetzner.hetzner_list_certificate_actions Read read
integration__hetzner__hetzner_retry_certificate hetzner.hetzner_retry_certificate Write write
integration__hetzner__hetzner_get_certificate_action hetzner.hetzner_get_certificate_action Read read
integration__hetzner__hetzner_list_datacenters hetzner.hetzner_list_datacenters Read read
integration__hetzner__hetzner_get_datacenter hetzner.hetzner_get_datacenter Read read
integration__hetzner__hetzner_list_firewalls hetzner.hetzner_list_firewalls Read read
integration__hetzner__hetzner_create_firewall hetzner.hetzner_create_firewall Write write
integration__hetzner__hetzner_list_firewalls_actions hetzner.hetzner_list_firewalls_actions Read read
integration__hetzner__hetzner_get_firewalls_action hetzner.hetzner_get_firewalls_action Read read
integration__hetzner__hetzner_get_firewall hetzner.hetzner_get_firewall Read read
integration__hetzner__hetzner_update_firewall hetzner.hetzner_update_firewall Write write
integration__hetzner__hetzner_delete_firewall hetzner.hetzner_delete_firewall Write write
integration__hetzner__hetzner_list_firewall_actions hetzner.hetzner_list_firewall_actions Read read
integration__hetzner__hetzner_apply_firewall_to_resources hetzner.hetzner_apply_firewall_to_resources Write write
integration__hetzner__hetzner_remove_firewall_from_resources hetzner.hetzner_remove_firewall_from_resources Write write
integration__hetzner__hetzner_set_firewall_rules hetzner.hetzner_set_firewall_rules Write write
integration__hetzner__hetzner_get_firewall_action hetzner.hetzner_get_firewall_action Read read
integration__hetzner__hetzner_list_floating_ips hetzner.hetzner_list_floating_ips Read read
integration__hetzner__hetzner_create_floating_ip hetzner.hetzner_create_floating_ip Write write
integration__hetzner__hetzner_list_floating_ips_actions hetzner.hetzner_list_floating_ips_actions Read read
integration__hetzner__hetzner_get_floating_ips_action hetzner.hetzner_get_floating_ips_action Read read
integration__hetzner__hetzner_get_floating_ip hetzner.hetzner_get_floating_ip Read read
integration__hetzner__hetzner_update_floating_ip hetzner.hetzner_update_floating_ip Write write
integration__hetzner__hetzner_delete_floating_ip hetzner.hetzner_delete_floating_ip Write write
integration__hetzner__hetzner_list_floating_ip_actions hetzner.hetzner_list_floating_ip_actions Read read
integration__hetzner__hetzner_assign_floating_ip hetzner.hetzner_assign_floating_ip Write write
integration__hetzner__hetzner_change_floating_ip_dns_ptr hetzner.hetzner_change_floating_ip_dns_ptr Write write
integration__hetzner__hetzner_change_floating_ip_protection hetzner.hetzner_change_floating_ip_protection Write write
integration__hetzner__hetzner_unassign_floating_ip hetzner.hetzner_unassign_floating_ip Write write
integration__hetzner__hetzner_get_floating_ip_action hetzner.hetzner_get_floating_ip_action Read read
integration__hetzner__hetzner_list_images hetzner.hetzner_list_images Read read
integration__hetzner__hetzner_list_images_actions hetzner.hetzner_list_images_actions Read read
integration__hetzner__hetzner_get_images_action hetzner.hetzner_get_images_action Read read
integration__hetzner__hetzner_get_image hetzner.hetzner_get_image Read read
integration__hetzner__hetzner_update_image hetzner.hetzner_update_image Write write
integration__hetzner__hetzner_delete_image hetzner.hetzner_delete_image Write write
integration__hetzner__hetzner_list_image_actions hetzner.hetzner_list_image_actions Read read
integration__hetzner__hetzner_change_image_protection hetzner.hetzner_change_image_protection Write write
integration__hetzner__hetzner_get_image_action hetzner.hetzner_get_image_action Read read
integration__hetzner__hetzner_list_isos hetzner.hetzner_list_isos Read read
integration__hetzner__hetzner_get_iso hetzner.hetzner_get_iso Read read
integration__hetzner__hetzner_list_load_balancer_types hetzner.hetzner_list_load_balancer_types Read read
integration__hetzner__hetzner_get_load_balancer_type hetzner.hetzner_get_load_balancer_type Read read
integration__hetzner__hetzner_list_load_balancers hetzner.hetzner_list_load_balancers Read read
integration__hetzner__hetzner_create_load_balancer hetzner.hetzner_create_load_balancer Write write
integration__hetzner__hetzner_list_load_balancers_actions hetzner.hetzner_list_load_balancers_actions Read read
integration__hetzner__hetzner_get_load_balancers_action hetzner.hetzner_get_load_balancers_action Read read
integration__hetzner__hetzner_get_load_balancer hetzner.hetzner_get_load_balancer Read read
integration__hetzner__hetzner_update_load_balancer hetzner.hetzner_update_load_balancer Write write
integration__hetzner__hetzner_delete_load_balancer hetzner.hetzner_delete_load_balancer Write write
integration__hetzner__hetzner_list_load_balancer_actions hetzner.hetzner_list_load_balancer_actions Read read
integration__hetzner__hetzner_add_load_balancer_service hetzner.hetzner_add_load_balancer_service Write write
integration__hetzner__hetzner_add_load_balancer_target hetzner.hetzner_add_load_balancer_target Write write
integration__hetzner__hetzner_attach_load_balancer_to_network hetzner.hetzner_attach_load_balancer_to_network Write write
integration__hetzner__hetzner_change_load_balancer_algorithm hetzner.hetzner_change_load_balancer_algorithm Write write
integration__hetzner__hetzner_change_load_balancer_dns_ptr hetzner.hetzner_change_load_balancer_dns_ptr Write write
integration__hetzner__hetzner_change_load_balancer_protection hetzner.hetzner_change_load_balancer_protection Write write
integration__hetzner__hetzner_change_load_balancer_type hetzner.hetzner_change_load_balancer_type Write write
integration__hetzner__hetzner_delete_load_balancer_service hetzner.hetzner_delete_load_balancer_service Write write
integration__hetzner__hetzner_detach_load_balancer_from_network hetzner.hetzner_detach_load_balancer_from_network Write write
integration__hetzner__hetzner_disable_load_balancer_public_interface hetzner.hetzner_disable_load_balancer_public_interface Write write
integration__hetzner__hetzner_enable_load_balancer_public_interface hetzner.hetzner_enable_load_balancer_public_interface Write write
integration__hetzner__hetzner_remove_load_balancer_target hetzner.hetzner_remove_load_balancer_target Write write
integration__hetzner__hetzner_update_load_balancer_service hetzner.hetzner_update_load_balancer_service Write write
integration__hetzner__hetzner_get_load_balancer_action hetzner.hetzner_get_load_balancer_action Read read
integration__hetzner__hetzner_get_load_balancer_metrics hetzner.hetzner_get_load_balancer_metrics Read read
integration__hetzner__hetzner_list_locations hetzner.hetzner_list_locations Read read
integration__hetzner__hetzner_get_location hetzner.hetzner_get_location Read read
integration__hetzner__hetzner_list_networks hetzner.hetzner_list_networks Read read
integration__hetzner__hetzner_create_network hetzner.hetzner_create_network Write write
integration__hetzner__hetzner_list_networks_actions hetzner.hetzner_list_networks_actions Read read
integration__hetzner__hetzner_get_networks_action hetzner.hetzner_get_networks_action Read read
integration__hetzner__hetzner_get_network hetzner.hetzner_get_network Read read
integration__hetzner__hetzner_update_network hetzner.hetzner_update_network Write write
integration__hetzner__hetzner_delete_network hetzner.hetzner_delete_network Write write
integration__hetzner__hetzner_list_network_actions hetzner.hetzner_list_network_actions Read read
integration__hetzner__hetzner_add_network_route hetzner.hetzner_add_network_route Write write
integration__hetzner__hetzner_add_network_subnet hetzner.hetzner_add_network_subnet Write write
integration__hetzner__hetzner_change_network_ip_range hetzner.hetzner_change_network_ip_range Write write
integration__hetzner__hetzner_change_network_protection hetzner.hetzner_change_network_protection Write write
integration__hetzner__hetzner_delete_network_route hetzner.hetzner_delete_network_route Write write
integration__hetzner__hetzner_delete_network_subnet hetzner.hetzner_delete_network_subnet Write write
integration__hetzner__hetzner_get_network_action hetzner.hetzner_get_network_action Read read
integration__hetzner__hetzner_list_placement_groups hetzner.hetzner_list_placement_groups Read read
integration__hetzner__hetzner_create_placement_group hetzner.hetzner_create_placement_group Write write
integration__hetzner__hetzner_get_placement_group hetzner.hetzner_get_placement_group Read read
integration__hetzner__hetzner_update_placement_group hetzner.hetzner_update_placement_group Write write
integration__hetzner__hetzner_delete_placement_group hetzner.hetzner_delete_placement_group Write write
integration__hetzner__hetzner_get_pricing hetzner.hetzner_get_pricing Read read
integration__hetzner__hetzner_list_primary_ips hetzner.hetzner_list_primary_ips Read read
integration__hetzner__hetzner_create_primary_ip hetzner.hetzner_create_primary_ip Write write
integration__hetzner__hetzner_list_primary_ips_actions hetzner.hetzner_list_primary_ips_actions Read read
integration__hetzner__hetzner_get_primary_ips_action hetzner.hetzner_get_primary_ips_action Read read
integration__hetzner__hetzner_list_primary_ip_actions hetzner.hetzner_list_primary_ip_actions Read read
integration__hetzner__hetzner_get_primary_ip_action hetzner.hetzner_get_primary_ip_action Read read
integration__hetzner__hetzner_get_primary_ip hetzner.hetzner_get_primary_ip Read read
integration__hetzner__hetzner_update_primary_ip hetzner.hetzner_update_primary_ip Write write
integration__hetzner__hetzner_delete_primary_ip hetzner.hetzner_delete_primary_ip Write write
integration__hetzner__hetzner_assign_primary_ip hetzner.hetzner_assign_primary_ip Write write
integration__hetzner__hetzner_change_primary_ip_dns_ptr hetzner.hetzner_change_primary_ip_dns_ptr Write write
integration__hetzner__hetzner_change_primary_ip_protection hetzner.hetzner_change_primary_ip_protection Write write
integration__hetzner__hetzner_unassign_primary_ip hetzner.hetzner_unassign_primary_ip Write write
integration__hetzner__hetzner_list_server_types hetzner.hetzner_list_server_types Read read
integration__hetzner__hetzner_get_server_type hetzner.hetzner_get_server_type Read read
integration__hetzner__hetzner_list_servers hetzner.hetzner_list_servers Read read
integration__hetzner__hetzner_create_server hetzner.hetzner_create_server Write write
integration__hetzner__hetzner_list_servers_actions hetzner.hetzner_list_servers_actions Read read
integration__hetzner__hetzner_get_servers_action hetzner.hetzner_get_servers_action Read read
integration__hetzner__hetzner_get_server hetzner.hetzner_get_server Read read
integration__hetzner__hetzner_update_server hetzner.hetzner_update_server Write write
integration__hetzner__hetzner_delete_server hetzner.hetzner_delete_server Write write
integration__hetzner__hetzner_list_server_actions hetzner.hetzner_list_server_actions Read read
integration__hetzner__hetzner_add_server_to_placement_group hetzner.hetzner_add_server_to_placement_group Write write
integration__hetzner__hetzner_attach_server_iso hetzner.hetzner_attach_server_iso Write write
integration__hetzner__hetzner_attach_server_to_network hetzner.hetzner_attach_server_to_network Write write
integration__hetzner__hetzner_change_server_alias_ips hetzner.hetzner_change_server_alias_ips Write write
integration__hetzner__hetzner_change_server_dns_ptr hetzner.hetzner_change_server_dns_ptr Write write
integration__hetzner__hetzner_change_server_protection hetzner.hetzner_change_server_protection Write write
integration__hetzner__hetzner_change_server_type hetzner.hetzner_change_server_type Write write
integration__hetzner__hetzner_create_server_image hetzner.hetzner_create_server_image Write write
integration__hetzner__hetzner_detach_server_from_network hetzner.hetzner_detach_server_from_network Write write
integration__hetzner__hetzner_detach_server_iso hetzner.hetzner_detach_server_iso Write write
integration__hetzner__hetzner_disable_server_backup hetzner.hetzner_disable_server_backup Write write
integration__hetzner__hetzner_disable_server_rescue hetzner.hetzner_disable_server_rescue Write write
integration__hetzner__hetzner_enable_server_backup hetzner.hetzner_enable_server_backup Write write
integration__hetzner__hetzner_enable_server_rescue hetzner.hetzner_enable_server_rescue Write write
integration__hetzner__hetzner_poweroff_server hetzner.hetzner_poweroff_server Write write
integration__hetzner__hetzner_poweron_server hetzner.hetzner_poweron_server Write write
integration__hetzner__hetzner_reboot_server hetzner.hetzner_reboot_server Write write
integration__hetzner__hetzner_rebuild_server hetzner.hetzner_rebuild_server Write write
integration__hetzner__hetzner_remove_server_from_placement_group hetzner.hetzner_remove_server_from_placement_group Write write
integration__hetzner__hetzner_request_server_console hetzner.hetzner_request_server_console Write write
integration__hetzner__hetzner_reset_server hetzner.hetzner_reset_server Write write
integration__hetzner__hetzner_reset_server_password hetzner.hetzner_reset_server_password Write write
integration__hetzner__hetzner_shutdown_server hetzner.hetzner_shutdown_server Write write
integration__hetzner__hetzner_get_server_action hetzner.hetzner_get_server_action Read read
integration__hetzner__hetzner_get_server_metrics hetzner.hetzner_get_server_metrics Read read
integration__hetzner__hetzner_list_ssh_keys hetzner.hetzner_list_ssh_keys Read read
integration__hetzner__hetzner_create_ssh_key hetzner.hetzner_create_ssh_key Write write
integration__hetzner__hetzner_get_ssh_key hetzner.hetzner_get_ssh_key Read read
integration__hetzner__hetzner_update_ssh_key hetzner.hetzner_update_ssh_key Write write
integration__hetzner__hetzner_delete_ssh_key hetzner.hetzner_delete_ssh_key Write write
integration__hetzner__hetzner_list_volumes hetzner.hetzner_list_volumes Read read
integration__hetzner__hetzner_create_volume hetzner.hetzner_create_volume Write write
integration__hetzner__hetzner_list_volumes_actions hetzner.hetzner_list_volumes_actions Read read
integration__hetzner__hetzner_get_volumes_action hetzner.hetzner_get_volumes_action Read read
integration__hetzner__hetzner_get_volume hetzner.hetzner_get_volume Read read
integration__hetzner__hetzner_update_volume hetzner.hetzner_update_volume Write write
integration__hetzner__hetzner_delete_volume hetzner.hetzner_delete_volume Write write
integration__hetzner__hetzner_list_volume_actions hetzner.hetzner_list_volume_actions Read read
integration__hetzner__hetzner_attach_volume hetzner.hetzner_attach_volume Write write
integration__hetzner__hetzner_change_volume_protection hetzner.hetzner_change_volume_protection Write write
integration__hetzner__hetzner_detach_volume hetzner.hetzner_detach_volume Write write
integration__hetzner__hetzner_resize_volume hetzner.hetzner_resize_volume Write write
integration__hetzner__hetzner_get_volume_action hetzner.hetzner_get_volume_action Read read
integration__hetzner__hetzner_list_zones hetzner.hetzner_list_zones Read read
integration__hetzner__hetzner_create_zone hetzner.hetzner_create_zone Write write
integration__hetzner__hetzner_get_zone hetzner.hetzner_get_zone Read read
integration__hetzner__hetzner_update_zone hetzner.hetzner_update_zone Write write
integration__hetzner__hetzner_delete_zone hetzner.hetzner_delete_zone Write write
integration__hetzner__hetzner_get_zone_zonefile hetzner.hetzner_get_zone_zonefile Read read
integration__hetzner__hetzner_list_zones_actions hetzner.hetzner_list_zones_actions Read read
integration__hetzner__hetzner_get_zones_action hetzner.hetzner_get_zones_action Read read
integration__hetzner__hetzner_list_zone_actions hetzner.hetzner_list_zone_actions Read read
integration__hetzner__hetzner_get_zone_action hetzner.hetzner_get_zone_action Read read
integration__hetzner__hetzner_change_zone_primary_nameservers hetzner.hetzner_change_zone_primary_nameservers Write write
integration__hetzner__hetzner_change_zone_protection hetzner.hetzner_change_zone_protection Write write
integration__hetzner__hetzner_change_zone_ttl hetzner.hetzner_change_zone_ttl Write write
integration__hetzner__hetzner_import_zone_zonefile hetzner.hetzner_import_zone_zonefile Write write
integration__hetzner__hetzner_list_zone_rrsets hetzner.hetzner_list_zone_rrsets Read read
integration__hetzner__hetzner_create_zone_rrset hetzner.hetzner_create_zone_rrset Write write
integration__hetzner__hetzner_get_zone_rrset hetzner.hetzner_get_zone_rrset Read read
integration__hetzner__hetzner_update_zone_rrset hetzner.hetzner_update_zone_rrset Write write
integration__hetzner__hetzner_delete_zone_rrset hetzner.hetzner_delete_zone_rrset Write write
integration__hetzner__hetzner_change_zone_rrset_protection hetzner.hetzner_change_zone_rrset_protection Write write
integration__hetzner__hetzner_change_zone_rrset_ttl hetzner.hetzner_change_zone_rrset_ttl Write write
integration__hetzner__hetzner_set_zone_rrset_records hetzner.hetzner_set_zone_rrset_records Write write
integration__hetzner__hetzner_add_zone_rrset_records hetzner.hetzner_add_zone_rrset_records Write write
integration__hetzner__hetzner_remove_zone_rrset_records hetzner.hetzner_remove_zone_rrset_records Write write
integration__hetzner__hetzner_update_zone_rrset_records hetzner.hetzner_update_zone_rrset_records Write write

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.