@octopusdeploy/mcp-server 1.0.1 → 2.1.0

package/dist/tools/getTenantVariables.js

@@ -3,51 +3,71 @@ import { z } from "zod";
 import {} from "@modelcontextprotocol/sdk/server/mcp.js";
 import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
 import { registerToolDefinition } from "../types/toolConfig.js";
+import { READ_ONLY_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES } from "../helpers/errorHandling.js";
 export function registerGetTenantVariablesTool(server) {
-    server.tool("get_tenant_variables", `Get tenant variables by type
-  
+    server.registerTool("get_tenant_variables", {
+        title: "Get tenant variables from Octopus Deploy",
+        description: `Get tenant variables by type
+
   This tool retrieves different types of tenant variables. Use variableType parameter to specify which type:
   - "all": Get all tenant variables
   - "common": Get common variables only
-  - "project": Get project-specific variables only`, {
-        spaceName: z.string().describe("The space name"),
-        tenantId: z.string().describe("The ID of the tenant to retrieve variables for"),
-        variableType: z.enum(["all", "common", "project"]).describe("Type of variables to retrieve"),
-        includeMissingVariables: z.boolean().optional().describe("Include missing variables in the response (for common/project types)")
-    }, {
-        title: "Get tenant variables from Octopus Deploy",
-        readOnlyHint: true,
+  - "project": Get project-specific variables only`,
+        inputSchema: {
+            spaceName: z.string().describe("The space name"),
+            tenantId: z.string().describe("The ID of the tenant to retrieve variables for"),
+            variableType: z.enum(["all", "common", "project"]).describe("Type of variables to retrieve"),
+            includeMissingVariables: z.boolean().optional().describe("Include missing variables in the response (for common/project types)")
+        },
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ spaceName, tenantId, variableType, includeMissingVariables = false }) => {
-        const configuration = getClientConfigurationFromEnvironment();
-        const client = await Client.create(configuration);
-        const tenantRepository = new TenantRepository(client, spaceName);
-        let variables;
-        switch (variableType) {
-            case "all": {
-                const tenant = await tenantRepository.get(tenantId);
-                variables = await tenantRepository.getVariables(tenant);
-                break;
+        validateEntityId(tenantId, 'tenant', ENTITY_PREFIXES.tenant);
+        if (!variableType) {
+            throw new Error("Variable type is required. Valid values are: 'all', 'common', or 'project'. " +
+                "'all' returns all variables, 'common' returns shared variables, 'project' returns project-specific variables.");
+        }
+        try {
+            const configuration = getClientConfigurationFromEnvironment();
+            const client = await Client.create(configuration);
+            const tenantRepository = new TenantRepository(client, spaceName);
+            let variables;
+            switch (variableType) {
+                case "all": {
+                    const tenant = await tenantRepository.get(tenantId);
+                    variables = await tenantRepository.getVariables(tenant);
+                    break;
+                }
+                case "common":
+                    variables = await tenantRepository.getCommonVariablesById(tenantId, includeMissingVariables);
+                    break;
+                case "project":
+                    variables = await tenantRepository.getProjectVariablesById(tenantId, includeMissingVariables);
+                    break;
+                default:
+                    throw new Error(`Invalid variable type '${variableType}'. Valid values are: 'all', 'common', or 'project'.`);
             }
-            case "common":
-                variables = await tenantRepository.getCommonVariablesById(tenantId, includeMissingVariables);
-                break;
-            case "project":
-                variables = await tenantRepository.getProjectVariablesById(tenantId, includeMissingVariables);
-                break;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            tenantId,
+                            variableType,
+                            includeMissingVariables,
+                            variables
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: 'tenant',
+                entityId: tenantId,
+                spaceName
+            });
         }
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify({
-                        tenantId,
-                        variableType,
-                        includeMissingVariables,
-                        variables
-                    }),
-                },
-            ],
-        };
     });
 }
 registerToolDefinition({

package/dist/tools/getTenantVariables.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTenantVariables.js","sourceRoot":"","sources":["../../src/tools/getTenantVariables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACrE,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;AAEhE,MAAM,UAAU,8BAA8B,CAAC,MAAiB;IAC9D,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB;;;;;mDAK+C,EAC/C;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAC/E,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAC5F,uBAAuB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;KACjI,EACD;QACE,KAAK,EAAE,0CAA0C;QACjD,YAAY,EAAE,IAAI;KACnB,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,uBAAuB,GAAG,KAAK,EAAE,EAAE,EAAE;QAC/E,MAAM,aAAa,GAAG,qCAAqC,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAEjE,IAAI,SAAS,CAAC;QAEd,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACpD,SAAS,GAAG,MAAM,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACxD,MAAM;YACR,CAAC;YACD,KAAK,QAAQ;gBACX,SAAS,GAAG,MAAM,gBAAgB,CAAC,sBAAsB,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;gBAC7F,MAAM;YACR,KAAK,SAAS;gBACZ,SAAS,GAAG,MAAM,gBAAgB,CAAC,uBAAuB,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;gBAC9F,MAAM;QACV,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,QAAQ;wBACR,YAAY;wBACZ,uBAAuB;wBACvB,SAAS;qBACV,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,sBAAsB;IAChC,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9C,UAAU,EAAE,8BAA8B;CAC3C,CAAC,CAAC"}
+{"version":3,"file":"getTenantVariables.js","sourceRoot":"","sources":["../../src/tools/getTenantVariables.ts"],"names":[],"mappings":"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"}

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

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

package/dist/tools/getVariables.js

@@ -3,18 +3,21 @@ import { z } from "zod";
 import {} from "@modelcontextprotocol/sdk/server/mcp.js";
 import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
 import { registerToolDefinition } from "../types/toolConfig.js";
+import { READ_ONLY_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
 export function registerGetVariablesTool(server) {
-    server.tool("get_variables", `This tool gets all project and library variable set variables for a given project. 
-        Projects can contain variables (specific to a project), library variable sets (shared collections of variables associated with many projects), 
+    server.registerTool("get_variables", {
+        title: "Get variables for a Project from Octopus Deploy",
+        description: `This tool gets all project and library variable set variables for a given project.
+        Projects can contain variables (specific to a project), library variable sets (shared collections of variables associated with many projects),
         and tenant variables (variables related to a tenants connected to the project)
         If you want to retrieve tenant variables for a tenant connected to the project, use the get_tenant_variables tool.
-        `, {
-        spaceName: z.string().describe("The space name"),
-        projectId: z.string().describe("The ID of the project to retrieve the variables for"),
-        gitRef: z.string().describe("The gitRef to retrieve the variables from, if the project is a config-as-code project").optional(),
-    }, {
-        title: "Get variables for a Project from Octopus Deploy",
-        readOnlyHint: true,
+        `,
+        inputSchema: {
+            spaceName: z.string().describe("The space name"),
+            projectId: z.string().describe("The ID of the project to retrieve the variables for"),
+            gitRef: z.string().describe("The gitRef to retrieve the variables from, if the project is a config-as-code project").optional(),
+        },
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
     }, async ({ spaceName, projectId, gitRef }) => {
         const configuration = getClientConfigurationFromEnvironment();
         const client = await Client.create(configuration);

package/dist/tools/getVariables.js.map

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

package/dist/tools/grepLlmsTxt.d.ts

@@ -0,0 +1,13 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type GrepMatch } from "../helpers/grepLines.js";
+export interface GrepLlmsTxtResult {
+    pattern: string;
+    totalLines: number;
+    totalMatches: number;
+    returnedMatches: number;
+    truncated: boolean;
+    matches: GrepMatch[];
+    catalogResourceUri: string;
+}
+export declare function registerGrepLlmsTxtTool(server: McpServer): void;
+//# sourceMappingURL=grepLlmsTxt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grepLlmsTxt.d.ts","sourceRoot":"","sources":["../../src/tools/grepLlmsTxt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAsDD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QA0DxD"}

package/dist/tools/grepLlmsTxt.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { READ_ONLY_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
+import { grepLines, MAX_CONTEXT, MAX_COUNT_HARD_CAP, } from "../helpers/grepLines.js";
+import { fetchLlmsTxt } from "../resources/catalog/llmsTxt.js";
+const inputSchema = {
+    pattern: z
+        .string()
+        .min(1)
+        .describe("Regex (default) or literal substring (when fixedString=true). Tested against each line of llms.txt independently — same model as `grep`."),
+    caseInsensitive: z
+        .boolean()
+        .default(false)
+        .describe("Equivalent to grep -i. Default false."),
+    invertMatch: z
+        .boolean()
+        .default(false)
+        .describe("Equivalent to grep -v: return lines that do NOT match. Default false."),
+    fixedString: z
+        .boolean()
+        .default(false)
+        .describe("Equivalent to grep -F: treat pattern as a literal substring, not a regex. Use this when grepping for text containing regex metacharacters. Default false."),
+    beforeContext: z
+        .number()
+        .int()
+        .min(0)
+        .max(MAX_CONTEXT)
+        .default(0)
+        .describe(`Equivalent to grep -B: lines of preceding context to include with each match. Capped at ${MAX_CONTEXT}.`),
+    afterContext: z
+        .number()
+        .int()
+        .min(0)
+        .max(MAX_CONTEXT)
+        .default(0)
+        .describe(`Equivalent to grep -A: lines of trailing context to include with each match. Capped at ${MAX_CONTEXT}.`),
+    maxCount: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_COUNT_HARD_CAP)
+        .default(100)
+        .describe(`Equivalent to grep -m: stop returning matches after this many. totalMatches in the response still reflects the true count across the whole file. Hard cap ${MAX_COUNT_HARD_CAP}.`),
+};
+export function registerGrepLlmsTxtTool(server) {
+    server.registerTool("grep_llms_txt", {
+        title: "Grep the Octopus API catalog (llms.txt)",
+        description: `Search the Octopus API catalog at octopus://api/llms.txt with grep-style semantics. The catalog is large (~300+ KB) — call this rather than reading the resource body directly.
+
+llms.txt is structured as:
+- Authentication and Space Selection sections (top of file)
+- Endpoints section: one '### {Category}' heading per resource family (Accounts, ActionTemplates, Channels, Releases, …) and one bullet per endpoint of the form
+    \`- \\\`METHOD /path\\\` - description | Prefixes (pick one): /{spaceId}, /spaces/{spaceIdentifier} | ?queryParams → ReturnType\`
+- Steps section: deployment step types (Octopus.* ActionType) and their configurable property keys.
+
+Useful patterns:
+- 'POST /releases'   — find write endpoints under a resource family
+- 'DELETE '          — enumerate delete endpoints
+- '### Channels'     — jump to a section heading
+- 'Body: Create.*Command' — find endpoints that take a Create command body
+
+Parameter conventions mirror GNU grep:
+- pattern (regex by default; set fixedString:true for literal text)
+- caseInsensitive   (-i)
+- invertMatch       (-v)
+- fixedString       (-F)
+- beforeContext     (-B)
+- afterContext      (-A)
+- maxCount          (-m)
+
+Response: totalMatches (true count across the whole file), totalLines, the matched lines with 1-indexed lineNumber, optional before/after context arrays, and catalogResourceUri for the structured fall-through.`,
+        inputSchema,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
+    }, async (args) => {
+        const params = args;
+        const body = await fetchLlmsTxt();
+        const { totalLines, totalMatches, matches } = grepLines(body, params);
+        const result = {
+            pattern: params.pattern,
+            totalLines,
+            totalMatches,
+            returnedMatches: matches.length,
+            truncated: totalMatches > matches.length,
+            matches,
+            catalogResourceUri: "octopus://api/llms.txt",
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "grep_llms_txt",
+    config: { toolset: "core", readOnly: true },
+    registerFn: registerGrepLlmsTxtTool,
+    // The /api/experimental/llms.txt endpoint shipped in Octopus 2026.2.3916.
+    minimumOctopusVersion: "2026.2.3916",
+});
+//# sourceMappingURL=grepLlmsTxt.js.map

package/dist/tools/grepLlmsTxt.js.map

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

package/dist/tools/grepTaskLog.d.ts

@@ -0,0 +1,30 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type GrepMatch } from "../helpers/grepLines.js";
+export interface GrepTaskLogParams {
+    spaceName: string;
+    taskId: string;
+    pattern: string;
+    caseInsensitive?: boolean;
+    invertMatch?: boolean;
+    fixedString?: boolean;
+    beforeContext?: number;
+    afterContext?: number;
+    maxCount?: number;
+}
+export interface GrepTaskLogResult {
+    spaceName: string;
+    taskId: string;
+    pattern: string;
+    totalLines: number;
+    totalMatches: number;
+    returnedMatches: number;
+    truncated: boolean;
+    matches: GrepMatch[];
+    /**
+     * URI for the structured ActivityLogs tree if the agent needs more than
+     * grep can express (e.g. step hierarchy, category filtering, timing).
+     */
+    taskDetailsResourceUri: string;
+}
+export declare function registerGrepTaskLogTool(server: McpServer): void;
+//# sourceMappingURL=grepTaskLog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grepTaskLog.d.ts","sourceRoot":"","sources":["../../src/tools/grepTaskLog.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB;;;OAGG;IACH,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAkDD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAsExD"}

package/dist/tools/grepTaskLog.js

@@ -0,0 +1,116 @@
+import { Client, SpaceServerTaskRepository } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { READ_ONLY_TOOL_ANNOTATIONS } from "../types/toolAnnotations.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { validateEntityId, handleOctopusApiError, ENTITY_PREFIXES, } from "../helpers/errorHandling.js";
+import { grepLines, MAX_CONTEXT, MAX_COUNT_HARD_CAP, } from "../helpers/grepLines.js";
+const inputSchema = {
+    spaceName: z
+        .string()
+        .describe("Octopus space name. Case-sensitive."),
+    taskId: z
+        .string()
+        .describe("ServerTasks-XXXX ID. Use find_releases or list_deployments to discover task IDs from their parent entities."),
+    pattern: z
+        .string()
+        .min(1)
+        .describe("Regex (default) or literal substring (when fixedString=true). Anchors and groups behave as in JavaScript RegExp. Tested against each log line independently — the same model as `grep`."),
+    caseInsensitive: z
+        .boolean()
+        .default(false)
+        .describe("Equivalent to grep -i. Default false."),
+    invertMatch: z
+        .boolean()
+        .default(false)
+        .describe("Equivalent to grep -v: return lines that do NOT match. Default false."),
+    fixedString: z
+        .boolean()
+        .default(false)
+        .describe("Equivalent to grep -F: treat pattern as a literal substring, not a regex. Use this when grepping for text containing regex metacharacters. Default false."),
+    beforeContext: z
+        .number()
+        .int()
+        .min(0)
+        .max(MAX_CONTEXT)
+        .default(0)
+        .describe(`Equivalent to grep -B: lines of preceding context to include with each match. Capped at ${MAX_CONTEXT}.`),
+    afterContext: z
+        .number()
+        .int()
+        .min(0)
+        .max(MAX_CONTEXT)
+        .default(0)
+        .describe(`Equivalent to grep -A: lines of trailing context to include with each match. Capped at ${MAX_CONTEXT}.`),
+    maxCount: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_COUNT_HARD_CAP)
+        .default(100)
+        .describe(`Equivalent to grep -m: stop returning matches after this many. totalMatches in the response still reflects the true count across the whole log. Hard cap ${MAX_COUNT_HARD_CAP}.`),
+};
+export function registerGrepTaskLogTool(server) {
+    server.registerTool("grep_task_log", {
+        title: "Grep an Octopus task activity log",
+        description: `Search a server task's activity log with grep-style semantics. Returns only matching lines (with optional symmetric context windows). This is the canonical way to inspect task logs — there is no full-log resource URI, because exposing one would tempt callers to inhale multi-megabyte bodies when grep is almost always the better primitive.
+
+Use this when you know what to look for (a specific error string, a step name, a pattern). For structured access to the activity tree (step hierarchy, categories, timing) use the octopus://spaces/{spaceName}/tasks/{taskId}/details resource instead.
+
+Parameter conventions mirror GNU grep so the schema is self-explanatory:
+- pattern (regex by default; set fixedString:true for literal text)
+- caseInsensitive   (-i)
+- invertMatch       (-v)
+- fixedString       (-F)
+- beforeContext     (-B)
+- afterContext      (-A)
+- maxCount          (-m)
+
+Response includes totalMatches (true count across the whole log), totalLines, the matched lines with 1-indexed lineNumber, optional before/after context arrays, and a taskDetailsResourceUri for the structured fall-through.`,
+        inputSchema,
+        annotations: READ_ONLY_TOOL_ANNOTATIONS,
+    }, async (args) => {
+        const params = args;
+        const { spaceName, taskId } = params;
+        validateEntityId(taskId, "task", ENTITY_PREFIXES.task);
+        try {
+            const client = await Client.create(getClientConfigurationFromEnvironment());
+            const rawLog = await new SpaceServerTaskRepository(client, spaceName).getRaw(taskId);
+            const { totalLines, totalMatches, matches } = grepLines(rawLog, params);
+            const result = {
+                spaceName,
+                taskId,
+                pattern: params.pattern,
+                totalLines,
+                totalMatches,
+                returnedMatches: matches.length,
+                truncated: totalMatches > matches.length,
+                matches,
+                taskDetailsResourceUri: `octopus://spaces/${encodeURIComponent(spaceName)}/tasks/${encodeURIComponent(taskId)}/details`,
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "task",
+                entityId: taskId,
+                spaceName,
+                helpText: "Use find_releases or list_deployments to discover task IDs via their parent entity. Use get_task_from_url to resolve a task ID from an Octopus portal URL.",
+            });
+        }
+    });
+}
+registerToolDefinition({
+    toolName: "grep_task_log",
+    config: { toolset: "tasks", readOnly: true },
+    registerFn: registerGrepTaskLogTool,
+});
+//# sourceMappingURL=grepTaskLog.js.map

package/dist/tools/grepTaskLog.js.map

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

package/dist/tools/index.d.ts

@@ -4,26 +4,30 @@ import "./listSpaces.js";
 import "./listProjects.js";
 import "./listEnvironments.js";
 import "./listDeployments.js";
-import "./getReleaseById.js";
-import "./listReleases.js";
-import "./listReleasesForProject.js";
-import "./getTaskById.js";
-import "./getTaskDetails.js";
-import "./getTaskRaw.js";
-import "./listTenants.js";
-import "./getTenantById.js";
 import "./getTenantVariables.js";
 import "./getMissingTenantVariables.js";
 import "./getKubernetesLiveStatus.js";
-import "./listDeploymentTargets.js";
-import './getDeploymentTarget.js';
-import './getDeploymentProcess.js';
-import './getBranches.js';
-import './getCurrentUser.js';
-import './listCertificates.js';
-import './getCertificate.js';
-import './listAccounts.js';
-import './getAccount.js';
-import './getVariables.js';
+import "./getDeploymentProcess.js";
+import "./getBranches.js";
+import "./getCurrentUser.js";
+import "./getVariables.js";
+import "./getTaskFromUrl.js";
+import "./getDeploymentFromUrl.js";
+import "./findReleases.js";
+import "./findRunbooks.js";
+import "./findTenants.js";
+import "./findDeploymentTargets.js";
+import "./findCertificates.js";
+import "./findAccounts.js";
+import "./findInterruptions.js";
+import "./findFeatureToggles.js";
+import "./updateFeatureToggle.js";
+import "./createRelease.js";
+import "./deployRelease.js";
+import "./runRunbook.js";
+import "./grepTaskLog.js";
+import "./grepLlmsTxt.js";
+import "./execute.js";
+import "./readResource.js";
 export declare function registerTools(server: McpServer, config?: ToolsetConfig): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,iBAAiB,CAAC;AACzB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,6BAA6B,CAAC;AACrC,OAAO,kBAAkB,CAAC;AAC1B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,iBAAiB,CAAC;AACzB,OAAO,kBAAkB,CAAC;AAC1B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,yBAAyB,CAAC;AACjC,OAAO,gCAAgC,CAAC;AACxC,OAAO,8BAA8B,CAAC;AACtC,OAAO,4BAA4B,CAAC;AACpC,OAAO,0BAA0B,CAAC;AAClC,OAAO,2BAA2B,CAAC;AACnC,OAAO,kBAAkB,CAAC;AAC1B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,iBAAiB,CAAC;AACzB,OAAO,mBAAmB,CAAC;AAwB3B,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,GAAE,aAAkB,QAO1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,iBAAiB,CAAC;AACzB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,yBAAyB,CAAC;AACjC,OAAO,gCAAgC,CAAC;AACxC,OAAO,8BAA8B,CAAC;AACtC,OAAO,2BAA2B,CAAC;AACnC,OAAO,kBAAkB,CAAC;AAC1B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,2BAA2B,CAAC;AAGnC,OAAO,mBAAmB,CAAC;AAC3B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,4BAA4B,CAAC;AACpC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,wBAAwB,CAAC;AAGhC,OAAO,yBAAyB,CAAC;AACjC,OAAO,0BAA0B,CAAC;AAGlC,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,iBAAiB,CAAC;AAGzB,OAAO,kBAAkB,CAAC;AAG1B,OAAO,kBAAkB,CAAC;AAG1B,OAAO,cAAc,CAAC;AAGtB,OAAO,mBAAmB,CAAC;AA8B3B,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,GAAE,aAAkB,QAO1E"}

package/dist/tools/index.js

@@ -1,31 +1,42 @@
 import {} from "@modelcontextprotocol/sdk/server/mcp.js";
-import { TOOL_REGISTRY, DEFAULT_TOOLSETS } from "../types/toolConfig.js";
+import { TOOL_REGISTRY, DEFAULT_TOOLSETS, } from "../types/toolConfig.js";
 // Import all tool files to trigger their self-registration
 import "./listSpaces.js";
 import "./listProjects.js";
 import "./listEnvironments.js";
 import "./listDeployments.js";
-import "./getReleaseById.js";
-import "./listReleases.js";
-import "./listReleasesForProject.js";
-import "./getTaskById.js";
-import "./getTaskDetails.js";
-import "./getTaskRaw.js";
-import "./listTenants.js";
-import "./getTenantById.js";
 import "./getTenantVariables.js";
 import "./getMissingTenantVariables.js";
 import "./getKubernetesLiveStatus.js";
-import "./listDeploymentTargets.js";
-import './getDeploymentTarget.js';
-import './getDeploymentProcess.js';
-import './getBranches.js';
-import './getCurrentUser.js';
-import './listCertificates.js';
-import './getCertificate.js';
-import './listAccounts.js';
-import './getAccount.js';
-import './getVariables.js';
+import "./getDeploymentProcess.js";
+import "./getBranches.js";
+import "./getCurrentUser.js";
+import "./getVariables.js";
+import "./getTaskFromUrl.js";
+import "./getDeploymentFromUrl.js";
+// Unified Find endpoints (replacing separate list/get pairs)
+import "./findReleases.js";
+import "./findRunbooks.js";
+import "./findTenants.js";
+import "./findDeploymentTargets.js";
+import "./findCertificates.js";
+import "./findAccounts.js";
+import "./findInterruptions.js";
+// Feature toggles
+import "./findFeatureToggles.js";
+import "./updateFeatureToggle.js";
+// Write operations
+import "./createRelease.js";
+import "./deployRelease.js";
+import "./runRunbook.js";
+// Task log search
+import "./grepTaskLog.js";
+// API catalog search (llms.txt)
+import "./grepLlmsTxt.js";
+// REST backstop with hard read/write/delete gating
+import "./execute.js";
+// Resource backstop for clients without native MCP resource support
+import "./readResource.js";
 function isToolEnabled(toolRegistration, config) {
     if (!toolRegistration) {
         return false;
@@ -33,8 +44,9 @@ function isToolEnabled(toolRegistration, config) {
     // Check if toolset is enabled
     const enabledToolsets = config.enabledToolsets === "all"
         ? DEFAULT_TOOLSETS
-        : (config.enabledToolsets || DEFAULT_TOOLSETS);
-    if (toolRegistration.config.toolset !== "core" && !enabledToolsets.includes(toolRegistration.config.toolset)) {
+        : config.enabledToolsets || DEFAULT_TOOLSETS;
+    if (toolRegistration.config.toolset !== "core" &&
+        !enabledToolsets.includes(toolRegistration.config.toolset)) {
         return false;
     }
     // Check read-only mode

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAEL,aAAa,EACb,gBAAgB,EAEjB,MAAM,wBAAwB,CAAC;AAEhC,2DAA2D;AAC3D,OAAO,iBAAiB,CAAC;AACzB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,6BAA6B,CAAC;AACrC,OAAO,kBAAkB,CAAC;AAC1B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,iBAAiB,CAAC;AACzB,OAAO,kBAAkB,CAAC;AAC1B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,yBAAyB,CAAC;AACjC,OAAO,gCAAgC,CAAC;AACxC,OAAO,8BAA8B,CAAC;AACtC,OAAO,4BAA4B,CAAC;AACpC,OAAO,0BAA0B,CAAC;AAClC,OAAO,2BAA2B,CAAC;AACnC,OAAO,kBAAkB,CAAC;AAC1B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,iBAAiB,CAAC;AACzB,OAAO,mBAAmB,CAAC;AAE3B,SAAS,aAAa,CAAC,gBAAkC,EAAE,MAAqB;IAC9E,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8BAA8B;IAC9B,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,KAAK,KAAK;QACtD,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,IAAI,gBAAgB,CAAC,CAAC;IAEjD,IAAI,gBAAgB,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7G,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uBAAuB;IACvB,IAAI,MAAM,CAAC,YAAY,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,SAAwB,EAAE;IACzE,2EAA2E;IAC3E,KAAK,MAAM,CAAC,EAAE,gBAAgB,CAAC,IAAI,aAAa,EAAE,CAAC;QACjD,IAAI,aAAa,CAAC,gBAAgB,EAAE,MAAM,CAAC,EAAE,CAAC;YAC5C,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAEL,aAAa,EACb,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC;AAEhC,2DAA2D;AAC3D,OAAO,iBAAiB,CAAC;AACzB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,yBAAyB,CAAC;AACjC,OAAO,gCAAgC,CAAC;AACxC,OAAO,8BAA8B,CAAC;AACtC,OAAO,2BAA2B,CAAC;AACnC,OAAO,kBAAkB,CAAC;AAC1B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,2BAA2B,CAAC;AAEnC,6DAA6D;AAC7D,OAAO,mBAAmB,CAAC;AAC3B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,4BAA4B,CAAC;AACpC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,wBAAwB,CAAC;AAEhC,kBAAkB;AAClB,OAAO,yBAAyB,CAAC;AACjC,OAAO,0BAA0B,CAAC;AAElC,mBAAmB;AACnB,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,iBAAiB,CAAC;AAEzB,kBAAkB;AAClB,OAAO,kBAAkB,CAAC;AAE1B,gCAAgC;AAChC,OAAO,kBAAkB,CAAC;AAE1B,mDAAmD;AACnD,OAAO,cAAc,CAAC;AAEtB,oEAAoE;AACpE,OAAO,mBAAmB,CAAC;AAC3B,SAAS,aAAa,CACpB,gBAAkC,EAClC,MAAqB;IAErB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8BAA8B;IAC9B,MAAM,eAAe,GACnB,MAAM,CAAC,eAAe,KAAK,KAAK;QAC9B,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,MAAM,CAAC,eAAe,IAAI,gBAAgB,CAAC;IAEjD,IACE,gBAAgB,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM;QAC1C,CAAC,eAAe,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,EAC1D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uBAAuB;IACvB,IAAI,MAAM,CAAC,YAAY,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,SAAwB,EAAE;IACzE,2EAA2E;IAC3E,KAAK,MAAM,CAAC,EAAE,gBAAgB,CAAC,IAAI,aAAa,EAAE,CAAC;QACjD,IAAI,aAAa,CAAC,gBAAgB,EAAE,MAAM,CAAC,EAAE,CAAC;YAC5C,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC"}