@octopusdeploy/mcp-server 1.0.1 → 2.1.0

package/dist/tools/runRunbook.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerRunRunbookTool(server: McpServer): void;
+//# sourceMappingURL=runRunbook.d.ts.map

package/dist/tools/runRunbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runRunbook.d.ts","sourceRoot":"","sources":["../../src/tools/runRunbook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA+MvD"}

package/dist/tools/runRunbook.js

@@ -0,0 +1,174 @@
+import { Client, RunbookRunRepository } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
+import { handleOctopusApiError } from "../helpers/errorHandling.js";
+import { requireConfirmation, unconfirmedResponse, } from "../helpers/requireConfirmation.js";
+export function registerRunRunbookTool(server) {
+    server.registerTool("run_runbook", {
+        title: "Run a runbook in Octopus Deploy",
+        description: `Run a runbook against one or more environments in Octopus Deploy
+
+Runbooks execute operational processes (DB backups, smoke tests, environment refresh, etc.) against the specified environments. By default the published snapshot is used; pass runbookSnapshotId to run a specific snapshot. For tenanted runs, supply tenants and/or tenantTags.`,
+        inputSchema: {
+            spaceName: z.string().describe("The space name"),
+            projectName: z.string().describe("The project name"),
+            runbookName: z
+                .string()
+                .describe("The runbook name (within the project)"),
+            environmentNames: z
+                .array(z.string())
+                .min(1)
+                .describe("Array of environment names. At least one environment must be provided."),
+            tenants: z
+                .array(z.string())
+                .optional()
+                .describe("Array of tenant names for tenanted runs (optional)"),
+            tenantTags: z
+                .array(z.string())
+                .optional()
+                .describe("Array of tenant tags for tenanted runs (e.g., ['Region/US-West', 'Tier/Production'])"),
+            runbookSnapshotId: z
+                .string()
+                .optional()
+                .describe("Specific snapshot ID. Defaults to the runbook's published snapshot if omitted."),
+            promptedVariableValues: z
+                .record(z.string())
+                .optional()
+                .describe("Prompted variable values as key-value pairs"),
+            useGuidedFailure: z
+                .boolean()
+                .optional()
+                .describe("Use guided failure mode"),
+            forcePackageDownload: z
+                .boolean()
+                .optional()
+                .describe("Force package download"),
+            specificMachineNames: z
+                .array(z.string())
+                .optional()
+                .describe("Run on specific machines only"),
+            excludedMachineNames: z
+                .array(z.string())
+                .optional()
+                .describe("Exclude specific machines from the run"),
+            skipStepNames: z
+                .array(z.string())
+                .optional()
+                .describe("Skip specific runbook steps"),
+            runAt: z
+                .string()
+                .optional()
+                .describe("Schedule run for later (ISO 8601 date string)"),
+            noRunAfter: z
+                .string()
+                .optional()
+                .describe("Don't run after this time (ISO 8601 date string)"),
+            confirm: z
+                .boolean()
+                .optional()
+                .describe("Required only when the MCP client does not support elicitation. Set to true to confirm the run; otherwise the tool aborts."),
+        },
+        annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
+    }, async ({ spaceName, projectName, runbookName, environmentNames, tenants, tenantTags, runbookSnapshotId, promptedVariableValues, useGuidedFailure, forcePackageDownload, specificMachineNames, excludedMachineNames, skipStepNames, runAt, noRunAfter, confirm, }) => {
+        try {
+            const isTenanted = (tenants && tenants.length > 0) ||
+                (tenantTags && tenantTags.length > 0);
+            const tenantSummary = isTenanted
+                ? ` for tenants [${(tenants ?? []).join(", ")}${tenantTags?.length ? `; tags: ${tenantTags.join(", ")}` : ""}]`
+                : "";
+            const confirmMessage = `Run runbook ${runbookName} of ${projectName} in ` +
+                `[${environmentNames.join(", ")}]${tenantSummary} in space ${spaceName}?`;
+            const command = {
+                spaceName: spaceName,
+                ProjectName: projectName,
+                RunbookName: runbookName,
+                EnvironmentNames: environmentNames,
+                ...(tenants && { Tenants: tenants }),
+                ...(tenantTags && { TenantTags: tenantTags }),
+                ...(runbookSnapshotId && { Snapshot: runbookSnapshotId }),
+                ...(promptedVariableValues && { Variables: promptedVariableValues }),
+                ...(useGuidedFailure !== undefined && {
+                    UseGuidedFailure: useGuidedFailure,
+                }),
+                ...(forcePackageDownload !== undefined && {
+                    ForcePackageDownload: forcePackageDownload,
+                }),
+                ...(specificMachineNames && {
+                    SpecificMachineNames: specificMachineNames,
+                }),
+                ...(excludedMachineNames && {
+                    ExcludedMachineNames: excludedMachineNames,
+                }),
+                ...(skipStepNames && { SkipStepNames: skipStepNames }),
+                ...(runAt && { RunAt: new Date(runAt) }),
+                ...(noRunAfter && { NoRunAfter: new Date(noRunAfter) }),
+            };
+            const confirmation = await requireConfirmation(server, {
+                message: confirmMessage,
+                fallbackConfirm: confirm,
+                change: { source: {}, target: command },
+            });
+            if (!confirmation.confirmed) {
+                return unconfirmedResponse(confirmation, { action: "runbook run" });
+            }
+            const configuration = getClientConfigurationFromEnvironment();
+            const client = await Client.create(configuration);
+            const runbookRunRepository = new RunbookRunRepository(client, spaceName);
+            const response = await runbookRunRepository.create(command);
+            const tasks = response.RunbookRunServerTasks || [];
+            const encodedSpace = encodeURIComponent(spaceName);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            runsCreated: tasks.length,
+                            runbookRunTasks: tasks.map((task) => ({
+                                taskId: task.ServerTaskId,
+                                runbookRunId: task.RunbookRunId,
+                                resourceUri: `octopus://spaces/${encodedSpace}/tasks/${encodeURIComponent(task.ServerTaskId)}`,
+                            })),
+                            message: `Successfully started ${tasks.length} runbook run(s) for ${runbookName}`,
+                            helpText: `Fetch octopus://spaces/{spaceName}/tasks/{taskId} (or /details for the structured activity tree) via resources/read or read_resource to monitor run progress. To search the raw log for a specific error or step, call grep_task_log with the taskId.`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && !error.message.includes("octopus")) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: error.message,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            handleOctopusApiError(error, {
+                entityType: "runbook run",
+                spaceName,
+                helpText: "Use list_projects to find valid project names, list_environments for environment names, find_tenants for tenant information. Ensure the runbook has a published snapshot (or pass an explicit runbookSnapshotId) and you have permissions to run it.",
+            });
+        }
+    });
+}
+registerToolDefinition({
+    toolName: "run_runbook",
+    config: { toolset: "runbooks", readOnly: false },
+    registerFn: registerRunRunbookTool,
+    // The api-client's RunbookRunRepository.create throws at runtime if the
+    // server is older than 2022.3.5512 (the Executions API minimum). Surface
+    // that here so --list-tools-by-version reports it accurately.
+    minimumOctopusVersion: "2022.3.5512",
+});
+//# sourceMappingURL=runRunbook.js.map

