@octopusdeploy/mcp-server 1.0.1 → 1.1.0

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;AAKzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,QAyP1D"}

package/dist/tools/deployRelease.js

@@ -0,0 +1,207 @@
+import { Client, DeploymentRepository } 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 { handleOctopusApiError } from "../helpers/errorHandling.js";
+export function registerDeployReleaseTool(server) {
+    server.tool("deploy_release", `Deploy a release to one or more environments in Octopus Deploy
+
+This tool supports both tenanted and untenanted deployments:
+- **Untenanted**: Don't provide tenants or tenantTags. Can deploy to multiple environments at once.
+- **Tenanted**: Provide tenants or tenantTags. Can only deploy to ONE environment, but can target multiple tenants.
+
+The tool automatically determines which deployment type to use based on the parameters provided.`, {
+        spaceName: z.string().describe("The space name"),
+        projectName: z.string().describe("The project name"),
+        releaseVersion: z
+            .string()
+            .describe("The release version to deploy (e.g., '1.0.0')"),
+        environmentNames: z
+            .array(z.string())
+            .describe("Array of environment names. For tenanted deployments, must contain exactly one environment."),
+        tenants: z
+            .array(z.string())
+            .optional()
+            .describe("Array of tenant names for tenanted deployment (optional)"),
+        tenantTags: z
+            .array(z.string())
+            .optional()
+            .describe("Array of tenant tags for tenanted deployment (e.g., ['Region/US-West', 'Tier/Production'])"),
+        forcePackageRedeployment: z
+            .boolean()
+            .optional()
+            .describe("Force redeployment of packages"),
+        updateVariableSnapshot: z
+            .boolean()
+            .optional()
+            .describe("Update the variable snapshot"),
+        forcePackageDownload: z
+            .boolean()
+            .optional()
+            .describe("Force package download"),
+        specificMachineNames: z
+            .array(z.string())
+            .optional()
+            .describe("Deploy to specific machines only"),
+        excludedMachineNames: z
+            .array(z.string())
+            .optional()
+            .describe("Exclude specific machines from deployment"),
+        skipStepNames: z
+            .array(z.string())
+            .optional()
+            .describe("Skip specific deployment steps"),
+        useGuidedFailure: z
+            .boolean()
+            .optional()
+            .describe("Use guided failure mode"),
+        runAt: z
+            .string()
+            .optional()
+            .describe("Schedule deployment for later (ISO 8601 date string)"),
+        noRunAfter: z
+            .string()
+            .optional()
+            .describe("Don't run deployment after this time (ISO 8601 date string)"),
+        variables: z
+            .record(z.string())
+            .optional()
+            .describe("Prompted variable values as key-value pairs"),
+        deploymentFreezeOverrideReason: z
+            .string()
+            .optional()
+            .describe("Reason for overriding deployment freeze"),
+        deploymentFreezeNames: z
+            .array(z.string())
+            .optional()
+            .describe("Names of deployment freezes to override"),
+    }, {
+        title: "Deploy a release to environments in Octopus Deploy",
+        readOnlyHint: false,
+    }, async ({ spaceName, projectName, releaseVersion, environmentNames, tenants, tenantTags, forcePackageRedeployment, updateVariableSnapshot, forcePackageDownload, specificMachineNames, excludedMachineNames, skipStepNames, useGuidedFailure, runAt, noRunAfter, variables, deploymentFreezeOverrideReason, deploymentFreezeNames, }) => {
+        try {
+            // Validate environment names
+            if (!environmentNames || environmentNames.length === 0) {
+                throw new Error("At least one environment name must be provided.");
+            }
+            // Determine if this is a tenanted deployment
+            const isTenanted = (tenants && tenants.length > 0) ||
+                (tenantTags && tenantTags.length > 0);
+            // Validate tenanted deployment constraints
+            if (isTenanted && environmentNames.length !== 1) {
+                throw new Error(`Tenanted deployments can only target one environment at a time. You provided ${environmentNames.length} environments. ` +
+                    `For tenanted deployments, specify exactly one environment in environmentNames, then use tenants or tenantTags to target specific tenants.`);
+            }
+            const configuration = getClientConfigurationFromEnvironment();
+            const client = await Client.create(configuration);
+            const deploymentRepository = new DeploymentRepository(client, spaceName);
+            // Build common parameters
+            const commonParams = {
+                spaceName: spaceName,
+                ProjectName: projectName,
+                ...(forcePackageRedeployment !== undefined && {
+                    ForcePackageRedeployment: forcePackageRedeployment,
+                }),
+                ...(updateVariableSnapshot !== undefined && {
+                    UpdateVariableSnapshot: updateVariableSnapshot,
+                }),
+                ...(forcePackageDownload !== undefined && {
+                    ForcePackageDownload: forcePackageDownload,
+                }),
+                ...(specificMachineNames && {
+                    SpecificMachineNames: specificMachineNames,
+                }),
+                ...(excludedMachineNames && {
+                    ExcludedMachineNames: excludedMachineNames,
+                }),
+                ...(skipStepNames && { SkipStepNames: skipStepNames }),
+                ...(useGuidedFailure !== undefined && {
+                    UseGuidedFailure: useGuidedFailure,
+                }),
+                ...(runAt && { RunAt: new Date(runAt) }),
+                ...(noRunAfter && { NoRunAfter: new Date(noRunAfter) }),
+                ...(variables && { Variables: variables }),
+                ...(deploymentFreezeOverrideReason && {
+                    DeploymentFreezeOverrideReason: deploymentFreezeOverrideReason,
+                }),
+                ...(deploymentFreezeNames && {
+                    DeploymentFreezeNames: deploymentFreezeNames,
+                }),
+            };
+            let response;
+            let deploymentType;
+            if (isTenanted) {
+                // Tenanted deployment
+                deploymentType = "tenanted";
+                const command = {
+                    ...commonParams,
+                    ReleaseVersion: releaseVersion,
+                    EnvironmentName: environmentNames[0],
+                    Tenants: tenants || [],
+                    TenantTags: tenantTags || [],
+                };
+                response = await deploymentRepository.createTenanted(command);
+            }
+            else {
+                // Untenanted deployment
+                deploymentType = "untenanted";
+                const command = {
+                    ...commonParams,
+                    ReleaseVersion: releaseVersion,
+                    EnvironmentNames: environmentNames,
+                };
+                response = await deploymentRepository.create(command);
+            }
+            // Format the response
+            const tasks = response.DeploymentServerTasks || [];
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            deploymentType,
+                            deploymentsCreated: tasks.length,
+                            deploymentTasks: tasks.map((task) => ({
+                                taskId: task.ServerTaskId,
+                                deploymentId: task.DeploymentId,
+                            })),
+                            message: `Successfully created ${tasks.length} deployment(s) for release ${releaseVersion}`,
+                            helpText: `Use get_task_by_id with the taskId values to monitor deployment progress. Use list_deployments to view deployment details. Use find_releases to verify the release exists.`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            // Handle validation errors from our code
+            if (error instanceof Error && !error.message.includes("octopus")) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: error.message,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Handle Octopus API errors
+            handleOctopusApiError(error, {
+                entityType: "deployment",
+                spaceName,
+                helpText: "Use list_projects to find valid project names, list_environments for environment names, find_releases to verify the release exists, and find_tenants for tenant information. Ensure you have permissions to create deployments.",
+            });
+        }
+    });
+}
+registerToolDefinition({
+    toolName: "deploy_release",
+    config: { toolset: "deployments", readOnly: false },
+    registerFn: registerDeployReleaseTool,
+});
+//# sourceMappingURL=deployRelease.js.map

