@mguttmann/hetzner-cloud-mcp 0.1.0

package/dist/tools/generated/tools.js

@@ -0,0 +1,162 @@
+import { fetchAllPages } from "../../http/pagination.js";
+import { pollAction } from "../../http/action-polling.js";
+import { asToolError } from "../_error.js";
+function inputSchemaFor(op) {
+    const properties = {};
+    const required = [];
+    for (const p of op.parameters) {
+        properties[p.name] = {
+            ...p.schema,
+            ...(p.description ? { description: p.description } : {}),
+        };
+        if (p.required)
+            required.push(p.name);
+    }
+    if (op.requestBodySchema) {
+        properties.body = op.requestBodySchema;
+        if (op.requestBodyRequired)
+            required.push("body");
+    }
+    if (op.returnsAction) {
+        properties.wait = {
+            type: "boolean",
+            default: true,
+            description: "Poll the resulting action until success/error or timeout.",
+        };
+    }
+    // page/per_page convenience for list endpoints (top-level or per-resource action history)
+    if (isListEndpoint(op)) {
+        properties.auto_paginate = {
+            type: "boolean",
+            default: true,
+            description: "Auto-merge all pages up to the soft-cap. Set false to use raw page/per_page.",
+        };
+    }
+    return {
+        type: "object",
+        properties,
+        required,
+        additionalProperties: false,
+    };
+}
+function buildPath(path, params) {
+    return path.replace(/\{([^}]+)\}/g, (_, name) => {
+        const v = params[name];
+        if (v === undefined || v === null) {
+            throw new Error(`Missing path parameter "${name}" for ${path}`);
+        }
+        return encodeURIComponent(String(v));
+    });
+}
+function splitInput(op, input) {
+    const pathVars = {};
+    const query = {};
+    const paramByName = new Map(op.parameters.map((p) => [p.name, p]));
+    for (const [k, v] of Object.entries(input)) {
+        if (k === "body" || k === "wait" || k === "auto_paginate")
+            continue;
+        const p = paramByName.get(k);
+        if (!p)
+            continue; // ignore unknown — schema will have caught it server-side
+        if (p.in === "path")
+            pathVars[k] = v;
+        else if (p.in === "query")
+            query[k] = v;
+    }
+    return {
+        pathVars,
+        query,
+        body: input.body,
+        wait: input.wait !== false,
+        autoPaginate: input.auto_paginate !== false,
+    };
+}
+function isPathParam(seg) {
+    return seg.startsWith("{") && seg.endsWith("}");
+}
+function isListEndpoint(op) {
+    if (op.method !== "GET")
+        return false;
+    const segs = op.path.split("/").filter(Boolean);
+    // Top-level list: /servers, /actions, /zones, ...
+    if (segs.length === 1 && !isPathParam(segs[0]))
+        return true;
+    // Per-resource action history: /servers/{id}/actions, /zones/{id_or_name}/actions, ...
+    if (segs.length === 3 &&
+        !isPathParam(segs[0]) &&
+        isPathParam(segs[1]) &&
+        segs[2] === "actions") {
+        return true;
+    }
+    return false;
+}
+function resourceKey(op) {
+    const segs = op.path.split("/").filter(Boolean);
+    // Use the last non-param segment as the resource key. For /servers it's "servers";
+    // for /servers/{id}/actions it's "actions".
+    for (let i = segs.length - 1; i >= 0; i--) {
+        const s = segs[i];
+        if (!isPathParam(s))
+            return s;
+    }
+    // Shouldn't happen on a list endpoint, but keep a safe fallback.
+    return segs[0];
+}
+export function buildGeneratedTools(client, operations, limits) {
+    const request = client.request.bind(client);
+    return operations.map((op) => ({
+        name: op.toolName,
+        description: [op.summary, op.description].filter(Boolean).join("\n\n") ||
+            `${op.method} ${op.path}`,
+        inputSchema: inputSchemaFor(op),
+        annotations: {
+            readOnlyHint: op.method === "GET",
+            destructiveHint: op.isDestructive,
+            openWorldHint: true,
+        },
+        handler: async (rawInput) => {
+            const { pathVars, query, body, wait, autoPaginate } = splitInput(op, rawInput);
+            const finalPath = buildPath(op.path, pathVars);
+            // Auto-paginate list endpoints when no explicit page is given
+            if (isListEndpoint(op) && autoPaginate && query.page === undefined) {
+                const merged = await fetchAllPages(request, op.method, finalPath, query, { resourceKey: resourceKey(op), maxItems: limits.maxItems, maxPages: limits.maxPages });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ [resourceKey(op)]: merged.items, truncated: merged.truncated, pagination: merged.pagination ?? null }, null, 2),
+                        },
+                    ],
+                };
+            }
+            const res = await request(op.method, finalPath, { query: query, body });
+            // Hetzner 4xx/5xx -> typed error -> isError:true ToolResult
+            const errResult = asToolError(res);
+            if (errResult)
+                return errResult;
+            // If this returns an Action and caller wants to wait, poll it
+            if (op.returnsAction && wait && res.body?.action?.id) {
+                const pollOpts = limits.actionPoll ?? { timeoutMs: 60_000, intervalMs: 2_000 };
+                const result = await pollAction(request, res.body.action.id, pollOpts);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                ...(res.body ?? {}),
+                                action: result.action,
+                                polling_timed_out: result.timedOut,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(res.body ?? {}, null, 2) },
+                ],
+            };
+        },
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools/generated/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/tools/generated/tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/raw_request.js