package/dist/tools/runRunbook.js.map

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

package/dist/tools/updateFeatureToggle.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const updateFeatureToggleSchema: z.ZodEffects<z.ZodObject<{
+    spaceName: z.ZodString;
+    projectId: z.ZodString;
+    slug: z.ZodString;
+    defaultIsEnabled: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    environments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        deploymentEnvironmentId: z.ZodString;
+        isEnabled: z.ZodOptional<z.ZodBoolean>;
+        rolloutPercentage: z.ZodOptional<z.ZodNumber>;
+        clientRolloutPercentage: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }, {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }>, "many">>;
+    confirm: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    spaceName: string;
+    projectId: string;
+    slug: string;
+    description?: string | undefined;
+    environments?: {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }[] | undefined;
+    defaultIsEnabled?: boolean | undefined;
+    confirm?: boolean | undefined;
+}, {
+    spaceName: string;
+    projectId: string;
+    slug: string;
+    description?: string | undefined;
+    environments?: {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }[] | undefined;
+    defaultIsEnabled?: boolean | undefined;
+    confirm?: boolean | undefined;
+}>, {
+    spaceName: string;
+    projectId: string;
+    slug: string;
+    description?: string | undefined;
+    environments?: {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }[] | undefined;
+    defaultIsEnabled?: boolean | undefined;
+    confirm?: boolean | undefined;
+}, {
+    spaceName: string;
+    projectId: string;
+    slug: string;
+    description?: string | undefined;
+    environments?: {
+        deploymentEnvironmentId: string;
+        isEnabled?: boolean | undefined;
+        rolloutPercentage?: number | undefined;
+        clientRolloutPercentage?: number | undefined;
+    }[] | undefined;
+    defaultIsEnabled?: boolean | undefined;
+    confirm?: boolean | undefined;
+}>;
+export type UpdateFeatureToggleParams = z.infer<typeof updateFeatureToggleSchema>;
+export declare function updateFeatureToggleHandler(server: McpServer, params: UpdateFeatureToggleParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export declare function registerUpdateFeatureToggleTool(server: McpServer): void;
+//# sourceMappingURL=updateFeatureToggle.d.ts.map

package/dist/tools/updateFeatureToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateFeatureToggle.d.ts","sourceRoot":"","sources":["../../src/tools/updateFeatureToggle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwCzE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsDlC,CAAC;AAEL,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAoFlF,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,yBAAyB;;;;;;;;;;;;GAkMlC;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,QAiBhE"}

package/dist/tools/updateFeatureToggle.js

@@ -0,0 +1,308 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
+import { handleOctopusApiError } from "../helpers/errorHandling.js";
+import { requireConfirmation, unconfirmedResponse, } from "../helpers/requireConfirmation.js";
+import {} from "../types/featureToggleTypes.js";
+const environmentPatchSchema = z.object({
+    deploymentEnvironmentId: z
+        .string()
+        .describe("Targets the existing per-environment configuration to patch (e.g. Environments-7). Must already be configured on the toggle — this tool does not add new environment configurations."),
+    isEnabled: z
+        .boolean()
+        .optional()
+        .describe("Whether the toggle is on for this environment, before targeting/rollout is applied."),
+    rolloutPercentage: z
+        .number()
+        .int()
+        .min(0)
+        .max(100)
+        .optional()
+        .describe("Server-side rollout percentage [0, 100]."),
+    clientRolloutPercentage: z
+        .number()
+        .int()
+        .min(0)
+        .max(100)
+        .optional()
+        .describe("Client-side fractional rollout evaluated by the SDK [0, 100]."),
+});
+export const updateFeatureToggleSchema = z
+    .object({
+    spaceName: z.string().describe("Space name."),
+    projectId: z
+        .string()
+        .describe("Project ID (e.g. Projects-123). Feature toggles are scoped per project."),
+    slug: z
+        .string()
+        .describe("The toggle's Slug (not its Id). Find it via find_feature_toggles."),
+    defaultIsEnabled: z
+        .boolean()
+        .optional()
+        .describe("Toggle-level default. The value returned for environments that have no explicit per-environment configuration."),
+    description: z
+        .string()
+        .optional()
+        .describe("Toggle-level description (max 1000 chars). Markdown supported in the UI."),
+    environments: z
+        .array(environmentPatchSchema)
+        .optional()
+        .describe("Per-environment patches. Environments not listed here are preserved as-is. Each entry must reference a deploymentEnvironmentId that already exists on the toggle; unknown environments are rejected rather than silently added. Each environment may appear at most once in this array — duplicates are rejected."),
+    confirm: z
+        .boolean()
+        .optional()
+        .describe("Required only when the MCP client does not support elicitation. Set to true to confirm the update; otherwise the tool aborts."),
+})
+    .superRefine((args, ctx) => {
+    // Reject duplicate deploymentEnvironmentIds up front. Without this,
+    // the merge picks the FIRST patch for the env while the confirmation
+    // diff overwrites earlier entries with later ones using the same key —
+    // the user could see one change in the prompt and a different one
+    // actually go through.
+    if (!args.environments)
+        return;
+    const seen = new Map();
+    for (let i = 0; i < args.environments.length; i++) {
+        const id = args.environments[i].deploymentEnvironmentId;
+        const prev = seen.get(id);
+        if (prev !== undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `Duplicate environment entry for '${id}' at index ${i} (also at index ${prev}). ` +
+                    "Combine the patches into a single entry per environment.",
+                path: ["environments", i, "deploymentEnvironmentId"],
+            });
+        }
+        seen.set(id, i);
+    }
+});
+function applyEnvironmentPatch(current, patch) {
+    const merged = { ...current };
+    const changedFields = [];
+    if (patch.isEnabled !== undefined && patch.isEnabled !== current.IsEnabled) {
+        merged.IsEnabled = patch.isEnabled;
+        changedFields.push("IsEnabled");
+    }
+    if (patch.rolloutPercentage !== undefined &&
+        patch.rolloutPercentage !== current.RolloutPercentage) {
+        merged.RolloutPercentage = patch.rolloutPercentage;
+        changedFields.push("RolloutPercentage");
+    }
+    if (patch.clientRolloutPercentage !== undefined &&
+        patch.clientRolloutPercentage !== current.ClientRolloutPercentage) {
+        merged.ClientRolloutPercentage = patch.clientRolloutPercentage;
+        changedFields.push("ClientRolloutPercentage");
+    }
+    return { current, merged, changedFields };
+}
+function buildDiffSource(toggle, params, envPatches) {
+    const source = {};
+    if (params.defaultIsEnabled !== undefined) {
+        source.DefaultIsEnabled = toggle.DefaultIsEnabled;
+    }
+    if (params.description !== undefined) {
+        source.Description = toggle.Description ?? null;
+    }
+    for (const patch of envPatches) {
+        if (patch.changedFields.length === 0)
+            continue;
+        const sourceFields = {};
+        for (const field of patch.changedFields) {
+            sourceFields[field] =
+                patch.current[field];
+        }
+        source[`Environments[${patch.current.DeploymentEnvironmentId}]`] = sourceFields;
+    }
+    return source;
+}
+function buildDiffTarget(params, envPatches) {
+    const target = {};
+    if (params.defaultIsEnabled !== undefined) {
+        target.DefaultIsEnabled = params.defaultIsEnabled;
+    }
+    if (params.description !== undefined) {
+        target.Description = params.description;
+    }
+    for (const patch of envPatches) {
+        if (patch.changedFields.length === 0)
+            continue;
+        const targetFields = {};
+        for (const field of patch.changedFields) {
+            targetFields[field] =
+                patch.merged[field];
+        }
+        target[`Environments[${patch.current.DeploymentEnvironmentId}]`] = targetFields;
+    }
+    return target;
+}
+export async function updateFeatureToggleHandler(server, params) {
+    const { spaceName, projectId, slug, environments, confirm } = params;
+    const noPatches = params.defaultIsEnabled === undefined &&
+        params.description === undefined &&
+        (!environments || environments.length === 0);
+    if (noPatches) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: false,
+                        reason: "no_patches",
+                        message: "No fields supplied to update. Pass at least one of defaultIsEnabled, description, or environments[].",
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const client = await Client.create(getClientConfigurationFromEnvironment());
+    let spaceId;
+    try {
+        spaceId = await resolveSpaceId(client, spaceName);
+    }
+    catch (error) {
+        handleOctopusApiError(error, { spaceName });
+    }
+    let current;
+    try {
+        current = await client.get("~/api/{spaceId}/projects/{projectId}/featuretoggles/{slug}", { spaceId, projectId, slug });
+    }
+    catch (error) {
+        handleOctopusApiError(error, {
+            entityType: "feature toggle",
+            entityId: slug,
+            spaceName,
+            helpText: "Use find_feature_toggles to list valid slugs. If 404 persists across all toggles in the project, the customer feature toggles capability may be disabled on the Octopus instance.",
+        });
+    }
+    // Match patch entries to existing environment configurations. Unknown
+    // environments are rejected — the contract is "slight adjustment", not
+    // "configure new environments".
+    const envPatches = [];
+    if (environments) {
+        for (const patch of environments) {
+            const existing = current.Environments.find((e) => e.DeploymentEnvironmentId === patch.deploymentEnvironmentId);
+            if (!existing) {
+                const configured = current.Environments.map((e) => e.DeploymentEnvironmentId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                reason: "environment_not_configured",
+                                message: `Environment '${patch.deploymentEnvironmentId}' is not configured on toggle '${current.Slug}'. ` +
+                                    "This tool only adjusts existing environment configurations; it does not add new ones. " +
+                                    "Use the Octopus UI to add an environment to a toggle.",
+                                configuredEnvironmentIds: configured,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            envPatches.push(applyEnvironmentPatch(existing, patch));
+        }
+    }
+    // Detect a no-op call (everything provided already matches current state)
+    // before involving the user with a confirmation dialog.
+    const toggleLevelChanges = (params.defaultIsEnabled !== undefined &&
+        params.defaultIsEnabled !== current.DefaultIsEnabled) ||
+        (params.description !== undefined &&
+            params.description !== (current.Description ?? undefined));
+    const envLevelChanges = envPatches.some((p) => p.changedFields.length > 0);
+    if (!toggleLevelChanges && !envLevelChanges) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        noOp: true,
+                        message: "All supplied fields already match the current toggle state — nothing to update.",
+                        slug: current.Slug,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    const merged = {
+        ...current,
+        DefaultIsEnabled: params.defaultIsEnabled !== undefined
+            ? params.defaultIsEnabled
+            : current.DefaultIsEnabled,
+        Description: params.description !== undefined ? params.description : current.Description,
+        Environments: current.Environments.map((env) => {
+            const patch = envPatches.find((p) => p.current.DeploymentEnvironmentId === env.DeploymentEnvironmentId);
+            return patch ? patch.merged : env;
+        }),
+    };
+    const confirmation = await requireConfirmation(server, {
+        message: `Update feature toggle "${current.Name}" (${current.Slug}) in space ${spaceName}?`,
+        fallbackConfirm: confirm,
+        change: {
+            source: buildDiffSource(current, params, envPatches),
+            target: buildDiffTarget(params, envPatches),
+        },
+    });
+    if (!confirmation.confirmed) {
+        return unconfirmedResponse(confirmation, {
+            action: "feature toggle update",
+        });
+    }
+    try {
+        await client.doUpdate("~/api/{spaceId}/projects/{projectId}/featuretoggles", merged, { spaceId, projectId });
+    }
+    catch (error) {
+        handleOctopusApiError(error, {
+            entityType: "feature toggle",
+            entityId: current.Id,
+            spaceName,
+            helpText: "Verify you have FeatureToggleEdit on the project and every environment referenced. Server-side validation rules (max segments, ephemeral environment clamping, etc.) are documented in the Octopus feature toggles API reference.",
+        });
+    }
+    const encodedSpace = encodeURIComponent(spaceName);
+    const encodedProjectId = encodeURIComponent(projectId);
+    const encodedSlug = encodeURIComponent(current.Slug);
+    const resourceUri = `octopus://spaces/${encodedSpace}/projects/${encodedProjectId}/featuretoggles/${encodedSlug}`;
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    success: true,
+                    id: current.Id,
+                    slug: current.Slug,
+                    name: current.Name,
+                    resourceUri,
+                    message: `Feature toggle '${current.Slug}' updated successfully.`,
+                    helpText: "Dereference resourceUri to read the updated toggle body.",
+                }, null, 2),
+            },
+        ],
+    };
+}
+export function registerUpdateFeatureToggleTool(server) {
+    server.registerTool("update_feature_toggle", {
+        title: "Update a feature toggle",
+        description: `Adjust an existing customer feature toggle in an Octopus Deploy project.
+
+Narrow surface — flip an environment on/off, change rollout percentages, or update the toggle-level description / default state. Internally fetches the current toggle, applies your patches in memory, and PUTs the merged body, so unmentioned environments and unmentioned fields are preserved.
+
+Deliberately not exposed: name/slug rename, tag changes, rollout group attach/detach, tenant targeting, segments, minimum version, adding or removing environment configurations entirely. For those, use the Octopus UI.
+
+Patches that reference an environment not already configured on the toggle are rejected with reason: environment_not_configured. The tool does not add new environment configurations.`,
+        inputSchema: updateFeatureToggleSchema,
+        annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
+    }, (args) => updateFeatureToggleHandler(server, args));
+}
+registerToolDefinition({
+    toolName: "update_feature_toggle",
+    config: { toolset: "featureToggles", readOnly: false },
+    registerFn: registerUpdateFeatureToggleTool,
+    minimumOctopusVersion: "2026.1.10655",
+});
+//# sourceMappingURL=updateFeatureToggle.js.map