package/dist/tools/deployRelease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployRelease.js","sourceRoot":"","sources":["../../src/tools/deployRelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB;;;;;;iGAM6F,EAC7F;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACpD,cAAc,EAAE,CAAC;aACd,MAAM,EAAE;aACR,QAAQ,CAAC,+CAA+C,CAAC;QAC5D,gBAAgB,EAAE,CAAC;aAChB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,6FAA6F,CAC9F;QACH,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,CAAC;QACvE,UAAU,EAAE,CAAC;aACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CACP,4FAA4F,CAC7F;QACH,wBAAwB,EAAE,CAAC;aACxB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,gCAAgC,CAAC;QAC7C,sBAAsB,EAAE,CAAC;aACtB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,8BAA8B,CAAC;QAC3C,oBAAoB,EAAE,CAAC;aACpB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,wBAAwB,CAAC;QACrC,oBAAoB,EAAE,CAAC;aACpB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,kCAAkC,CAAC;QAC/C,oBAAoB,EAAE,CAAC;aACpB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,2CAA2C,CAAC;QACxD,aAAa,EAAE,CAAC;aACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,gCAAgC,CAAC;QAC7C,gBAAgB,EAAE,CAAC;aAChB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,yBAAyB,CAAC;QACtC,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,sDAAsD,CAAC;QACnE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,6DAA6D,CAC9D;QACH,SAAS,EAAE,CAAC;aACT,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aAClB,QAAQ,EAAE;aACV,QAAQ,CAAC,6CAA6C,CAAC;QAC1D,8BAA8B,EAAE,CAAC;aAC9B,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,yCAAyC,CAAC;QACtD,qBAAqB,EAAE,CAAC;aACrB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,yCAAyC,CAAC;KACvD,EACD;QACE,KAAK,EAAE,oDAAoD;QAC3D,YAAY,EAAE,KAAK;KACpB,EACD,KAAK,EAAE,EACL,SAAS,EACT,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,UAAU,EACV,SAAS,EACT,8BAA8B,EAC9B,qBAAqB,GACtB,EAAE,EAAE;QACH,IAAI,CAAC;YACH,6BAA6B;YAC7B,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;YAED,6CAA6C;YAC7C,MAAM,UAAU,GACd,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC/B,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAExC,2CAA2C;YAC3C,IAAI,UAAU,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,KAAK,CACb,gFAAgF,gBAAgB,CAAC,MAAM,iBAAiB;oBACtH,2IAA2I,CAC9I,CAAC;YACJ,CAAC;YAED,MAAM,aAAa,GAAG,qCAAqC,EAAE,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YAClD,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,CACnD,MAAM,EACN,SAAS,CACV,CAAC;YAEF,0BAA0B;YAC1B,MAAM,YAAY,GAAG;gBACnB,SAAS,EAAE,SAAS;gBACpB,WAAW,EAAE,WAAW;gBACxB,GAAG,CAAC,wBAAwB,KAAK,SAAS,IAAI;oBAC5C,wBAAwB,EAAE,wBAAwB;iBACnD,CAAC;gBACF,GAAG,CAAC,sBAAsB,KAAK,SAAS,IAAI;oBAC1C,sBAAsB,EAAE,sBAAsB;iBAC/C,CAAC;gBACF,GAAG,CAAC,oBAAoB,KAAK,SAAS,IAAI;oBACxC,oBAAoB,EAAE,oBAAoB;iBAC3C,CAAC;gBACF,GAAG,CAAC,oBAAoB,IAAI;oBAC1B,oBAAoB,EAAE,oBAAoB;iBAC3C,CAAC;gBACF,GAAG,CAAC,oBAAoB,IAAI;oBAC1B,oBAAoB,EAAE,oBAAoB;iBAC3C,CAAC;gBACF,GAAG,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;gBACtD,GAAG,CAAC,gBAAgB,KAAK,SAAS,IAAI;oBACpC,gBAAgB,EAAE,gBAAgB;iBACnC,CAAC;gBACF,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxC,GAAG,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACvD,GAAG,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;gBAC1C,GAAG,CAAC,8BAA8B,IAAI;oBACpC,8BAA8B,EAAE,8BAA8B;iBAC/D,CAAC;gBACF,GAAG,CAAC,qBAAqB,IAAI;oBAC3B,qBAAqB,EAAE,qBAAqB;iBAC7C,CAAC;aACH,CAAC;YAEF,IAAI,QAAQ,CAAC;YACb,IAAI,cAAc,CAAC;YAEnB,IAAI,UAAU,EAAE,CAAC;gBACf,sBAAsB;gBACtB,cAAc,GAAG,UAAU,CAAC;gBAC5B,MAAM,OAAO,GAAG;oBACd,GAAG,YAAY;oBACf,cAAc,EAAE,cAAc;oBAC9B,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAC;oBACpC,OAAO,EAAE,OAAO,IAAI,EAAE;oBACtB,UAAU,EAAE,UAAU,IAAI,EAAE;iBAC7B,CAAC;gBAEF,QAAQ,GAAG,MAAM,oBAAoB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,wBAAwB;gBACxB,cAAc,GAAG,YAAY,CAAC;gBAC9B,MAAM,OAAO,GAAG;oBACd,GAAG,YAAY;oBACf,cAAc,EAAE,cAAc;oBAC9B,gBAAgB,EAAE,gBAAgB;iBACnC,CAAC;gBAEF,QAAQ,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACxD,CAAC;YAED,sBAAsB;YACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,qBAAqB,IAAI,EAAE,CAAC;YAEnD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,IAAI;4BACb,cAAc;4BACd,kBAAkB,EAAE,KAAK,CAAC,MAAM;4BAChC,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gCACpC,MAAM,EAAE,IAAI,CAAC,YAAY;gCACzB,YAAY,EAAE,IAAI,CAAC,YAAY;6BAChC,CAAC,CAAC;4BACH,OAAO,EAAE,wBAAwB,KAAK,CAAC,MAAM,8BAA8B,cAAc,EAAE;4BAC3F,QAAQ,EAAE,4KAA4K;yBACvL,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yCAAyC;YACzC,IAAI,KAAK,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjE,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;gCACE,OAAO,EAAE,KAAK;gCACd,KAAK,EAAE,KAAK,CAAC,OAAO;6BACrB,EACD,IAAI,EACJ,CAAC,CACF;yBACF;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,4BAA4B;YAC5B,qBAAqB,CAAC,KAAK,EAAE;gBAC3B,UAAU,EAAE,YAAY;gBACxB,SAAS;gBACT,QAAQ,EACN,iOAAiO;aACpO,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,gBAAgB;IAC1B,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;IACnD,UAAU,EAAE,yBAAyB;CACtC,CAAC,CAAC"}