@@ -0,0 +1,87 @@
+const VALID = ["GET", "POST", "PUT", "PATCH", "DELETE"];
+export function makeRawRequestTool(deps) {
+    return {
+        name: "hcloud_raw_request",
+        description: "Escape hatch: issue an arbitrary request against the Hetzner Cloud API. Bearer auth, retries and pagination are NOT applied automatically — this is a pass-through. Use only when no dedicated tool fits.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                method: { type: "string", enum: VALID },
+                path: {
+                    type: "string",
+                    pattern: "^/.+",
+                    description: "Path beginning with '/', e.g. '/servers/42/actions/poweron'.",
+                },
+                query: { type: "object", additionalProperties: true },
+                body: {
+                    type: ["object", "array", "string", "number", "boolean", "null"],
+                    description: "Request body, JSON-serialised when sent.",
+                },
+                confirm: {
+                    type: "string",
+                    enum: ["YES"],
+                    description: 'Required when HETZNER_CONFIRM_WRITES=true and method is not GET. Set to "YES" to actually execute; without it the tool returns a preview only. Ignored for GET and when confirm mode is disabled.',
+                },
+            },
+            required: ["method", "path"],
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+        handler: async (input) => {
+            const method = input.method;
+            const path = input.path;
+            if (!VALID.includes(method)) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Unsupported method "${String(input.method)}". Allowed: ${VALID.join(", ")}.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (typeof path !== "string" || !path.startsWith("/")) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Path must start with "/", got: ${JSON.stringify(input.path)}.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const isWrite = method !== "GET";
+            if (isWrite && deps.confirmWrites && input.confirm !== "YES") {
+                const { confirm: _drop, ...preview } = input;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `PREVIEW — would execute hcloud_raw_request\n` +
+                                `Input: ${JSON.stringify(preview, null, 2)}\n` +
+                                `To execute, retry the same call with confirm: "YES".`,
+                        },
+                    ],
+                };
+            }
+            const res = await deps.client.request(method, path, {
+                query: input.query,
+                body: input.body,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            status: res.status,
+                            body: res.body ?? null,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+    };
+}
+//# sourceMappingURL=raw_request.js.map

package/dist/tools/raw_request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw_request.js","sourceRoot":"","sources":["../../src/tools/raw_request.ts"],"names":[],"mappings":"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"}

package/dist/tools/registry.js

