@octopusdeploy/mcp-server 1.0.1 → 2.1.0

package/dist/resources/interruption.js

@@ -0,0 +1,34 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+import { stripLinks } from "../helpers/stripLinks.js";
+registerResourceDescriptor({
+    name: "interruption",
+    uriTemplate: "octopus://spaces/{spaceName}/interruptions/{interruptionId}",
+    toolset: "interruptions",
+    title: "Octopus interruption",
+    description: "Full interruption body for a given interruption ID in a space. Includes Form.Elements (the form definition with control types, labels, button options, and Paragraph instructions in Markdown) and Form.Values (any already-submitted values), plus RelatedDocumentIds, ResponsibleTeamIds, ResponsibleUserId, and the responsibility flags. Use this when the find_interruptions slim summary is not enough — for example, when the user wants to see the intervention's instructions or the set of choices on the SubmitButtonGroup.",
+    mimeType: "application/json",
+    read: async ({ spaceName, interruptionId }) => {
+        validateEntityId(interruptionId, "interruption", ENTITY_PREFIXES.interruption);
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const spaceId = await resolveSpaceId(client, spaceName);
+            const interruption = await client.get("~/api/{spaceId}/interruptions/{interruptionId}", { spaceId, interruptionId });
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(interruption)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "interruption",
+                entityId: interruptionId,
+                spaceName,
+                helpText: "Use find_interruptions to find valid interruption IDs.",
+            });
+        }
+    },
+});
+//# sourceMappingURL=interruption.js.map

package/dist/resources/interruption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interruption.js","sourceRoot":"","sources":["../../src/resources/interruption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,0BAA0B,CAAC;IACzB,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,6DAA6D;IAC1E,OAAO,EAAE,eAAe;IACxB,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACT,wgBAAwgB;IAC1gB,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE;QAC5C,gBAAgB,CAAC,cAAc,EAAE,cAAc,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,GAAG,CACnC,gDAAgD,EAChD,EAAE,OAAO,EAAE,cAAc,EAAE,CAC5B,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;aAC/C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,cAAc;gBAC1B,QAAQ,EAAE,cAAc;gBACxB,SAAS;gBACT,QAAQ,EAAE,wDAAwD;aACnE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/resources/release.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=release.d.ts.map

package/dist/resources/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/resources/release.ts"],"names":[],"mappings":""}

package/dist/resources/release.js

@@ -0,0 +1,33 @@
+import { Client, ReleaseRepository } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+import { stripLinks } from "../helpers/stripLinks.js";
+registerResourceDescriptor({
+    name: "release",
+    uriTemplate: "octopus://spaces/{spaceName}/releases/{releaseId}",
+    toolset: "releases",
+    title: "Octopus release",
+    description: "Full release object for a given release ID in a space. Body shape mirrors the find_releases tool output for a single release.",
+    mimeType: "application/json",
+    read: async ({ spaceName, releaseId }) => {
+        validateEntityId(releaseId, "release", ENTITY_PREFIXES.release);
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const release = await new ReleaseRepository(client, spaceName).get(releaseId);
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(release)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "release",
+                entityId: releaseId,
+                spaceName,
+                helpText: "Use find_releases to find valid release IDs.",
+            });
+        }
+    },
+});
+//# sourceMappingURL=release.js.map

package/dist/resources/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../src/resources/release.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,0BAA0B,CAAC;IACzB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,mDAAmD;IAChE,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,+HAA+H;IACjI,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE;QACvC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;QAEhE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,IAAI,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAAG,CAChE,SAAS,CACV,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;aAC1C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,SAAS;gBACnB,SAAS;gBACT,QAAQ,EACN,8CAA8C;aACjD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/resources/rolloutGroup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rolloutGroup.d.ts.map

package/dist/resources/rolloutGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolloutGroup.d.ts","sourceRoot":"","sources":["../../src/resources/rolloutGroup.ts"],"names":[],"mappings":""}

package/dist/resources/rolloutGroup.js