package/dist/tools/findAccounts.d.ts

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

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

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

package/dist/tools/findAccounts.js

@@ -0,0 +1,87 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { mapAccountResource, AccountType } from "../types/accountTypes.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES } from "../helpers/errorHandling.js";
+export function registerFindAccountsTool(server) {
+    server.tool("find_accounts", `Find accounts in a space - can retrieve a single account by ID or list all accounts
+
+This unified tool can either:
+- Get detailed information about a specific account when accountId is provided
+- List all accounts in a space when accountId is omitted
+
+You can optionally filter by various parameters like name, account type, etc. when listing.`, {
+        spaceName: z.string(),
+        accountId: z.string().optional().describe("The ID of a specific account to retrieve. If omitted, lists all accounts."),
+        skip: z.number().optional().describe("Number of accounts to skip for pagination (only used when listing)"),
+        take: z.number().optional().describe("Number of accounts to take for pagination (only used when listing)"),
+        ids: z.array(z.string()).optional().describe("Filter by specific account IDs (only used when listing)"),
+        partialName: z.string().optional().describe("Filter by partial name match (only used when listing)"),
+        accountType: z.nativeEnum(AccountType).optional().describe("Filter by account type (only used when listing)"),
+    }, {
+        title: "Find accounts in an Octopus Deploy space",
+        readOnlyHint: true,
+    }, async ({ spaceName, accountId, skip, take, ids, partialName, accountType, }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const spaceId = await resolveSpaceId(client, spaceName);
+        // If accountId is provided, get a single account
+        if (accountId) {
+            validateEntityId(accountId, 'account', ENTITY_PREFIXES.account);
+            try {
+                const response = await client.get("~/api/{spaceId}/accounts/{id}", {
+                    spaceId,
+                    id: accountId,
+                });
+                const account = mapAccountResource(response);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(account),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                handleOctopusApiError(error, {
+                    entityType: 'account',
+                    entityId: accountId,
+                    spaceName
+                });
+            }
+        }
+        // Otherwise, list all accounts
+        const response = await client.get("~/api/{spaceId}/accounts{?skip,take,ids,partialName,accountType}", {
+            spaceId,
+            skip,
+            take,
+            ids,
+            partialName,
+            accountType,
+        });
+        const accounts = response.Items.map((account) => mapAccountResource(account));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        totalResults: response.TotalResults,
+                        itemsPerPage: response.ItemsPerPage,
+                        numberOfPages: response.NumberOfPages,
+                        lastPageNumber: response.LastPageNumber,
+                        items: accounts,
+                    }),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "find_accounts",
+    config: { toolset: "accounts", readOnly: true },
+    registerFn: registerFindAccountsTool,
+});
+//# sourceMappingURL=findAccounts.js.map