@@ -0,0 +1,19 @@
+export class ToolRegistry {
+    byName = new Map();
+    register(tool) {
+        if (this.byName.has(tool.name)) {
+            throw new Error(`Tool "${tool.name}" is already registered`);
+        }
+        this.byName.set(tool.name, tool);
+    }
+    getAll() {
+        return Array.from(this.byName.values()).sort((a, b) => a.name.localeCompare(b.name));
+    }
+    getByName(name) {
+        return this.byName.get(name);
+    }
+    size() {
+        return this.byName.size;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IACN,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;IAErD,QAAQ,CAAC,IAAa;QACpB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACpD,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7B,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF"}

package/dist/tools/wait_action.js

@@ -0,0 +1,37 @@
+import { pollAction } from "../http/action-polling.js";
+export function makeWaitActionTool(deps) {
+    return {
+        name: "hcloud_wait_action",
+        description: "Poll an existing Hetzner Cloud action until it reaches terminal status (success/error) or the timeout elapses. Returns the final action plus a polling_timed_out flag.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer", minimum: 1 },
+                timeout_ms: { type: "integer", minimum: 1, description: "Override the default poll timeout for this call." },
+                interval_ms: { type: "integer", minimum: 1, description: "Override the default poll interval for this call." },
+            },
+            required: ["id"],
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
+        handler: async (input) => {
+            const id = input.id;
+            const opts = {
+                timeoutMs: typeof input.timeout_ms === "number" ? input.timeout_ms : deps.defaultPoll.timeoutMs,
+                intervalMs: typeof input.interval_ms === "number" ? input.interval_ms : deps.defaultPoll.intervalMs,
+                ...(deps.defaultPoll.sleep ? { sleep: deps.defaultPoll.sleep } : {}),
+                ...(deps.defaultPoll.now ? { now: deps.defaultPoll.now } : {}),
+            };
+            const result = await pollAction(deps.client.request.bind(deps.client), id, opts);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ action: result.action, polling_timed_out: result.timedOut }, null, 2),
+                    },
+                ],
+            };
+        },
+    };
+}
+//# sourceMappingURL=wait_action.js.map

package/dist/tools/wait_action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait_action.js","sourceRoot":"","sources":["../../src/tools/wait_action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAoB,MAAM,2BAA2B,CAAC;AAOzE,MAAM,UAAU,kBAAkB,CAAC,IAAoB;IACrD,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,wKAAwK;QAC1K,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;gBACnC,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,kDAAkD,EAAE;gBAC5G,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,mDAAmD,EAAE;aAC/G;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;YAChB,oBAAoB,EAAE,KAAK;SAC5B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QAChF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAuB,EAAE;YAC5C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAY,CAAC;YAC9B,MAAM,IAAI,GAAgB;gBACxB,SAAS,EAAE,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS;gBAC/F,UAAU,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU;gBACnG,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAqC,EACzE,EAAE,EACF,IAAI,CACL,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,EAC7D,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/wrappers/_server_action.js

@@ -0,0 +1,23 @@
+import { pollAction } from "../../http/action-polling.js";
+import { asToolError } from "../_error.js";
+export async function runServerAction(deps, serverId, action, body, wait) {
+    const res = await deps.client.request("POST", `/servers/${serverId}/actions/${action}`, body ? { body } : {});
+    const errResult = asToolError(res);
+    if (errResult)
+        return errResult;
+    if (!wait || !res.body?.action?.id) {
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.body ?? {}, null, 2) }],
+        };
+    }
+    const polled = await pollAction(deps.client.request.bind(deps.client), res.body.action.id, deps.actionPoll);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ ...(res.body ?? {}), action: polled.action, polling_timed_out: polled.timedOut }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=_server_action.js.map

