@octopusdeploy/mcp-server 1.0.1 → 1.1.0

package/dist/tools/findReleases.js

@@ -0,0 +1,96 @@
+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 { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES } from "../helpers/errorHandling.js";
+export function registerFindReleasesTool(server) {
+    server.tool("find_releases", `Find releases in a space - can retrieve a single release by ID or list all releases
+
+  This unified tool can either:
+  - Get a specific release when releaseId is provided
+  - List all releases in a space when releaseId is omitted
+
+  Optionally provide skip and take parameters for pagination when listing.`, {
+        spaceName: z.string().describe("The space name"),
+        releaseId: z.string().optional().describe("The ID of a specific release to retrieve. If omitted, lists all releases."),
+        skip: z.number().optional().describe("Number of releases to skip for pagination (only used when listing)"),
+        take: z.number().optional().describe("Number of releases to take for pagination (only used when listing)")
+    }, {
+        title: "Find releases in an Octopus Deploy space",
+        readOnlyHint: true,
+    }, async ({ spaceName, releaseId, skip, take }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const releaseRepository = new ReleaseRepository(client, spaceName);
+        // If releaseId is provided, get a single release
+        if (releaseId) {
+            validateEntityId(releaseId, 'release', ENTITY_PREFIXES.release);
+            try {
+                const release = await releaseRepository.get(releaseId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                id: release.Id,
+                                version: release.Version,
+                                channelId: release.ChannelId,
+                                projectId: release.ProjectId,
+                                releaseNotes: release.ReleaseNotes,
+                                assembled: release.Assembled,
+                                ignoreChannelRules: release.IgnoreChannelRules,
+                                selectedPackages: release.SelectedPackages,
+                                selectedGitResources: release.SelectedGitResources,
+                                buildInformation: release.BuildInformation,
+                                customFields: release.CustomFields
+                            }),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                handleOctopusApiError(error, {
+                    entityType: 'release',
+                    entityId: releaseId,
+                    spaceName,
+                    helpText: "Use find_releases without releaseId or list_releases_for_project to find valid release IDs."
+                });
+            }
+        }
+        // Otherwise, list all releases
+        const releasesResponse = await releaseRepository.list({ skip, take });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        totalResults: releasesResponse.TotalResults,
+                        itemsPerPage: releasesResponse.ItemsPerPage,
+                        numberOfPages: releasesResponse.NumberOfPages,
+                        lastPageNumber: releasesResponse.LastPageNumber,
+                        items: releasesResponse.Items.map(release => ({
+                            id: release.Id,
+                            version: release.Version,
+                            channelId: release.ChannelId,
+                            projectId: release.ProjectId,
+                            releaseNotes: release.ReleaseNotes,
+                            assembled: release.Assembled,
+                            ignoreChannelRules: release.IgnoreChannelRules,
+                            selectedPackages: release.SelectedPackages,
+                            selectedGitResources: release.SelectedGitResources,
+                            buildInformation: release.BuildInformation,
+                            customFields: release.CustomFields
+                        }))
+                    }),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "find_releases",
+    config: { toolset: "releases", readOnly: true },
+    registerFn: registerFindReleasesTool,
+});
+//# sourceMappingURL=findReleases.js.map

package/dist/tools/findReleases.js.map

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

package/dist/tools/findTenants.d.ts

@@ -0,0 +1,19 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface FindTenantsParams {
+    spaceName: string;
+    tenantId?: string;
+    skip?: number;
+    take?: number;
+    projectId?: string;
+    tags?: string;
+    ids?: string[];
+    partialName?: string;
+}
+export declare function findTenantsHandler(params: FindTenantsParams): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function registerFindTenantsTool(server: McpServer): void;
+//# sourceMappingURL=findTenants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findTenants.d.ts","sourceRoot":"","sources":["../../src/tools/findTenants.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB;;;;;GAgGjE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAwCxD"}

package/dist/tools/findTenants.js