package/dist/tools/findAccounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findAccounts.js","sourceRoot":"","sources":["../../src/tools/findAccounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAA2B,MAAM,2BAA2B,CAAC;AAC5F,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,EAEL,kBAAkB,EAClB,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEvG,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,IAAI,CACT,eAAe,EACf;;;;;;4FAMwF,EACxF;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;QACtH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;QAC1G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;QAC1G,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;QACvG,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;QACpG,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;KAC9G,EACD;QACE,KAAK,EAAE,0CAA0C;QACjD,YAAY,EAAE,IAAI;KACnB,EACD,KAAK,EAAE,EACL,SAAS,EACT,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,WAAW,EACX,WAAW,GACZ,EAAE,EAAE;QACH,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,iDAAiD;QACjD,IAAI,SAAS,EAAE,CAAC;YACd,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;YAEhE,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,+BAA+B,EAC/B;oBACE,OAAO;oBACP,EAAE,EAAE,SAAS;iBACd,CACF,CAAC;gBAEF,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;gBAE7C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;yBAC9B;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,qBAAqB,CAAC,KAAK,EAAE;oBAC3B,UAAU,EAAE,SAAS;oBACrB,QAAQ,EAAE,SAAS;oBACnB,SAAS;iBACV,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,kEAAkE,EAClE;YACE,OAAO;YACP,IAAI;YACJ,IAAI;YACJ,GAAG;YACH,WAAW;YACX,WAAW;SACZ,CACF,CAAC;QAEF,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAwB,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;QAE/F,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,YAAY,EAAE,QAAQ,CAAC,YAAY;wBACnC,YAAY,EAAE,QAAQ,CAAC,YAAY;wBACnC,aAAa,EAAE,QAAQ,CAAC,aAAa;wBACrC,cAAc,EAAE,QAAQ,CAAC,cAAc;wBACvC,KAAK,EAAE,QAAQ;qBAChB,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC/C,UAAU,EAAE,wBAAwB;CACrC,CAAC,CAAC"}