package/dist/tools/wrappers/_server_action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_server_action.js","sourceRoot":"","sources":["../../../src/tools/wrappers/_server_action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAoB,MAAM,8BAA8B,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAsB,EACtB,QAAgB,EAChB,MAAc,EACd,IAAyC,EACzC,IAAa;IAEb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACnC,MAAM,EACN,YAAY,QAAQ,YAAY,MAAM,EAAE,EACxC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CACrB,CAAC;IACF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC3E,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAqC,EACzE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAClB,IAAI,CAAC,UAAU,CAChB,CAAC;IACF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,EAClF,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/wrappers/apply_firewall_to_server.js

@@ -0,0 +1,47 @@
+import { asToolError } from "../_error.js";
+export function makeApplyFirewallToServerTool(deps) {
+    return {
+        name: "hcloud_apply_firewall_to_server",
+        description: "Apply a firewall (by id or by name) to a server. Hand-tuned wrapper around POST /firewalls/{id}/actions/apply_to_resources.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                firewall_id: { type: "integer", minimum: 1 },
+                firewall_name: { type: "string", minLength: 1 },
+                server_id: { type: "integer", minimum: 1 },
+            },
+            required: ["server_id"],
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+        handler: async (input) => {
+            const serverId = input.server_id;
+            const hasId = typeof input.firewall_id === "number";
+            const hasName = typeof input.firewall_name === "string";
+            if (hasId === hasName) {
+                return { content: [{ type: "text", text: "Provide exactly one of `firewall_id` or `firewall_name`." }], isError: true };
+            }
+            let fwId;
+            if (hasId) {
+                fwId = input.firewall_id;
+            }
+            else {
+                const lookup = await deps.client.request("GET", "/firewalls", { query: { name: input.firewall_name } });
+                const lookupErr = asToolError(lookup);
+                if (lookupErr)
+                    return lookupErr;
+                const found = lookup.body?.firewalls?.[0];
+                if (!found) {
+                    return { content: [{ type: "text", text: `Firewall with name="${input.firewall_name}" not found.` }], isError: true };
+                }
+                fwId = found.id;
+            }
+            const res = await deps.client.request("POST", `/firewalls/${fwId}/actions/apply_to_resources`, { body: { apply_to: [{ type: "server", server: { id: serverId } }] } });
+            const errResult = asToolError(res);
+            if (errResult)
+                return errResult;
+            return { content: [{ type: "text", text: JSON.stringify(res.body ?? {}, null, 2) }] };
+        },
+    };
+}
+//# sourceMappingURL=apply_firewall_to_server.js.map

package/dist/tools/wrappers/apply_firewall_to_server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply_firewall_to_server.js","sourceRoot":"","sources":["../../../src/tools/wrappers/apply_firewall_to_server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C,MAAM,UAAU,6BAA6B,CAAC,IAAuB;IACnE,OAAO;QACL,IAAI,EAAE,iCAAiC;QACvC,WAAW,EACT,6HAA6H;QAC/H,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;gBAC5C,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;gBAC/C,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;aAC3C;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;YACvB,oBAAoB,EAAE,KAAK;SAC5B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QACjF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAuB,EAAE;YAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAmB,CAAC;YAC3C,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC;YACpD,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC;YACxD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0DAA0D,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC1H,CAAC;YACD,IAAI,IAAY,CAAC;YACjB,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,GAAG,KAAK,CAAC,WAAqB,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACtC,KAAK,EACL,YAAY,EACZ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,aAAuB,EAAE,EAAE,CACnD,CAAC;gBACF,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;gBACtC,IAAI,SAAS;oBAAE,OAAO,SAAS,CAAC;gBAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,KAAK,CAAC,aAAa,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACxH,CAAC;gBACD,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;YAClB,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACnC,MAAM,EACN,cAAc,IAAI,6BAA6B,EAC/C,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CACvE,CAAC;YACF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,SAAS;gBAAE,OAAO,SAAS,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACxF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/wrappers/server_backup.js