@@ -0,0 +1,35 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { validateEntityId, handleOctopusApiError, } from "../helpers/errorHandling.js";
+import { stripLinks } from "../helpers/stripLinks.js";
+import {} from "../types/featureToggleTypes.js";
+registerResourceDescriptor({
+    name: "rolloutGroup",
+    uriTemplate: "octopus://spaces/{spaceName}/projects/{projectId}/rolloutgroups/{rolloutGroupId}",
+    toolset: "featureToggles",
+    title: "Octopus feature toggle rollout group",
+    description: "Full rollout group body for a given rollout group ID in a project. Lists the feature toggles bound to the group via FeatureToggleUsages. Read-only — this MCP server does not expose rollout group create/modify/delete; use the Octopus UI for those.",
+    mimeType: "application/json",
+    read: async ({ spaceName, projectId, rolloutGroupId }) => {
+        validateEntityId(rolloutGroupId, "rollout group", "RolloutGroups-");
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const spaceId = await resolveSpaceId(client, spaceName);
+            const group = await client.get("~/api/{spaceId}/projects/{projectId}/featuretoggles/rollout-groups/{rolloutGroupId}", { spaceId, projectId, rolloutGroupId });
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(group)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "rollout group",
+                entityId: rolloutGroupId,
+                spaceName,
+                helpText: "Rollout group IDs surface as RolloutGroupId on toggles returned from find_feature_toggles. They are unique per project.",
+            });
+        }
+    },
+});
+//# sourceMappingURL=rolloutGroup.js.map

package/dist/resources/rolloutGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolloutGroup.js","sourceRoot":"","sources":["../../src/resources/rolloutGroup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAA6B,MAAM,gCAAgC,CAAC;AAE3E,0BAA0B,CAAC;IACzB,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,kFAAkF;IACpF,OAAO,EAAE,gBAAgB;IACzB,KAAK,EAAE,sCAAsC;IAC7C,WAAW,EACT,wPAAwP;IAC1P,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE;QACvD,gBAAgB,CAAC,cAAc,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;QAEpE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,CAC5B,qFAAqF,EACrF,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CACvC,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;aACxC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,eAAe;gBAC3B,QAAQ,EAAE,cAAc;gBACxB,SAAS;gBACT,QAAQ,EACN,yHAAyH;aAC5H,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/resources/runbook.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runbook.d.ts.map

package/dist/resources/runbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runbook.d.ts","sourceRoot":"","sources":["../../src/resources/runbook.ts"],"names":[],"mappings":""}

package/dist/resources/runbook.js

@@ -0,0 +1,34 @@
+import { Client, resolveSpaceId, } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+import { stripLinks } from "../helpers/stripLinks.js";
+registerResourceDescriptor({
+    name: "runbook",
+    uriTemplate: "octopus://spaces/{spaceName}/runbooks/{runbookId}",
+    toolset: "runbooks",
+    title: "Octopus runbook",
+    description: "Full runbook object for a given runbook ID in a space. Body shape mirrors the find_runbooks tool output for a single runbook, plus runtime policy fields (ConnectivityPolicy, DefaultGuidedFailureMode, RunRetentionPolicy) that the slim summary omits.",
+    mimeType: "application/json",
+    read: async ({ spaceName, runbookId }) => {
+        validateEntityId(runbookId, "runbook", ENTITY_PREFIXES.runbook);
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const spaceId = await resolveSpaceId(client, spaceName);
+            const runbook = await client.get("~/api/{spaceId}/runbooks/{id}", { spaceId, id: runbookId });
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(runbook)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "runbook",
+                entityId: runbookId,
+                spaceName,
+                helpText: "Use find_runbooks to find valid runbook IDs.",
+            });
+        }
+    },
+});
+//# sourceMappingURL=runbook.js.map

package/dist/resources/runbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runbook.js","sourceRoot":"","sources":["../../src/resources/runbook.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,cAAc,GAEf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,0BAA0B,CAAC;IACzB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,mDAAmD;IAChE,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,0PAA0P;IAC5P,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE;QACvC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;QAEhE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAC9B,+BAA+B,EAC/B,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAC3B,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;aAC1C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,SAAS;gBACnB,SAAS;gBACT,QAAQ,EAAE,8CAA8C;aACzD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/resources/task.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task.d.ts.map

package/dist/resources/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/resources/task.ts"],"names":[],"mappings":""}

package/dist/resources/task.js