package/dist/tools/findCertificates.d.ts

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

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

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

package/dist/tools/findCertificates.js

@@ -0,0 +1,95 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { mapCertificateResource } from "../types/certificateTypes.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES } from "../helpers/errorHandling.js";
+export function registerFindCertificatesTool(server) {
+    server.tool("find_certificates", `Find certificates in a space - can retrieve a single certificate by ID or list all certificates
+
+This unified tool can either:
+- Get detailed information about a specific certificate when certificateId is provided
+- List all certificates in a space when certificateId is omitted
+
+You can optionally filter by various parameters like name, archived status, tenant, etc. when listing.`, {
+        spaceName: z.string(),
+        certificateId: z.string().optional().describe("The ID of a specific certificate to retrieve. If omitted, lists all certificates."),
+        skip: z.number().optional().describe("Number of certificates to skip for pagination (only used when listing)"),
+        take: z.number().optional().describe("Number of certificates to take for pagination (only used when listing)"),
+        search: z.string().optional().describe("Search term to filter certificates (only used when listing)"),
+        archived: z.boolean().optional().describe("Filter by archived status (only used when listing)"),
+        tenant: z.string().optional().describe("Filter by tenant (only used when listing)"),
+        firstResult: z.number().optional().describe("Index of first result to return (only used when listing)"),
+        orderBy: z.string().optional().describe("Field to order results by (only used when listing)"),
+        ids: z.array(z.string()).optional().describe("Filter by specific certificate IDs (only used when listing)"),
+        partialName: z.string().optional().describe("Filter by partial name match (only used when listing)"),
+    }, {
+        title: "Find certificates in an Octopus Deploy space",
+        readOnlyHint: true,
+    }, async ({ spaceName, certificateId, skip, take, search, archived, tenant, firstResult, orderBy, ids, partialName, }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const spaceId = await resolveSpaceId(client, spaceName);
+        // If certificateId is provided, get a single certificate
+        if (certificateId) {
+            validateEntityId(certificateId, 'certificate', ENTITY_PREFIXES.certificate);
+            try {
+                const response = await client.get("~/api/{spaceId}/certificates/{id}", {
+                    spaceId,
+                    id: certificateId,
+                });
+                const certificate = mapCertificateResource(response);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(certificate),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                handleOctopusApiError(error, {
+                    entityType: 'certificate',
+                    entityId: certificateId,
+                    spaceName
+                });
+            }
+        }
+        // Otherwise, list all certificates
+        const response = await client.get("~/api/{spaceId}/certificates{?skip,take,search,archived,tenant,firstResult,orderBy,ids,partialName}", {
+            spaceId,
+            skip,
+            take,
+            search,
+            archived,
+            tenant,
+            firstResult,
+            orderBy,
+            ids,
+            partialName,
+        });
+        const certificates = response.Items.map((cert) => mapCertificateResource(cert));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        totalResults: response.TotalResults,
+                        itemsPerPage: response.ItemsPerPage,
+                        numberOfPages: response.NumberOfPages,
+                        lastPageNumber: response.LastPageNumber,
+                        items: certificates,
+                    }),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "find_certificates",
+    config: { toolset: "certificates", readOnly: true },
+    registerFn: registerFindCertificatesTool,
+});
+//# sourceMappingURL=findCertificates.js.map