@@ -0,0 +1,25 @@
+import { runServerAction } from "./_server_action.js";
+export function makeServerBackupTool(deps) {
+    return {
+        name: "hcloud_server_backup",
+        description: "Toggle Hetzner-managed automatic backups on a server. Hand-tuned wrapper around enable_backup / disable_backup actions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer", minimum: 1 },
+                enable: { type: "boolean", description: "true to turn backups on, false to turn them off." },
+                wait: { type: "boolean", default: true },
+            },
+            required: ["id", "enable"],
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+        handler: async (input) => {
+            const id = input.id;
+            const action = input.enable === true ? "enable_backup" : "disable_backup";
+            const wait = input.wait !== false;
+            return runServerAction(deps, id, action, undefined, wait);
+        },
+    };
+}
+//# sourceMappingURL=server_backup.js.map

package/dist/tools/wrappers/server_backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_backup.js","sourceRoot":"","sources":["../../../src/tools/wrappers/server_backup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAyB,MAAM,qBAAqB,CAAC;AAE7E,MAAM,UAAU,oBAAoB,CAAC,IAAsB;IACzD,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,yHAAyH;QAC3H,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;gBACnC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,kDAAkD,EAAE;gBAC5F,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;aACzC;YACD,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC;YAC1B,oBAAoB,EAAE,KAAK;SAC5B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QACjF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAuB,EAAE;YAC5C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAY,CAAC;YAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;YAClC,OAAO,eAAe,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/wrappers/server_change_type.js

@@ -0,0 +1,27 @@
+import { runServerAction } from "./_server_action.js";
+export function makeServerChangeTypeTool(deps) {
+    return {
+        name: "hcloud_server_change_type",
+        description: "Change a server's hardware type. Defaults upgrade_disk to false (disk size kept; safer to downgrade later). Hand-tuned wrapper; polls the resulting action by default.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer", minimum: 1 },
+                server_type: { type: "string", minLength: 1 },
+                upgrade_disk: { type: "boolean", default: false },
+                wait: { type: "boolean", default: true },
+            },
+            required: ["id", "server_type"],
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+        handler: async (input) => {
+            const id = input.id;
+            const server_type = input.server_type;
+            const upgrade_disk = input.upgrade_disk === true;
+            const wait = input.wait !== false;
+            return runServerAction(deps, id, "change_type", { server_type, upgrade_disk }, wait);
+        },
+    };
+}
+//# sourceMappingURL=server_change_type.js.map

package/dist/tools/wrappers/server_change_type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_change_type.js","sourceRoot":"","sources":["../../../src/tools/wrappers/server_change_type.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAyB,MAAM,qBAAqB,CAAC;AAE7E,MAAM,UAAU,wBAAwB,CAAC,IAAsB;IAC7D,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,wKAAwK;QAC1K,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;gBACnC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;gBAC7C,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;gBACjD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;aACzC;YACD,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC;YAC/B,oBAAoB,EAAE,KAAK;SAC5B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QAChF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAuB,EAAE;YAC5C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAY,CAAC;YAC9B,MAAM,WAAW,GAAG,KAAK,CAAC,WAAqB,CAAC;YAChD,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;YACjD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;YAClC,OAAO,eAAe,CAAC,IAAI,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,IAAI,CAAC,CAAC;QACvF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/wrappers/server_get.js

@@ -0,0 +1,53 @@
+import { asToolError } from "../_error.js";
+function errorResult(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}
+export function makeServerGetTool(client) {
+    return {
+        name: "hcloud_get_server",
+        description: "Fetch a single Hetzner Cloud server by numeric id OR by exact name. Hand-tuned wrapper; use hcloud_get_server_raw for the id-only generated tool.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer", minimum: 1 },
+                name: { type: "string", minLength: 1 },
+            },
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
+        handler: async (input) => {
+            const hasId = typeof input.id === "number";
+            const hasName = typeof input.name === "string";
+            if (hasId === hasName) {
+                return errorResult("Provide exactly one of `id` or `name`.");
+            }
+            if (hasId) {
+                const res = await client.request("GET", `/servers/${input.id}`);
+                const errResult = asToolError(res);
+                if (errResult)
+                    return errResult;
+                if (!res.body?.server) {
+                    return errorResult(`Server with id=${input.id} not found.`);
+                }
+                return {
+                    content: [{ type: "text", text: JSON.stringify(res.body, null, 2) }],
+                };
+            }
+            const res = await client.request("GET", "/servers", { query: { name: input.name } });
+            const errResult = asToolError(res);
+            if (errResult)
+                return errResult;
+            const found = res.body?.servers?.[0];
+            if (!found) {
+                return errorResult(`Server with name="${input.name}" not found.`);
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify({ server: found }, null, 2) }],
+            };
+        },
+    };
+}
+//# sourceMappingURL=server_get.js.map