@@ -0,0 +1,68 @@
+import { Client, SpaceServerTaskRepository } from "@octopusdeploy/api-client";
+import { registerResourceDescriptor } from "../types/resourceConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+import { stripLinks } from "../helpers/stripLinks.js";
+const TASK_HELP_TEXT = "Use find_releases or list_deployments to find tasks via their parent entity, or get_deployment_from_url / get_task_from_url for URL-based lookups.";
+registerResourceDescriptor({
+    name: "task",
+    uriTemplate: "octopus://spaces/{spaceName}/tasks/{taskId}",
+    toolset: "tasks",
+    title: "Octopus task summary",
+    description: "Lightweight task metadata: state, timing, completion flags, and arguments. Cheap to fetch — use this for polling or status checks. For step timings and embedded log entries use the /details URI; to search the raw activity log call the grep_task_log tool.",
+    mimeType: "application/json",
+    read: async ({ spaceName, taskId }) => {
+        validateEntityId(taskId, "task", ENTITY_PREFIXES.task);
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const task = await new SpaceServerTaskRepository(client, spaceName).getById(taskId);
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(task)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "task",
+                entityId: taskId,
+                spaceName,
+                helpText: TASK_HELP_TEXT,
+            });
+        }
+    },
+});
+registerResourceDescriptor({
+    name: "task-details",
+    uriTemplate: "octopus://spaces/{spaceName}/tasks/{taskId}/details",
+    toolset: "tasks",
+    title: "Octopus task details (structured activity tree)",
+    description: "Full ServerTaskDetails payload: the task summary plus Progress, PhysicalLogSize, and the hierarchical ActivityLogs tree (each step's children, status, and embedded log entries). Heavier than the /task summary — fetch when you need step-by-step timings or programmatic access to log entries.",
+    mimeType: "application/json",
+    read: async ({ spaceName, taskId }) => {
+        validateEntityId(taskId, "task", ENTITY_PREFIXES.task);
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const details = await new SpaceServerTaskRepository(client, spaceName).getDetails(taskId);
+            return {
+                mimeType: "application/json",
+                text: JSON.stringify(stripLinks(details)),
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "task",
+                entityId: taskId,
+                spaceName,
+                helpText: TASK_HELP_TEXT,
+            });
+        }
+    },
+});
+// NOTE: There is intentionally no `octopus://spaces/{spaceName}/tasks/{taskId}/log`
+// resource. Activity logs can be multi-megabyte; exposing them as an addressable
+// resource invites agents to fetch the whole body when they only need a few
+// matching lines. Use the `grep_task_log` tool instead — its parameters mirror
+// GNU grep and it returns only matching slices with totalMatches/context.
+// For structured log entries with categories and timestamps, use the /details
+// URI above (it embeds ActivityLogs[] inline).
+//# sourceMappingURL=task.js.map

package/dist/resources/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/resources/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,MAAM,cAAc,GAClB,oJAAoJ,CAAC;AAEvJ,0BAA0B,CAAC;IACzB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,6CAA6C;IAC1D,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACT,gQAAgQ;IAClQ,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;QACpC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QAEvD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,yBAAyB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,OAAO,CACzE,MAAM,CACP,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;aACvC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,MAAM;gBAClB,QAAQ,EAAE,MAAM;gBAChB,SAAS;gBACT,QAAQ,EAAE,cAAc;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,0BAA0B,CAAC;IACzB,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,qDAAqD;IAClE,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,iDAAiD;IACxD,WAAW,EACT,oSAAoS;IACtS,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;QACpC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QAEvD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,qCAAqC,EAAE,CACxC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,IAAI,yBAAyB,CACjD,MAAM,EACN,SAAS,CACV,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAErB,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;aAC1C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,MAAM;gBAClB,QAAQ,EAAE,MAAM;gBAChB,SAAS;gBACT,QAAQ,EAAE,cAAc;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,oFAAoF;AACpF,iFAAiF;AACjF,4EAA4E;AAC5E,+EAA+E;AAC/E,0EAA0E;AAC1E,8EAA8E;AAC9E,+CAA+C"}

package/dist/tools/createRelease.d.ts

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

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

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

package/dist/tools/createRelease.js

