Hetzner Cloud MCP Server

Instructions

Delete a server.

Permanently deletes a server identified by its ID.

Example:
- Delete server: {"server_id": 12345}

Implementation Reference

• mcp_hetzner/server.py:379-411 (handler)

  The handler function for the 'delete_server' MCP tool. It retrieves the server by ID using the Hetzner Cloud client and initiates its deletion, returning the action details.

  @mcp.tool()
  def delete_server(params: ServerIdParam) -> Dict[str, Any]:
      """
      Delete a server.
      
      Permanently deletes a server identified by its ID.
      
      Example:
      - Delete server: {"server_id": 12345}
      """
      try:
          server = client.servers.get_by_id(params.server_id)
          if not server:
              return {"error": f"Server with ID {params.server_id} not found"}
              
          action = client.servers.delete(server)
          
          # Don't wait for the action to complete - the method doesn't exist
          return {
              "success": True,
              "action": {
                  "id": action.id,
                  "status": action.status,
                  "command": action.command,
                  "progress": action.progress,
                  "error": action.error,
                  "started": action.started.isoformat() if action.started else None,
                  "finished": action.finished.isoformat() if action.finished else None,
              } if action else None,
          }
      except Exception as e:
          return {"error": f"Failed to delete server: {str(e)}"}

• mcp_hetzner/server.py:169-171 (schema)

  Pydantic BaseModel defining the input schema for the delete_server tool (and other server-related tools), requiring a server_id integer.

  class ServerIdParam(BaseModel):
      server_id: int = Field(..., description="The ID of the server")

• mcp_hetzner/server.py:379-379 (registration)

  The @mcp.tool() decorator registers the delete_server function as an MCP tool.

  @mcp.tool()