package/dist/tools/findCertificates.js.map

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

package/dist/tools/findDeploymentTargets.d.ts

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

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

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

package/dist/tools/findDeploymentTargets.js

@@ -0,0 +1,158 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import {} from "../types/deploymentTargetTypes.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES } from "../helpers/errorHandling.js";
+export function registerFindDeploymentTargetsTool(server) {
+    server.tool("find_deployment_targets", `Find deployment targets (machines) in a space - can retrieve a single target by ID or list all targets
+
+This unified tool can either:
+- Get detailed information about a specific deployment target when targetId is provided
+- List all deployment targets in a space when targetId is omitted
+
+You can optionally filter by various parameters like name, roles, health status, etc. when listing.`, {
+        spaceName: z.string(),
+        targetId: z.string().optional().describe("The ID of a specific deployment target to retrieve. If omitted, lists all deployment targets."),
+        skip: z.number().optional().describe("Number of targets to skip for pagination (only used when listing)"),
+        take: z.number().optional().describe("Number of targets to take for pagination (only used when listing)"),
+        name: z.string().optional().describe("Filter by exact name (only used when listing)"),
+        ids: z.array(z.string()).optional().describe("Filter by specific target IDs (only used when listing)"),
+        partialName: z.string().optional().describe("Filter by partial name match (only used when listing)"),
+        roles: z.array(z.string()).optional().describe("A list of roles / target tags to filter by (only used when listing)"),
+        isDisabled: z.boolean().optional().describe("Filter by disabled status (only used when listing)"),
+        healthStatuses: z.array(z.string()).optional().describe("Possible values: Healthy, Unhealthy, Unavailable, Unknown, HasWarnings (only used when listing)"),
+        commStyles: z.array(z.string()).optional().describe("Filter by communication styles (only used when listing)"),
+        tenantIds: z.array(z.string()).optional().describe("Filter by tenant IDs (only used when listing)"),
+        tenantTags: z.array(z.string()).optional().describe("Filter by tenant tags (only used when listing)"),
+        environmentIds: z.array(z.string()).optional().describe("Filter by environment IDs (only used when listing)"),
+        thumbprint: z.string().optional().describe("Filter by thumbprint (only used when listing)"),
+        deploymentId: z.string().optional().describe("Filter by deployment ID (only used when listing)"),
+        shellNames: z.array(z.string()).optional().describe("Filter by shell names (only used when listing)"),
+        deploymentTargetTypes: z.array(z.string()).optional().describe("Filter by deployment target types (only used when listing)"),
+    }, {
+        title: "Find deployment targets in an Octopus Deploy space",
+        readOnlyHint: true,
+    }, async ({ spaceName, targetId, skip, take, name, ids, partialName, roles, isDisabled, healthStatuses, commStyles, tenantIds, tenantTags, environmentIds, thumbprint, deploymentId, shellNames, deploymentTargetTypes, }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const spaceId = await resolveSpaceId(client, spaceName);
+        // If targetId is provided, get a single deployment target
+        if (targetId) {
+            validateEntityId(targetId, 'machine', ENTITY_PREFIXES.machine);
+            try {
+                const target = await client.get("~/api/{spaceId}/machines/{id}", {
+                    spaceId,
+                    id: targetId,
+                });
+                const deploymentTarget = {
+                    spaceId: target.SpaceId,
+                    id: target.Id,
+                    name: target.Name,
+                    slug: target.Slug,
+                    isDisabled: target.IsDisabled,
+                    healthStatus: target.HealthStatus,
+                    statusSummary: target.StatusSummary,
+                    environmentIds: target.EnvironmentIds,
+                    roles: target.Roles,
+                    tenantedDeploymentParticipation: target.TenantedDeploymentParticipation,
+                    tenantIds: target.TenantIds,
+                    tenantTags: target.TenantTags,
+                    endpoint: {
+                        id: target.Endpoint.Id,
+                        communicationStyle: target.Endpoint.CommunicationStyle,
+                        uri: target.Endpoint.Uri,
+                        fingerprint: target.Endpoint.Fingerprint,
+                        proxyId: target.Endpoint.ProxyId,
+                        tentacleVersionDetails: target.Endpoint.TentacleVersionDetails,
+                    },
+                    shellName: target.ShellName,
+                    machinePolicyId: target.MachinePolicyId,
+                    hasLatestCalamari: target.HasLatestCalamari,
+                    isInProcess: target.IsInProcess,
+                    links: target.Links,
+                };
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(deploymentTarget),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                handleOctopusApiError(error, {
+                    entityType: 'deployment target',
+                    entityId: targetId,
+                    spaceName,
+                    helpText: "Use find_deployment_targets without targetId to find valid target IDs."
+                });
+            }
+        }
+        // Otherwise, list all deployment targets
+        const response = await client.get("~/api/{spaceId}/machines{?skip,take,name,ids,partialName,roles,isDisabled,healthStatuses,commStyles,tenantIds,tenantTags,environmentIds,thumbprint,deploymentId,shellNames,deploymentTargetTypes}", {
+            spaceId,
+            skip,
+            take,
+            name,
+            ids,
+            partialName,
+            roles,
+            isDisabled,
+            healthStatuses,
+            commStyles,
+            tenantIds,
+            tenantTags,
+            environmentIds,
+            thumbprint,
+            deploymentId,
+            shellNames,
+            deploymentTargetTypes,
+        });
+        const deploymentTargets = response.Items.map((target) => ({
+            spaceId: target.SpaceId,
+            id: target.Id,
+            name: target.Name,
+            slug: target.Slug,
+            isDisabled: target.IsDisabled,
+            healthStatus: target.HealthStatus,
+            statusSummary: target.StatusSummary,
+            environmentIds: target.EnvironmentIds,
+            roles: target.Roles,
+            tenantedDeploymentParticipation: target.TenantedDeploymentParticipation,
+            tenantIds: target.TenantIds,
+            tenantTags: target.TenantTags,
+            endpoint: {
+                communicationStyle: target.Endpoint.CommunicationStyle,
+                uri: target.Endpoint.Uri,
+                fingerprint: target.Endpoint.Fingerprint,
+            },
+            shellName: target.ShellName,
+            machinePolicyId: target.MachinePolicyId,
+            hasLatestCalamari: target.HasLatestCalamari,
+            isInProcess: target.IsInProcess,
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        totalResults: response.TotalResults,
+                        itemsPerPage: response.ItemsPerPage,
+                        numberOfPages: response.NumberOfPages,
+                        lastPageNumber: response.LastPageNumber,
+                        items: deploymentTargets,
+                    }),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "find_deployment_targets",
+    config: { toolset: "machines", readOnly: true },
+    registerFn: registerFindDeploymentTargetsTool,
+});
+//# sourceMappingURL=findDeploymentTargets.js.map

package/dist/tools/findDeploymentTargets.js.map

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

package/dist/tools/findReleases.d.ts

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

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

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