@@ -0,0 +1,130 @@
+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 { getPublicUrl } from "../helpers/getPublicUrl.js";
+import { tenantsDescription } from "../types/tenantsTypes.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+export async function findTenantsHandler(params) {
+    const { spaceName, tenantId, skip, take, projectId, tags, ids, partialName } = params;
+    const configuration = getClientConfigurationFromEnvironment();
+    const client = await Client.create(configuration);
+    const spaceId = await resolveSpaceId(client, spaceName);
+    // If tenantId is provided, get a single tenant
+    if (tenantId) {
+        validateEntityId(tenantId, "tenant", ENTITY_PREFIXES.tenant);
+        try {
+            const tenant = await client.get("~/api/{spaceId}/tenant/{tenantId}", { spaceId, tenantId });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            id: tenant.Id,
+                            name: tenant.Name,
+                            slug: tenant.Slug,
+                            description: tenant.Description,
+                            isDisabled: tenant.IsDisabled,
+                            projectEnvironments: tenant.ProjectEnvironments,
+                            tenantTags: tenant.TenantTags,
+                            clonedFromTenantId: tenant.ClonedFromTenantId,
+                            spaceId: tenant.SpaceId,
+                            publicUrl: getPublicUrl(`${configuration.instanceURL}/app#/{spaceId}/tenants/{tenantId}/overview`, {
+                                spaceId: tenant.SpaceId,
+                                tenantId: tenant.Id,
+                            }),
+                            publicUrlInstruction: `You can view more details about this tenant in the Octopus Deploy web portal at the provided publicUrl.`,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "tenant",
+                entityId: tenantId,
+                spaceName,
+            });
+        }
+    }
+    // Otherwise, list tenants
+    const tenantsResponse = await client.get("~/api/{spaceId}/tenants{?skip,take,projectId,tags,ids,partialName}", {
+        spaceId,
+        skip,
+        take,
+        projectId,
+        tags,
+        ids,
+        partialName,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    totalResults: tenantsResponse.TotalResults,
+                    itemsPerPage: tenantsResponse.ItemsPerPage,
+                    numberOfPages: tenantsResponse.NumberOfPages,
+                    lastPageNumber: tenantsResponse.LastPageNumber,
+                    items: tenantsResponse.Items.map((tenant) => ({
+                        id: tenant.Id,
+                        name: tenant.Name,
+                        slug: tenant.Slug,
+                        description: tenant.Description,
+                        isDisabled: tenant.IsDisabled ?? false,
+                        tenantTags: tenant.TenantTags,
+                        clonedFromTenantId: tenant.ClonedFromTenantId,
+                        spaceId: tenant.SpaceId,
+                        publicUrl: getPublicUrl(`${configuration.instanceURL}/app#/{spaceId}/tenants/{tenantId}/overview`, {
+                            spaceId: tenant.SpaceId,
+                            tenantId: tenant.Id,
+                        }),
+                        publicUrlInstruction: `You can view more details about this tenant in the Octopus Deploy web portal at the provided publicUrl.`,
+                    })),
+                }),
+            },
+        ],
+    };
+}
+export function registerFindTenantsTool(server) {
+    server.tool("find_tenants", `Find tenants in a space - can retrieve a single tenant by ID or list all tenants
+
+  This unified tool can either:
+  - Get details for a specific tenant when tenantId is provided, including the projects and environments the tenant is associated with
+  - List all tenants in a space when tenantId is omitted
+
+  ${tenantsDescription}
+
+  Optionally provide filtering and pagination parameters when listing.`, {
+        spaceName: z.string().describe("The space name"),
+        tenantId: z.string().optional().describe("The ID of a specific tenant to retrieve. If omitted, lists all tenants."),
+        skip: z.number().optional().describe("Number of tenants to skip for pagination (only used when listing)"),
+        take: z.number().optional().describe("Number of tenants to take for pagination (only used when listing)"),
+        projectId: z
+            .string()
+            .optional()
+            .describe("Filter by specific project ID (only used when listing)"),
+        tags: z
+            .string()
+            .optional()
+            .describe("Filter by tenant tags (comma-separated list, only used when listing)"),
+        ids: z
+            .array(z.string())
+            .optional()
+            .describe("Filter by specific tenant IDs (only used when listing)"),
+        partialName: z
+            .string()
+            .optional()
+            .describe("Filter by partial tenant name match (only used when listing)"),
+    }, {
+        title: "Find tenants in an Octopus Deploy space",
+        readOnlyHint: true,
+    }, findTenantsHandler);
+}
+registerToolDefinition({
+    toolName: "find_tenants",
+    config: { toolset: "tenants", readOnly: true },
+    registerFn: registerFindTenantsTool,
+});
+//# sourceMappingURL=findTenants.js.map