@@ -0,0 +1,151 @@
+import { Client, ReleaseRepository } 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 { ADDITIVE_WRITE_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
+import { handleOctopusApiError } from "../helpers/errorHandling.js";
+import { requireConfirmation, unconfirmedResponse, } from "../helpers/requireConfirmation.js";
+export function registerCreateReleaseTool(server) {
+    server.registerTool("create_release", {
+        title: "Create a new release in Octopus Deploy",
+        description: `Create a new release for an Octopus Deploy project
+
+This tool creates a new release for a project. The space name and project name are required. All other parameters are optional and will use Octopus defaults if not specified.`,
+        inputSchema: {
+            spaceName: z.string().describe("The space name"),
+            projectName: z.string().describe("The project name"),
+            releaseVersion: z
+                .string()
+                .optional()
+                .describe("The version for the release (e.g., '1.0.0'). If not specified, Octopus will auto-generate based on project settings."),
+            channelName: z
+                .string()
+                .optional()
+                .describe("The channel name (uses default channel if not specified)"),
+            packageVersion: z
+                .string()
+                .optional()
+                .describe("Default package version to use for all packages"),
+            packages: z
+                .array(z.string())
+                .optional()
+                .describe("Array of package specifications (format depends on Octopus configuration)"),
+            gitCommit: z.string().optional().describe("Git commit hash"),
+            gitRef: z.string().optional().describe("Git reference (branch or tag)"),
+            releaseNotes: z
+                .string()
+                .optional()
+                .describe("Release notes for this release"),
+            ignoreIfAlreadyExists: z
+                .boolean()
+                .optional()
+                .describe("If true, skip creation if release already exists (returns existing release)"),
+            ignoreChannelRules: z
+                .boolean()
+                .optional()
+                .describe("If true, ignore channel version rules"),
+            packagePrerelease: z
+                .string()
+                .optional()
+                .describe("Package prerelease tag"),
+            customFields: z
+                .record(z.string())
+                .optional()
+                .describe("Custom field values as key-value pairs"),
+            confirm: z
+                .boolean()
+                .optional()
+                .describe("Required only when the MCP client does not support elicitation. Set to true to confirm release creation; otherwise the tool aborts."),
+        },
+        annotations: ADDITIVE_WRITE_TOOL_ANNOTATIONS,
+    }, async ({ spaceName, projectName, releaseVersion, channelName, packageVersion, packages, gitCommit, gitRef, releaseNotes, ignoreIfAlreadyExists, ignoreChannelRules, packagePrerelease, customFields, confirm, }) => {
+        try {
+            const summary = [
+                `Create release for project ${projectName}`,
+                releaseVersion ? `version ${releaseVersion}` : null,
+                channelName ? `on channel ${channelName}` : null,
+                gitRef ? `from ${gitRef}` : null,
+                `in space ${spaceName}`,
+            ]
+                .filter(Boolean)
+                .join(" ");
+            const command = {
+                spaceName: spaceName,
+                ProjectName: projectName,
+                ...(releaseVersion && { ReleaseVersion: releaseVersion }),
+                ...(channelName && { ChannelName: channelName }),
+                ...(packageVersion && { PackageVersion: packageVersion }),
+                ...(packages && { Packages: packages }),
+                ...(gitCommit && { GitCommit: gitCommit }),
+                ...(gitRef && { GitRef: gitRef }),
+                ...(releaseNotes && { ReleaseNotes: releaseNotes }),
+                ...(ignoreIfAlreadyExists !== undefined && {
+                    IgnoreIfAlreadyExists: ignoreIfAlreadyExists,
+                }),
+                ...(ignoreChannelRules !== undefined && {
+                    IgnoreChannelRules: ignoreChannelRules,
+                }),
+                ...(packagePrerelease && { PackagePrerelease: packagePrerelease }),
+                ...(customFields && { CustomFields: customFields }),
+            };
+            const confirmation = await requireConfirmation(server, {
+                message: `${summary}?`,
+                fallbackConfirm: confirm,
+                change: { source: {}, target: command },
+            });
+            if (!confirmation.confirmed) {
+                return unconfirmedResponse(confirmation, {
+                    action: "release creation",
+                });
+            }
+            const configuration = getClientConfigurationFromEnvironment();
+            const client = await Client.create(configuration);
+            const releaseRepository = new ReleaseRepository(client, spaceName);
+            const response = await releaseRepository.create(command);
+            let versionControlReference;
+            try {
+                const release = await releaseRepository.get(response.ReleaseId);
+                versionControlReference = release.VersionControlReference;
+            }
+            catch {
+                versionControlReference = undefined;
+            }
+            const encodedSpace = encodeURIComponent(spaceName);
+            const encodedId = encodeURIComponent(response.ReleaseId);
+            const resourceUri = `octopus://spaces/${encodedSpace}/releases/${encodedId}`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            releaseId: response.ReleaseId,
+                            releaseVersion: response.ReleaseVersion,
+                            versionControlReference,
+                            resourceUri,
+                            message: `Release ${response.ReleaseVersion} created successfully`,
+                            helpText: "Read resourceUri for the full release body (includes releaseNotes). Use deploy_release to deploy this release to environments.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "release",
+                spaceName,
+                helpText: "Use list_projects to find valid project names. Ensure you have permissions to create releases and that the project exists.",
+            });
+        }
+    });
+}
+registerToolDefinition({
+    toolName: "create_release",
+    config: { toolset: "releases", readOnly: false },
+    registerFn: registerCreateReleaseTool,
+    // ReleaseRepository.create uses the Executions API (~/api/{space}/releases/create/v1)
+    // which the api-client refuses to call against servers older than 2022.3.5512.
+    minimumOctopusVersion: "2022.3.5512",
+});
+//# sourceMappingURL=createRelease.js.map

package/dist/tools/createRelease.js.map

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

package/dist/tools/deployRelease.d.ts

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

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

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