zephyr-scale-mcp-server 0.4.7 → 0.5.0

package/build/tool-handlers.js

@@ -808,9 +808,9 @@ export class ZephyrToolHandlers {
         }
     }
     async searchTestRuns(args) {
-        const { project_key, folder, max_results = 200, fields } = args;
-        if (!project_key && !folder) {
-            throw new McpError(ErrorCode.InvalidParams, 'At least one of project_key or folder must be provided.');
+        const { project_key, folder, folder_id, max_results = 200, fields } = args;
+        if (!project_key && !folder && !folder_id) {
+            throw new McpError(ErrorCode.InvalidParams, 'At least one of project_key, folder, or folder_id must be provided.');
         }
         if (this.jiraConfig.type === 'cloud') {
             try {
@@ -818,7 +818,11 @@ export class ZephyrToolHandlers {
                 const params = { maxResults: max_results };
                 if (project_key)
                     params.projectKey = project_key;
-                if (folder && project_key) {
+                // folder_id takes precedence over folder path
+                if (folder_id) {
+                    params.folderId = folder_id;
+                }
+                else if (folder && project_key) {
                     const folderId = await resolveFolderIdByPath(this.axiosInstance, project_key, folder, 'TEST_CYCLE');
                     if (folderId !== null)
                         params.folderId = folderId;

package/build/tool-schemas.js

@@ -351,7 +351,7 @@ export const toolSchemas = [
     },
     {
         name: 'search_test_runs',
-        description: 'Search for test runs using a query. Supports filtering by projectKey and/or folder path.',
+        description: 'Search for test runs using a query. Supports filtering by projectKey and/or folder path. On Cloud, only returns cycles in the exact folder (not sub-folders). Use folder_id for direct numeric ID lookup (skips path resolution).',
         inputSchema: {
             type: 'object',
             properties: {
@@ -361,7 +361,11 @@ export const toolSchemas = [
                 },
                 folder: {
                     type: 'string',
-                    description: 'Folder path to filter test runs by (e.g., "/MyFolder/SubFolder")',
+                    description: 'Folder path to filter test runs by (e.g., "/MyFolder/SubFolder"). Resolved to a numeric folderId on Cloud.',
+                },
+                folder_id: {
+                    type: 'number',
+                    description: 'Numeric folder ID to filter test runs by (optional). If provided, takes precedence over folder path and skips path resolution. Use this when you already know the folder ID.',
                 },
                 max_results: {
                     type: 'number',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zephyr-scale-mcp-server",
-  "version": "0.4.7",
+  "version": "0.5.0",
   "description": "Model Context Protocol (MCP) server for Zephyr Scale test case management with comprehensive STEP_BY_STEP, PLAIN_TEXT, and BDD support",
   "type": "module",
   "main": "./build/index.js",

package/src/tool-handlers.ts

@@ -879,10 +879,10 @@ export class ZephyrToolHandlers {
   }
 
   async searchTestRuns(args: SearchTestRunsArgs) {
-    const { project_key, folder, max_results = 200, fields } = args;
+    const { project_key, folder, folder_id, max_results = 200, fields } = args;
 
-    if (!project_key && !folder) {
-      throw new McpError(ErrorCode.InvalidParams, 'At least one of project_key or folder must be provided.');
+    if (!project_key && !folder && !folder_id) {
+      throw new McpError(ErrorCode.InvalidParams, 'At least one of project_key, folder, or folder_id must be provided.');
     }
 
     if (this.jiraConfig.type === 'cloud') {
@@ -891,7 +891,10 @@ export class ZephyrToolHandlers {
         const params: Record<string, any> = { maxResults: max_results };
         if (project_key) params.projectKey = project_key;
 
-        if (folder && project_key) {
+        // folder_id takes precedence over folder path
+        if (folder_id) {
+          params.folderId = folder_id;
+        } else if (folder && project_key) {
           const folderId = await resolveFolderIdByPath(
             this.axiosInstance, project_key, folder, 'TEST_CYCLE'
           );

package/src/tool-schemas.ts

@@ -351,7 +351,7 @@ export const toolSchemas = [
   },
   {
     name: 'search_test_runs',
-    description: 'Search for test runs using a query. Supports filtering by projectKey and/or folder path.',
+    description: 'Search for test runs using a query. Supports filtering by projectKey and/or folder path. On Cloud, only returns cycles in the exact folder (not sub-folders). Use folder_id for direct numeric ID lookup (skips path resolution).',
     inputSchema: {
       type: 'object',
       properties: {
@@ -361,7 +361,11 @@ export const toolSchemas = [
         },
         folder: {
           type: 'string',
-          description: 'Folder path to filter test runs by (e.g., "/MyFolder/SubFolder")',
+          description: 'Folder path to filter test runs by (e.g., "/MyFolder/SubFolder"). Resolved to a numeric folderId on Cloud.',
+        },
+        folder_id: {
+          type: 'number',
+          description: 'Numeric folder ID to filter test runs by (optional). If provided, takes precedence over folder path and skips path resolution. Use this when you already know the folder ID.',
         },
         max_results: {
           type: 'number',

package/src/types.ts

@@ -91,6 +91,7 @@ export interface GetTestExecutionArgs {
 export interface SearchTestRunsArgs {
   project_key?: string;
   folder?: string;
+  folder_id?: number;
   max_results?: number;
   fields?: string;
 }