package/dist/tools/updateFeatureToggle.js.map

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

package/dist/types/featureToggleTypes.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Wire-format types for the customer-facing Feature Toggles API.
+ *
+ * Octopus's @octopusdeploy/api-client (3.8.0) does not expose typed Repository
+ * classes or Resource interfaces for feature toggles, so we declare the minimum
+ * surface we touch here. Field names and casing match the JSON response from
+ * /api/{spaceId}/projects/{projectId}/featuretoggles{,/{slug}}.
+ */
+export interface FeatureToggleEnvironmentResource {
+    FeatureToggleId?: string;
+    DeploymentEnvironmentId: string;
+    IsEnabled: boolean;
+    RolloutPercentage?: number;
+    ClientRolloutPercentage?: number;
+    TenantIds?: string[];
+    ExcludedTenantIds?: string[];
+    TenantTags?: string[];
+    ExcludedTenantTags?: string[];
+    Segments?: Array<{
+        Key: string;
+        Value: string;
+    }>;
+    MinimumVersion?: string | null;
+}
+export interface FeatureToggleResource {
+    Id: string;
+    SpaceId: string;
+    ProjectId: string;
+    Name: string;
+    Slug: string;
+    DefaultIsEnabled: boolean;
+    Description?: string | null;
+    Environments: FeatureToggleEnvironmentResource[];
+    Tags: string[];
+    RolloutGroupId?: string | null;
+}
+export interface RolloutGroupResource {
+    Id: string;
+    SpaceId: string;
+    ProjectId: string;
+    Name: string;
+    FeatureToggleUsages: Array<{
+        Id: string;
+        Name: string;
+    }>;
+}
+//# sourceMappingURL=featureToggleTypes.d.ts.map