package/dist/tools/wrappers/server_get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_get.js","sourceRoot":"","sources":["../../../src/tools/wrappers/server_get.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI3C,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,mJAAmJ;QACrJ,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;gBACnC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;aACvC;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QAChF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC;YAC3C,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;YAC/C,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtB,OAAO,WAAW,CAAC,wCAAwC,CAAC,CAAC;YAC/D,CAAC;YAED,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAC9B,KAAK,EACL,YAAY,KAAK,CAAC,EAAE,EAAE,CACvB,CAAC;gBACF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;gBACnC,IAAI,SAAS;oBAAE,OAAO,SAAS,CAAC;gBAChC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;oBACtB,OAAO,WAAW,CAAC,kBAAkB,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC;gBAC9D,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;iBACrE,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAC9B,KAAK,EACL,UAAU,EACV,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAc,EAAE,EAAE,CAC1C,CAAC;YACF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,SAAS;gBAAE,OAAO,SAAS,CAAC;YAChC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,WAAW,CAAC,qBAAqB,KAAK,CAAC,IAAI,cAAc,CAAC,CAAC;YACpE,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC9E,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/wrappers/server_list.js

@@ -0,0 +1,69 @@
+import { fetchAllPages } from "../../http/pagination.js";
+export function makeServerListTool(client, limits) {
+    return {
+        name: "hcloud_list_servers",
+        description: "List Hetzner Cloud servers. Hand-tuned wrapper around GET /servers with an optional client-side name_contains filter and a default sort of 'name'. Use hcloud_list_servers_raw for the unfiltered, generator-built tool.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name_contains: {
+                    type: "string",
+                    description: "Case-insensitive substring filter applied after fetching.",
+                },
+                label_selector: {
+                    type: "string",
+                    description: "Hetzner label selector, forwarded as query parameter.",
+                },
+                sort: {
+                    type: "string",
+                    enum: [
+                        "id", "id:asc", "id:desc",
+                        "name", "name:asc", "name:desc",
+                        "created", "created:asc", "created:desc",
+                    ],
+                    default: "name",
+                },
+                page: { type: "integer", minimum: 1 },
+                per_page: { type: "integer", minimum: 1, maximum: 50 },
+            },
+            additionalProperties: false,
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+        handler: async (input) => {
+            const query = {
+                sort: typeof input.sort === "string" ? input.sort : "name",
+            };
+            if (typeof input.label_selector === "string") {
+                query.label_selector = input.label_selector;
+            }
+            if (typeof input.page === "number")
+                query.page = input.page;
+            if (typeof input.per_page === "number")
+                query.per_page = input.per_page;
+            const request = client.request.bind(client);
+            const page = await fetchAllPages(request, "GET", "/servers", query, { resourceKey: "servers", maxItems: limits.maxItems, maxPages: limits.maxPages });
+            let servers = page.items;
+            if (typeof input.name_contains === "string" && input.name_contains.length > 0) {
+                const needle = input.name_contains.toLowerCase();
+                servers = servers.filter((s) => s.name.toLowerCase().includes(needle));
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            servers,
+                            truncated: page.truncated,
+                            pagination: page.pagination ?? null,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+    };
+}
+//# sourceMappingURL=server_list.js.map

package/dist/tools/wrappers/server_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server_list.js","sourceRoot":"","sources":["../../../src/tools/wrappers/server_list.ts"],"names":[],"mappings":"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"}