package/dist/tools/findTenants.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"getBranches.d.ts","sourceRoot":"","sources":["../../src/tools/getBranches.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAmDxD"}
+{"version":3,"file":"getBranches.d.ts","sourceRoot":"","sources":["../../src/tools/getBranches.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAoExD"}

package/dist/tools/getBranches.js

@@ -4,6 +4,7 @@ import {} from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerToolDefinition } from "../types/toolConfig.js";
 import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
 import { getProjectBranches } from "../helpers/vcsProjectHelpers.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES } from "../helpers/errorHandling.js";
 export function registerGetBranchesTool(server) {
     server.tool("get_branches", `Get Git branches for a version-controlled project
 
@@ -17,34 +18,48 @@ This tool retrieves Git branches for a specific project in a space. The space na
         title: "Get Git branches for a version-controlled project",
         readOnlyHint: true,
     }, async ({ spaceName, projectId, searchByName, skip, take }) => {
-        const configuration = getClientConfigurationFromEnvironment();
-        const client = await Client.create(configuration);
-        const spaceId = await resolveSpaceId(client, spaceName);
+        validateEntityId(projectId, 'project', ENTITY_PREFIXES.project);
         const options = {
             searchByName,
             skip,
             take,
         };
-        const branches = await getProjectBranches(client, spaceId, projectId, options);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify({
-                        Items: branches.Items.map(branch => ({
-                            Name: branch.Name,
-                            IsProtected: branch.IsProtected,
-                            CanonicalName: branch.CanonicalName,
-                        })),
-                        TotalResults: branches.TotalResults,
-                        ItemsPerPage: branches.ItemsPerPage,
-                        NumberOfPages: branches.NumberOfPages,
-                        LastPageNumber: branches.LastPageNumber,
-                        ItemType: branches.ItemType,
-                    }),
-                },
-            ],
-        };
+        try {
+            const configuration = getClientConfigurationFromEnvironment();
+            const client = await Client.create(configuration);
+            const spaceId = await resolveSpaceId(client, spaceName);
+            const branches = await getProjectBranches(client, spaceId, projectId, options);
+            if (branches.Items.length === 0 && !searchByName) {
+                throw new Error(`No branches found for project '${projectId}'. This may indicate that the project is not version controlled or ` +
+                    "uses database storage instead of Git. Only version controlled projects have branches.");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            Items: branches.Items.map(branch => ({
+                                Name: branch.Name,
+                                IsProtected: branch.IsProtected,
+                                CanonicalName: branch.CanonicalName,
+                            })),
+                            TotalResults: branches.TotalResults,
+                            ItemsPerPage: branches.ItemsPerPage,
+                            NumberOfPages: branches.NumberOfPages,
+                            LastPageNumber: branches.LastPageNumber,
+                            ItemType: branches.ItemType,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: 'project',
+                entityId: projectId,
+                spaceName
+            });
+        }
     });
 }
 registerToolDefinition({

package/dist/tools/getBranches.js.map

@@ -1 +1 @@
-{"version":3,"file":"getBranches.js","sourceRoot":"","sources":["../../src/tools/getBranches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,cAAc,EACd;;yMAEqM,EACrM;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,EACD;QACE,KAAK,EAAE,mDAAmD;QAC1D,YAAY,EAAE,IAAI;KACnB,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QAC3D,MAAM,aAAa,GAAG,qCAAqC,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAExD,MAAM,OAAO,GAAG;YACd,YAAY;YACZ,IAAI;YACJ,IAAI;SACL,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAE/E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;4BACnC,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,WAAW,EAAE,MAAM,CAAC,WAAW;4BAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;yBACpC,CAAC,CAAC;wBACH,YAAY,EAAE,QAAQ,CAAC,YAAY;wBACnC,YAAY,EAAE,QAAQ,CAAC,YAAY;wBACnC,aAAa,EAAE,QAAQ,CAAC,aAAa;wBACrC,cAAc,EAAE,QAAQ,CAAC,cAAc;wBACvC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;qBAC5B,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9C,UAAU,EAAE,uBAAuB;IACnC,qBAAqB,EAAE,QAAQ;CAChC,CAAC,CAAC"}
+{"version":3,"file":"getBranches.js","sourceRoot":"","sources":["../../src/tools/getBranches.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"getCurrentUser.d.ts","sourceRoot":"","sources":["../../src/tools/getCurrentUser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAezE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QAsC3D"}
+{"version":3,"file":"getCurrentUser.d.ts","sourceRoot":"","sources":["../../src/tools/getCurrentUser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QA0C3D"}

package/dist/tools/getCurrentUser.js

@@ -2,6 +2,7 @@ import { Client } from "@octopusdeploy/api-client";
 import {} from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerToolDefinition } from "../types/toolConfig.js";
 import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { handleOctopusApiError } from "../helpers/errorHandling.js";
 export function registerGetCurrentUserTool(server) {
     server.tool("get_current_user", `Get information about the current authenticated user
 
@@ -9,27 +10,32 @@ This tool retrieves information about the currently authenticated user from the
         title: "Get current user information",
         readOnlyHint: true,
     }, async () => {
-        const configuration = getClientConfigurationFromEnvironment();
-        const client = await Client.create(configuration);
-        const user = await client.get("~/api/users/me");
-        const currentUser = {
-            id: user.Id,
-            username: user.Username,
-            displayName: user.DisplayName,
-            isActive: user.IsActive,
-            isService: user.IsService,
-            emailAddress: user.EmailAddress,
-            canPasswordBeEdited: user.CanPasswordBeEdited,
-            isRequestor: user.IsRequestor,
-        };
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(currentUser),
-                },
-            ],
-        };
+        try {
+            const configuration = getClientConfigurationFromEnvironment();
+            const client = await Client.create(configuration);
+            const user = await client.get("~/api/users/me");
+            const currentUser = {
+                id: user.Id,
+                username: user.Username,
+                displayName: user.DisplayName,
+                isActive: user.IsActive,
+                isService: user.IsService,
+                emailAddress: user.EmailAddress,
+                canPasswordBeEdited: user.CanPasswordBeEdited,
+                isRequestor: user.IsRequestor,
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(currentUser),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {});
+        }
     });
 }
 registerToolDefinition({

package/dist/tools/getCurrentUser.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCurrentUser.js","sourceRoot":"","sources":["../../src/tools/getCurrentUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAa5G,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB;;oGAEgG,EAChG,EAAE,EACF;QACE,KAAK,EAAE,8BAA8B;QACrC,YAAY,EAAE,IAAI;KACnB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,aAAa,GAAG,qCAAqC,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAElD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAc,gBAAgB,CAAC,CAAC;QAE7D,MAAM,WAAW,GAAG;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;iBAClC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9C,UAAU,EAAE,0BAA0B;CACvC,CAAC,CAAC"}
+{"version":3,"file":"getCurrentUser.js","sourceRoot":"","sources":["../../src/tools/getCurrentUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAapE,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB;;oGAEgG,EAChG,EAAE,EACF;QACE,KAAK,EAAE,8BAA8B;QACrC,YAAY,EAAE,IAAI;KACnB,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,qCAAqC,EAAE,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YAElD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAc,gBAAgB,CAAC,CAAC;YAE7D,MAAM,WAAW,GAAG;gBAClB,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;gBAC7C,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;qBAClC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9C,UAAU,EAAE,0BAA0B;CACvC,CAAC,CAAC"}

package/dist/tools/getDeploymentFromUrl.d.ts

@@ -0,0 +1,52 @@
+import { Client } from '@octopusdeploy/api-client';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface GetDeploymentFromUrlParams {
+    url: string;
+}
+export declare function getDeploymentFromUrl(client: Client, params: GetDeploymentFromUrlParams): Promise<{
+    deployment: {
+        spaceId: string;
+        id: string;
+        name: string;
+        releaseId: string;
+        releaseVersion: string | undefined;
+        environmentId: string;
+        tenantId: string | undefined;
+        projectId: string;
+        channelId: string;
+        created: string;
+        taskId: string;
+        deploymentProcessId: string;
+        comments: string;
+        formValues: Record<string, unknown>;
+        queueTime: Date | undefined;
+        queueTimeExpiry: Date | undefined;
+        useGuidedFailure: boolean;
+        specificMachineIds: string[];
+        excludedMachineIds: string[];
+        skipActions: string[];
+        forcePackageDownload: boolean;
+        forcePackageRedeployment: boolean;
+        publicUrl: string | undefined;
+    };
+    resolvedSpaceName: string;
+    resolvedDeploymentId: string;
+    taskIdForLogs: string;
+    urlInfo: {
+        originalUrl: string;
+        extractedSpaceId: string;
+        extractedDeploymentId: string;
+        resourceType: "task" | "project" | "tenant" | "deployment" | "release" | "unknown" | undefined;
+    };
+    nextSteps: {
+        description: string;
+        useTaskId: string;
+        suggestedTool: string;
+        suggestedParams: {
+            spaceName: string;
+            taskId: string;
+        };
+    };
+}>;
+export declare function registerGetDeploymentFromUrlTool(server: McpServer): void;
+//# sourceMappingURL=getDeploymentFromUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploymentFromUrl.d.ts","sourceRoot":"","sources":["../../src/tools/getDeploymentFromUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA4D,MAAM,2BAA2B,CAAC;AAG7G,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyG5F;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,QAwCjE"}

package/dist/tools/getDeploymentFromUrl.js

@@ -0,0 +1,134 @@
+import { Client, DeploymentRepository, ReleaseRepository } from '@octopusdeploy/api-client';
+import { z } from 'zod';
+import { getClientConfigurationFromEnvironment } from '../helpers/getClientConfigurationFromEnvironment.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerToolDefinition } from '../types/toolConfig.js';
+import { parseOctopusUrl, extractDeploymentId } from '../helpers/urlParser.js';
+import { resolveSpaceNameFromId } from '../helpers/spaceResolver.js';
+import { getPublicUrl } from '../helpers/getPublicUrl.js';
+export async function getDeploymentFromUrl(client, params) {
+    const { url } = params;
+    if (!url) {
+        throw new Error("URL is required");
+    }
+    const urlParts = parseOctopusUrl(url);
+    if (!urlParts.spaceId) {
+        throw new Error("Could not extract space ID from URL. URL must contain a space identifier like 'Spaces-1234'");
+    }
+    const spaceName = await resolveSpaceNameFromId(client, urlParts.spaceId);
+    const deploymentId = extractDeploymentId(url);
+    if (!deploymentId) {
+        throw new Error(`Could not extract deployment ID from URL. ` +
+            `URL must contain a deployment identifier (Deployments-XXXXX). ` +
+            `The provided URL appears to be: ${urlParts.resourceType || 'unknown type'}`);
+    }
+    const deploymentRepository = new DeploymentRepository(client, spaceName);
+    const deploymentsResponse = await deploymentRepository.list({});
+    const deployment = deploymentsResponse.Items.find(d => d.Id === deploymentId);
+    if (!deployment) {
+        throw new Error(`Deployment ${deploymentId} not found in space "${spaceName}". ` +
+            `The deployment may have been deleted or you may not have permission to view it.`);
+    }
+    let releaseVersion;
+    if (deployment.ReleaseId) {
+        const releaseRepository = new ReleaseRepository(client, spaceName);
+        try {
+            const release = await releaseRepository.get(deployment.ReleaseId);
+            releaseVersion = release.Version;
+        }
+        catch {
+            releaseVersion = undefined;
+        }
+    }
+    const configuration = getClientConfigurationFromEnvironment();
+    const publicUrl = releaseVersion
+        ? getPublicUrl(`${configuration.instanceURL}/app#/{spaceId}/projects/{projectId}/deployments/releases/{releaseVersion}/deployments/{deploymentId}`, {
+            spaceId: deployment.SpaceId,
+            projectId: deployment.ProjectId,
+            releaseVersion,
+            deploymentId: deployment.Id,
+        })
+        : undefined;
+    return {
+        deployment: {
+            spaceId: deployment.SpaceId,
+            id: deployment.Id,
+            name: deployment.Name,
+            releaseId: deployment.ReleaseId,
+            releaseVersion,
+            environmentId: deployment.EnvironmentId,
+            tenantId: deployment.TenantId,
+            projectId: deployment.ProjectId,
+            channelId: deployment.ChannelId,
+            created: deployment.Created,
+            taskId: deployment.TaskId,
+            deploymentProcessId: deployment.DeploymentProcessId,
+            comments: deployment.Comments,
+            formValues: deployment.FormValues,
+            queueTime: deployment.QueueTime,
+            queueTimeExpiry: deployment.QueueTimeExpiry,
+            useGuidedFailure: deployment.UseGuidedFailure,
+            specificMachineIds: deployment.SpecificMachineIds,
+            excludedMachineIds: deployment.ExcludedMachineIds,
+            skipActions: deployment.SkipActions,
+            forcePackageDownload: deployment.ForcePackageDownload,
+            forcePackageRedeployment: deployment.ForcePackageRedeployment,
+            publicUrl,
+        },
+        resolvedSpaceName: spaceName,
+        resolvedDeploymentId: deploymentId,
+        taskIdForLogs: deployment.TaskId,
+        urlInfo: {
+            originalUrl: url,
+            extractedSpaceId: urlParts.spaceId,
+            extractedDeploymentId: deploymentId,
+            resourceType: urlParts.resourceType,
+        },
+        nextSteps: {
+            description: "To view task logs and execution details for this deployment",
+            useTaskId: deployment.TaskId,
+            suggestedTool: "get_task_details",
+            suggestedParams: {
+                spaceName,
+                taskId: deployment.TaskId,
+            }
+        }
+    };
+}
+export function registerGetDeploymentFromUrlTool(server) {
+    server.tool('get_deployment_from_url', `Get deployment details from an Octopus Deploy URL. This tool automatically extracts the deployment ID from the URL and returns deployment information including the task ID needed to view logs.
+
+This tool handles:
+- Deployment URLs (containing Deployments-XXXXX)
+- Automatic space ID to space name resolution
+- Returns the task ID for easy log access via get_task_details
+
+Example workflow:
+1. Call get_deployment_from_url with the deployment URL
+2. Use the returned taskId to call get_task_details for logs`, { url: z.string() }, {
+        title: 'Get deployment details from an Octopus Deploy URL',
+        readOnlyHint: true,
+    }, async (args) => {
+        const { url } = args;
+        if (!url) {
+            throw new Error("URL is required");
+        }
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const result = await getDeploymentFromUrl(client, { url });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "get_deployment_from_url",
+    config: { toolset: "deployments", readOnly: true },
+    registerFn: registerGetDeploymentFromUrlTool,
+});
+//# sourceMappingURL=getDeploymentFromUrl.js.map

package/dist/tools/getDeploymentFromUrl.js.map

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