@testkase/mcp-server 2.0.3 → 2.0.7

package/build/index.js

@@ -8,6 +8,61 @@ const config = {
     apiBaseUrl: process.env.TESTKASE_API_BASE_URL || "https://apiqa.testkase.com",
     patToken: process.env.TESTKASE_PAT_TOKEN,
 };
+// Cached organization data (fetched once from PAT token)
+let cachedOrganizationId = null;
+// Cached project ID (set when user works on a project)
+let cachedProjectId = null;
+// Helper to get organization ID (fetches and caches on first call)
+async function getOrganizationId(providedOrgId) {
+    // If explicitly provided, use it
+    if (providedOrgId) {
+        return providedOrgId;
+    }
+    // If cached, return cached value
+    if (cachedOrganizationId !== null) {
+        return cachedOrganizationId;
+    }
+    // Fetch from API using PAT token
+    validateAuth();
+    try {
+        const response = await axios.get(`${config.apiBaseUrl}/api/v1/organizations/my-organization`, {
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${config.patToken}`,
+            },
+        });
+        const orgData = response.data?.data || response.data;
+        if (orgData?.organization_id) {
+            const orgId = orgData.organization_id;
+            cachedOrganizationId = orgId;
+            return orgId;
+        }
+        throw new Error("Could not determine organization from PAT token");
+    }
+    catch (error) {
+        throw new Error("Failed to fetch organization. Please provide organizationId or check your PAT token.");
+    }
+}
+// Helper to get project ID (uses cached value if available)
+function getProjectId(providedProjectId) {
+    // If explicitly provided, cache it and use it
+    if (providedProjectId) {
+        cachedProjectId = providedProjectId;
+        return providedProjectId;
+    }
+    // If cached, return cached value
+    if (cachedProjectId !== null) {
+        return cachedProjectId;
+    }
+    throw new Error("No active project set. You MUST first: 1) Call get_my_projects to list projects, " +
+        "2) ASK the user which project they want to work with, " +
+        "3) Call set_active_project with the user's chosen project ID. " +
+        "Do NOT select a project automatically.");
+}
+// Helper to set active project (for explicit project switching)
+function setActiveProject(projectId) {
+    cachedProjectId = projectId;
+}
 // Tool definitions
 const GET_TESTCASES_TOOL = {
     name: "get_testcases",
@@ -20,11 +75,11 @@ const GET_TESTCASES_TOOL = {
         properties: {
             projectId: {
                 type: "string",
-                description: "The unique identifier of the project (UUID format)",
+                description: "Project ID (optional if active project is set)",
             },
             organizationId: {
                 type: "number",
-                description: "The organization ID that owns the project",
+                description: "Organization ID (optional - auto-detected from PAT token)",
             },
             page: {
                 type: "number",
@@ -89,7 +144,7 @@ const GET_TESTCASES_TOOL = {
                 description: "Filter by update end date (ISO 8601 format: YYYY-MM-DD)",
             },
         },
-        required: ["projectId", "organizationId"],
+        required: [],
     },
 };
 const GET_TESTCASE_DETAIL_TOOL = {
@@ -101,7 +156,7 @@ const GET_TESTCASE_DETAIL_TOOL = {
         properties: {
             projectId: {
                 type: "string",
-                description: "The unique identifier of the project",
+                description: "Project ID (optional if active project is set)",
             },
             testcaseId: {
                 type: "string",
@@ -109,34 +164,10 @@ const GET_TESTCASE_DETAIL_TOOL = {
             },
             organizationId: {
                 type: "number",
-                description: "The organization ID that owns the project",
+                description: "Organization ID (optional - auto-detected from PAT token)",
             },
         },
-        required: ["projectId", "testcaseId", "organizationId"],
-    },
-};
-const GET_TESTCASE_HISTORY_TOOL = {
-    name: "get_testcase_history",
-    description: "Get the complete history of changes made to a testcase. " +
-        "Returns a list of all modifications with timestamps, user information, and changed fields. " +
-        "Useful for tracking testcase evolution and audit trails.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            projectId: {
-                type: "string",
-                description: "The unique identifier of the project",
-            },
-            testcaseId: {
-                type: "string",
-                description: "The unique identifier of the testcase",
-            },
-            organizationId: {
-                type: "number",
-                description: "The organization ID that owns the project",
-            },
-        },
-        required: ["projectId", "testcaseId", "organizationId"],
+        required: ["testcaseId"],
     },
 };
 const GET_FOLDERS_TOOL = {
@@ -149,18 +180,24 @@ const GET_FOLDERS_TOOL = {
         properties: {
             organizationId: {
                 type: "number",
-                description: "The organization ID",
+                description: "Organization ID (optional - auto-detected from PAT token)",
             },
             projectId: {
                 type: "string",
-                description: "The unique identifier of the project",
+                description: "Project ID (optional if active project is set)",
             },
-            folder_id: {
+            section: {
                 type: "string",
-                description: "Optional: Filter by specific folder ID",
+                enum: ["TESTCASE", "TEST_CYCLE", "TEST_PLAN", "REQUIREMENT"],
+                description: "Folder section type (default: TESTCASE)",
+                default: "TESTCASE",
+            },
+            search: {
+                type: "string",
+                description: "Optional: Search term to filter folders (min 3 characters)",
             },
         },
-        required: ["organizationId", "projectId"],
+        required: [],
     },
 };
 const GET_LABELS_TOOL = {
@@ -173,49 +210,23 @@ const GET_LABELS_TOOL = {
         properties: {
             projectId: {
                 type: "string",
-                description: "The unique identifier of the project",
+                description: "Project ID (optional if active project is set)",
             },
             organizationId: {
                 type: "number",
-                description: "The organization ID",
+                description: "Organization ID (optional - auto-detected from PAT token)",
             },
         },
-        required: ["projectId", "organizationId"],
-    },
-};
-const GET_ISSUES_TOOL = {
-    name: "get_issues",
-    description: "Get all issues/defects reported in a project. " +
-        "Returns a list of issues with their status, priority, and linked testcases. " +
-        "Useful for tracking bugs and defects found during testing.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            projectId: {
-                type: "string",
-                description: "The unique identifier of the project",
-            },
-            organizationId: {
-                type: "number",
-                description: "The organization ID",
-            },
-            page: {
-                type: "number",
-                description: "Page number for pagination (default: 1)",
-            },
-            limit: {
-                type: "number",
-                description: "Number of items per page (default: 20)",
-            },
-        },
-        required: ["projectId", "organizationId"],
+        required: [],
     },
 };
 const GET_MY_PROJECTS_TOOL = {
     name: "get_my_projects",
-    description: "Get all projects that the current user (PAT token owner) has access to across all organizations. " +
-        "Returns project details including name, ID, organization, and team members. " +
-        "Useful for discovering available projects and their basic information.",
+    description: "IMPORTANT: Call this tool FIRST before any other TestKase operation. " +
+        "Lists all projects the user has access to. " +
+        "After getting results, ALWAYS ASK the user which project they want to work with. " +
+        "Do NOT automatically select a project - let the user choose. " +
+        "Then use set_active_project with the user's chosen project ID.",
     inputSchema: {
         type: "object",
         properties: {
@@ -237,8 +248,8 @@ const CREATE_TESTCASE_TOOL = {
     inputSchema: {
         type: "object",
         properties: {
-            projectId: { type: "string", description: "Project ID" },
-            organizationId: { type: "number", description: "Organization ID" },
+            projectId: { type: "string", description: "Project ID (optional if active project is set)" },
+            organizationId: { type: "number", description: "Organization ID (optional - auto-detected from PAT token)" },
             title: { type: "string", description: "Test case title" },
             summary: { type: "string", description: "Test case summary/description" },
             priority: { type: "string", description: "Priority (low, medium, high, critical)" },
@@ -258,7 +269,7 @@ const CREATE_TESTCASE_TOOL = {
                 description: "Array of test steps"
             },
         },
-        required: ["projectId", "organizationId", "title"],
+        required: ["title"],
     },
 };
 const CREATE_BULK_TESTCASE_TOOL = {
@@ -267,11 +278,11 @@ const CREATE_BULK_TESTCASE_TOOL = {
     inputSchema: {
         type: "object",
         properties: {
-            projectId: { type: "string", description: "Project ID" },
-            organizationId: { type: "number", description: "Organization ID" },
+            projectId: { type: "string", description: "Project ID (optional if active project is set)" },
+            organizationId: { type: "number", description: "Organization ID (optional - auto-detected from PAT token)" },
             testcases: { type: "string", description: "JSON string of testcase array" },
         },
-        required: ["projectId", "organizationId", "testcases"],
+        required: ["testcases"],
     },
 };
 const UPDATE_TESTCASE_FIELD_TOOL = {
@@ -280,13 +291,13 @@ const UPDATE_TESTCASE_FIELD_TOOL = {
     inputSchema: {
         type: "object",
         properties: {
-            projectId: { type: "string", description: "Project ID" },
-            organizationId: { type: "number", description: "Organization ID" },
+            projectId: { type: "string", description: "Project ID (optional if active project is set)" },
+            organizationId: { type: "number", description: "Organization ID (optional - auto-detected from PAT token)" },
             ids: { type: "string", description: "Comma-separated testcase IDs" },
             field: { type: "string", description: "Field name to update" },
             value: { type: "string", description: "New field value" },
         },
-        required: ["projectId", "organizationId", "ids", "field", "value"],
+        required: ["ids", "field", "value"],
     },
 };
 const DELETE_TESTCASE_TOOL = {
@@ -295,116 +306,31 @@ const DELETE_TESTCASE_TOOL = {
     inputSchema: {
         type: "object",
         properties: {
-            projectId: { type: "string", description: "Project ID" },
-            organizationId: { type: "number", description: "Organization ID" },
+            projectId: { type: "string", description: "Project ID (optional if active project is set)" },
+            organizationId: { type: "number", description: "Organization ID (optional - auto-detected from PAT token)" },
             ids: { type: "string", description: "Comma-separated testcase IDs to delete" },
         },
-        required: ["projectId", "organizationId", "ids"],
-    },
-};
-const CLONE_TESTCASE_TOOL = {
-    name: "clone_testcase",
-    description: "Clone an existing test case with all its steps",
-    inputSchema: {
-        type: "object",
-        properties: {
-            projectId: { type: "string", description: "Project ID" },
-            id: { type: "string", description: "Test case ID to clone" },
-            organizationId: { type: "number", description: "Organization ID" },
-        },
-        required: ["projectId", "id", "organizationId"],
-    },
-};
-const CREATE_TEST_STEP_TOOL = {
-    name: "create_test_step",
-    description: "Create or update test steps for a test case",
-    inputSchema: {
-        type: "object",
-        properties: {
-            projectId: { type: "string", description: "Project ID" },
-            testcaseId: { type: "string", description: "Test case ID" },
-            organizationId: { type: "number", description: "Organization ID" },
-            steps: { type: "string", description: "JSON string of test steps array" },
-        },
-        required: ["projectId", "testcaseId", "organizationId", "steps"],
-    },
-};
-const DELETE_TEST_STEP_TOOL = {
-    name: "delete_test_step",
-    description: "Delete test steps from a test case",
-    inputSchema: {
-        type: "object",
-        properties: {
-            testcaseId: { type: "string", description: "Test case ID" },
-            organizationId: { type: "number", description: "Organization ID" },
-            stepIds: { type: "string", description: "Comma-separated step IDs to delete" },
-        },
-        required: ["testcaseId", "organizationId", "stepIds"],
-    },
-};
-const DOWNLOAD_TESTCASES_TOOL = {
-    name: "download_testcases",
-    description: "Download test cases as CSV file (returns download URL or data)",
-    inputSchema: {
-        type: "object",
-        properties: {
-            projectId: { type: "string", description: "Project ID" },
-            organizationId: { type: "number", description: "Organization ID" },
-            filters: { type: "string", description: "Optional filters as JSON string" },
-        },
-        required: ["projectId", "organizationId"],
-    },
-};
-const IMPORT_TESTCASES_TOOL = {
-    name: "import_testcases",
-    description: "Import test cases from a CSV file",
-    inputSchema: {
-        type: "object",
-        properties: {
-            projectId: { type: "string", description: "Project ID" },
-            organizationId: { type: "number", description: "Organization ID" },
-            file: { type: "string", description: "File data or path" },
-        },
-        required: ["projectId", "organizationId", "file"],
+        required: ["ids"],
     },
 };
 const CREATE_FOLDER_TOOL = {
     name: "create_folder",
-    description: "Create a new folder in a project",
-    inputSchema: {
-        type: "object",
-        properties: {
-            organizationId: { type: "number", description: "Organization ID" },
-            projectId: { type: "string", description: "Project ID" },
-            folder_name: { type: "string", description: "Name of the new folder" },
-            parent_folder_id: { type: "string", description: "Parent folder ID (optional)" },
-        },
-        required: ["organizationId", "projectId", "folder_name"],
-    },
-};
-const DELETE_FOLDER_TOOL = {
-    name: "delete_folder",
-    description: "Delete a folder and its subfolders",
+    description: "Create a new folder in a project for testcases",
     inputSchema: {
         type: "object",
         properties: {
-            id: { type: "string", description: "Folder ID to delete" },
-            organizationId: { type: "number", description: "Organization ID" },
-        },
-        required: ["id", "organizationId"],
-    },
-};
-const UPDATE_FOLDER_TOOL = {
-    name: "update_folder",
-    description: "Rename or update folder details",
-    inputSchema: {
-        type: "object",
-        properties: {
-            id: { type: "string", description: "Folder ID" },
-            organizationId: { type: "number", description: "Organization ID" },
-            folder_name: { type: "string", description: "New folder name" },
+            organizationId: { type: "number", description: "Organization ID (optional - auto-detected from PAT token)" },
+            projectId: { type: "string", description: "Project ID (optional if active project is set)" },
+            section: {
+                type: "string",
+                enum: ["TESTCASE", "TEST_CYCLE", "TEST_PLAN", "REQUIREMENT"],
+                description: "Folder section type (default: TESTCASE)",
+                default: "TESTCASE",
+            },
+            name: { type: "string", description: "Name of the new folder (max 50 characters)" },
+            parentId: { type: "number", description: "Parent folder ID for creating subfolder (optional)" },
         },
-        required: ["id", "organizationId", "folder_name"],
+        required: ["name"],
     },
 };
 const CREATE_LABEL_TOOL = {
@@ -413,11 +339,11 @@ const CREATE_LABEL_TOOL = {
     inputSchema: {
         type: "object",
         properties: {
-            projectId: { type: "string", description: "Project ID" },
-            organizationId: { type: "number", description: "Organization ID" },
+            projectId: { type: "string", description: "Project ID (optional if active project is set)" },
+            organizationId: { type: "number", description: "Organization ID (optional - auto-detected from PAT token)" },
             values: { type: "array", items: { type: "string" }, description: "Array of label names" },
         },
-        required: ["projectId", "organizationId", "values"],
+        required: ["values"],
     },
 };
 const GET_USER_PROFILE_TOOL = {
@@ -429,87 +355,29 @@ const GET_USER_PROFILE_TOOL = {
         required: [],
     },
 };
-const GET_ORGANIZATION_TOOL = {
-    name: "get_organization",
-    description: "Get current user organization details",
-    inputSchema: {
-        type: "object",
-        properties: {},
-        required: [],
-    },
-};
-const GET_MAPPED_ISSUES_TOOL = {
-    name: "get_mapped_issues",
-    description: "Get mapped issues for a specific test case from integration platforms",
-    inputSchema: {
-        type: "object",
-        properties: {
-            organization_id: { type: "number", description: "Organization ID" },
-            project_id: { type: "string", description: "Project ID" },
-            integration_type: { type: "string", description: "Integration type (requirement/defect)" },
-            testcase_id: { type: "string", description: "Test case ID" },
-        },
-        required: ["organization_id", "project_id", "integration_type", "testcase_id"],
-    },
-};
-const SEARCH_ISSUES_TOOL = {
-    name: "search_issues",
-    description: "Search issues from integrated platform (Jira, GitHub, GitLab)",
-    inputSchema: {
-        type: "object",
-        properties: {
-            project_id: { type: "string", description: "Project ID" },
-            integration_type: { type: "string", description: "Integration type (requirement/defect)" },
-            search: { type: "string", description: "Search query string" },
-            page: { type: "number", description: "Page number" },
-            limit: { type: "number", description: "Items per page" },
-        },
-        required: ["project_id", "integration_type"],
-    },
-};
-const MAP_ISSUES_TOOL = {
-    name: "map_issues",
-    description: "Map integration issues to a TestKase requirement/defect",
-    inputSchema: {
-        type: "object",
-        properties: {
-            organization_id: { type: "number", description: "Organization ID" },
-            project_id: { type: "string", description: "Project ID" },
-            testcase_id: { type: "string", description: "Test case ID" },
-            integration_type: { type: "string", description: "Integration type (requirement/defect)" },
-            issues: { type: "string", description: "JSON string of issue IDs to map" },
-        },
-        required: ["organization_id", "project_id", "testcase_id", "integration_type", "issues"],
-    },
-};
-const GENERATE_TESTCASES_TOOL = {
-    name: "generate_testcases",
-    description: "Generate test cases using AI from requirement text",
+const SET_ACTIVE_PROJECT_TOOL = {
+    name: "set_active_project",
+    description: "Set the active project AFTER the user has chosen one from get_my_projects results. " +
+        "NEVER call this without first asking the user which project they want. " +
+        "Once set, other tools will use this project automatically.",
     inputSchema: {
         type: "object",
         properties: {
-            project_id: { type: "string", description: "Project ID" },
-            requirement: { type: "string", description: "Requirement text" },
-            issue_id: { type: "string", description: "Issue ID (optional)" },
-            selected_fields: { type: "string", description: "Comma-separated field names" },
+            projectId: {
+                type: "string",
+                description: "The project ID to set as active (e.g., PRJ-1234)",
+            },
         },
-        required: ["project_id"],
+        required: [],
     },
 };
-const CREATE_ISSUE_TOOL = {
-    name: "create_issue",
-    description: "Create or update a requirement or defect issue",
+const GET_ACTIVE_PROJECT_TOOL = {
+    name: "get_active_project",
+    description: "Get the currently active project ID that is being used for operations",
     inputSchema: {
         type: "object",
-        properties: {
-            projectId: { type: "string", description: "Project ID" },
-            organizationId: { type: "number", description: "Organization ID" },
-            type: { type: "string", description: "Issue type (REQUIREMENT or DEFECT)" },
-            title: { type: "string", description: "Issue title" },
-            description: { type: "string", description: "Issue description" },
-            id: { type: "string", description: "Issue ID (if updating)" },
-        },
-        required: ["projectId", "organizationId", "type", "title"],
+        properties: {},
+        required: [],
     },
 };
 // Create server instance
@@ -521,37 +389,24 @@ const server = new Server({
         tools: {},
     },
 });
-// List available tools
+// List available tools (14 tools)
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
         tools: [
+            GET_MY_PROJECTS_TOOL,
+            SET_ACTIVE_PROJECT_TOOL,
+            GET_ACTIVE_PROJECT_TOOL,
             GET_TESTCASES_TOOL,
             GET_TESTCASE_DETAIL_TOOL,
-            GET_TESTCASE_HISTORY_TOOL,
-            GET_FOLDERS_TOOL,
-            GET_LABELS_TOOL,
-            GET_ISSUES_TOOL,
-            GET_MY_PROJECTS_TOOL,
             CREATE_TESTCASE_TOOL,
             CREATE_BULK_TESTCASE_TOOL,
             UPDATE_TESTCASE_FIELD_TOOL,
             DELETE_TESTCASE_TOOL,
-            CLONE_TESTCASE_TOOL,
-            CREATE_TEST_STEP_TOOL,
-            DELETE_TEST_STEP_TOOL,
-            DOWNLOAD_TESTCASES_TOOL,
-            IMPORT_TESTCASES_TOOL,
+            GET_FOLDERS_TOOL,
             CREATE_FOLDER_TOOL,
-            DELETE_FOLDER_TOOL,
-            UPDATE_FOLDER_TOOL,
+            GET_LABELS_TOOL,
             CREATE_LABEL_TOOL,
             GET_USER_PROFILE_TOOL,
-            GET_ORGANIZATION_TOOL,
-            GET_MAPPED_ISSUES_TOOL,
-            SEARCH_ISSUES_TOOL,
-            MAP_ISSUES_TOOL,
-            GENERATE_TESTCASES_TOOL,
-            CREATE_ISSUE_TOOL,
         ],
     };
 });
@@ -559,26 +414,20 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     try {
-        if (name === "get_testcases") {
-            return await handleGetTestcases(args);
-        }
-        else if (name === "get_testcase_detail") {
-            return await handleGetTestcaseDetail(args);
-        }
-        else if (name === "get_testcase_history") {
-            return await handleGetTestcaseHistory(args);
+        if (name === "get_my_projects") {
+            return await handleGetMyProjects(args);
         }
-        else if (name === "get_folders") {
-            return await handleGetFolders(args);
+        else if (name === "set_active_project") {
+            return await handleSetActiveProject(args);
         }
-        else if (name === "get_labels") {
-            return await handleGetLabels(args);
+        else if (name === "get_active_project") {
+            return await handleGetActiveProject();
         }
-        else if (name === "get_issues") {
-            return await handleGetIssues(args);
+        else if (name === "get_testcases") {
+            return await handleGetTestcases(args);
         }
-        else if (name === "get_my_projects") {
-            return await handleGetMyProjects(args);
+        else if (name === "get_testcase_detail") {
+            return await handleGetTestcaseDetail(args);
         }
         else if (name === "create_testcase") {
             return await handleCreateTestcase(args);
@@ -592,29 +441,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         else if (name === "delete_testcase") {
             return await handleDeleteTestcase(args);
         }
-        else if (name === "clone_testcase") {
-            return await handleCloneTestcase(args);
-        }
-        else if (name === "create_test_step") {
-            return await handleCreateTestStep(args);
-        }
-        else if (name === "delete_test_step") {
-            return await handleDeleteTestStep(args);
-        }
-        else if (name === "download_testcases") {
-            return await handleDownloadTestcases(args);
-        }
-        else if (name === "import_testcases") {
-            return await handleImportTestcases(args);
+        else if (name === "get_folders") {
+            return await handleGetFolders(args);
         }
         else if (name === "create_folder") {
             return await handleCreateFolder(args);
         }
-        else if (name === "delete_folder") {
-            return await handleDeleteFolder(args);
-        }
-        else if (name === "update_folder") {
-            return await handleUpdateFolder(args);
+        else if (name === "get_labels") {
+            return await handleGetLabels(args);
         }
         else if (name === "create_label") {
             return await handleCreateLabel(args);
@@ -622,24 +456,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         else if (name === "get_user_profile") {
             return await handleGetUserProfile(args);
         }
-        else if (name === "get_organization") {
-            return await handleGetOrganization(args);
-        }
-        else if (name === "get_mapped_issues") {
-            return await handleGetMappedIssues(args);
-        }
-        else if (name === "search_issues") {
-            return await handleSearchIssues(args);
-        }
-        else if (name === "map_issues") {
-            return await handleMapIssues(args);
-        }
-        else if (name === "generate_testcases") {
-            return await handleGenerateTestcases(args);
-        }
-        else if (name === "create_issue") {
-            return await handleCreateIssue(args);
-        }
         throw new Error(`Unknown tool: ${name}`);
     }
     catch (error) {
@@ -659,26 +475,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 });
 // Handler for get_testcases tool
 async function handleGetTestcases(args) {
-    // Validate required parameters
-    if (!args.projectId) {
-        throw new Error("projectId is required");
-    }
-    if (!args.organizationId) {
-        throw new Error("organizationId is required");
-    }
-    // Check for authentication
-    if (!config.patToken) {
-        throw new Error("Authentication required. Please set TESTKASE_PAT_TOKEN environment variable. " +
-            "Generate a Personal Access Token (PAT) from your TestKase account settings.");
-    }
-    // Validate PAT token format
-    if (!config.patToken.startsWith("xyz_")) {
-        throw new Error("Invalid PAT token format. TestKase PAT tokens must start with 'xyz_' prefix. " +
-            "Please generate a valid PAT from your TestKase account settings.");
-    }
+    validateAuth();
+    // Get project and organization IDs (from args or cached)
+    const projectId = getProjectId(args.projectId);
+    const organizationId = await getOrganizationId(args.organizationId);
     // Build query parameters
     const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
+    queryParams.append("organizationId", organizationId.toString());
     if (args.page !== undefined)
         queryParams.append("page", args.page.toString());
     if (args.limit !== undefined)
@@ -706,7 +509,7 @@ async function handleGetTestcases(args) {
     if (args.updated_end_date)
         queryParams.append("updated_end_date", args.updated_end_date);
     // Construct API URL
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/get-testcase/${args.projectId}?${queryParams.toString()}`;
+    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/get-testcase/${projectId}?${queryParams.toString()}`;
     // Prepare headers with PAT token
     // The PAT token is sent as Bearer token and will be validated by TestKase's JwtAuthGuard
     // which checks for 'xyz_' prefix and validates against the PAT database
@@ -784,9 +587,11 @@ async function handleGetTestcases(args) {
 // Handler for get_testcase_detail tool
 async function handleGetTestcaseDetail(args) {
     validateAuth();
+    const projectId = getProjectId(args.projectId);
+    const organizationId = await getOrganizationId(args.organizationId);
     const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/get-testcase-detail/${args.projectId}/${args.testcaseId}?${queryParams.toString()}`;
+    queryParams.append("organizationId", organizationId.toString());
+    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/get-testcase-detail/${projectId}/${args.testcaseId}?${queryParams.toString()}`;
     try {
         const response = await axios.get(url, {
             headers: {
@@ -801,34 +606,18 @@ async function handleGetTestcaseDetail(args) {
         throw handleApiError(error);
     }
 }
-// Handler for get_testcase_history tool
-async function handleGetTestcaseHistory(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/get-testcase-history/${args.projectId}/${args.testcaseId}?${queryParams.toString()}`;
-    try {
-        const response = await axios.get(url, {
-            headers: {
-                "Content-Type": "application/json",
-                "Authorization": `Bearer ${config.patToken}`,
-            },
-        });
-        const data = response.data;
-        return formatResponse(data, `Testcase History: ${args.testcaseId}`);
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
 // Handler for get_folders tool
 async function handleGetFolders(args) {
     validateAuth();
+    const projectId = getProjectId(args.projectId);
+    const organizationId = await getOrganizationId(args.organizationId);
+    const section = args.section || "TESTCASE";
     const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    queryParams.append("projectId", args.projectId);
-    if (args.folder_id) {
-        queryParams.append("folder_id", args.folder_id);
+    queryParams.append("organizationId", organizationId.toString());
+    queryParams.append("projectId", projectId);
+    queryParams.append("section", section);
+    if (args.search) {
+        queryParams.append("search", args.search);
     }
     const url = `${config.apiBaseUrl}/api/v1/folders/get-folders?${queryParams.toString()}`;
     try {
@@ -848,9 +637,11 @@ async function handleGetFolders(args) {
 // Handler for get_labels tool
 async function handleGetLabels(args) {
     validateAuth();
+    const projectId = getProjectId(args.projectId);
+    const organizationId = await getOrganizationId(args.organizationId);
     const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/get-testcase-detail/${args.projectId}?${queryParams.toString()}`;
+    queryParams.append("organizationId", organizationId.toString());
+    const url = `${config.apiBaseUrl}/api/v1/projects/labels/get-label/${projectId}?${queryParams.toString()}`;
     try {
         const response = await axios.get(url, {
             headers: {
@@ -865,30 +656,6 @@ async function handleGetLabels(args) {
         throw handleApiError(error);
     }
 }
-// Handler for get_issues tool
-async function handleGetIssues(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    if (args.page)
-        queryParams.append("page", args.page.toString());
-    if (args.limit)
-        queryParams.append("limit", args.limit.toString());
-    const url = `${config.apiBaseUrl}/api/v1/issues/get-issues/${args.projectId}?${queryParams.toString()}`;
-    try {
-        const response = await axios.get(url, {
-            headers: {
-                "Content-Type": "application/json",
-                "Authorization": `Bearer ${config.patToken}`,
-            },
-        });
-        const data = response.data;
-        return formatResponse(data, `Issues for Project: ${args.projectId}`);
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
 // Handler for get_my_projects tool
 async function handleGetMyProjects(args) {
     validateAuth();
@@ -912,34 +679,80 @@ async function handleGetMyProjects(args) {
         throw handleApiError(error);
     }
 }
-// Handler for create_testcase tool
+// Handler for create_testcase tool (handles test_steps internally)
 async function handleCreateTestcase(args) {
     validateAuth();
+    const projectId = getProjectId(args.projectId);
+    const organizationId = await getOrganizationId(args.organizationId);
+    // Extract test_steps before sending to API
+    const { test_steps, ...testcaseData } = args;
     const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/create-testcase/${args.projectId}?${queryParams.toString()}`;
+    queryParams.append("organizationId", organizationId.toString());
+    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/create-testcase/${projectId}?${queryParams.toString()}`;
     try {
-        const response = await axios.post(url, args, {
+        // Step 1: Create testcase
+        const response = await axios.post(url, testcaseData, {
             headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
         });
-        return formatResponse(response.data, "Testcase Created");
+        const createdTestcase = response.data?.data || response.data;
+        const testcaseId = createdTestcase?.id || createdTestcase?.testcaseId;
+        // Step 2: If test_steps provided, create them
+        if (test_steps && Array.isArray(test_steps) && test_steps.length > 0 && testcaseId) {
+            const stepsUrl = `${config.apiBaseUrl}/api/v1/projects/testcases/teststeps/${projectId}/${testcaseId}?organizationId=${organizationId}`;
+            await axios.post(stepsUrl, { steps: test_steps }, {
+                headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
+            });
+        }
+        return formatResponse(response.data, "Testcase Created" + (test_steps?.length ? ` with ${test_steps.length} test steps` : ""));
     }
     catch (error) {
         throw handleApiError(error);
     }
 }
-// Handler for create_bulk_testcase tool
+// Handler for create_bulk_testcase tool (handles test_steps internally)
 async function handleCreateBulkTestcase(args) {
     validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/create-bulk-testcase/${args.projectId}?${queryParams.toString()}`;
+    const projectId = getProjectId(args.projectId);
+    const organizationId = await getOrganizationId(args.organizationId);
     const testcases = typeof args.testcases === 'string' ? JSON.parse(args.testcases) : args.testcases;
+    // Separate test_steps from each testcase for later processing
+    const testcasesWithSteps = testcases.map((tc) => ({
+        testcase: { ...tc, test_steps: undefined },
+        test_steps: tc.test_steps
+    }));
+    const queryParams = new URLSearchParams();
+    queryParams.append("organizationId", organizationId.toString());
+    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/create-bulk-testcase/${projectId}?${queryParams.toString()}`;
     try {
-        const response = await axios.post(url, { testcases }, {
+        // Step 1: Create all testcases (without steps)
+        const cleanTestcases = testcasesWithSteps.map((t) => t.testcase);
+        const response = await axios.post(url, { testcases: cleanTestcases }, {
             headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
         });
-        return formatResponse(response.data, "Bulk Testcases Created");
+        const results = response.data?.results || [];
+        // Step 2: Create test steps for each successfully created testcase
+        let stepsCreated = 0;
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            const steps = testcasesWithSteps[i]?.test_steps;
+            if (result.status === 'success' && steps && Array.isArray(steps) && steps.length > 0) {
+                const testcaseId = result.testcaseId || result.id;
+                if (testcaseId) {
+                    try {
+                        const stepsUrl = `${config.apiBaseUrl}/api/v1/projects/testcases/teststeps/${projectId}/${testcaseId}?organizationId=${organizationId}`;
+                        await axios.post(stepsUrl, { steps }, {
+                            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
+                        });
+                        stepsCreated++;
+                    }
+                    catch (e) {
+                        // Log but don't fail the whole operation
+                        console.error(`Failed to create steps for testcase ${testcaseId}`);
+                    }
+                }
+            }
+        }
+        return formatResponse(response.data, `Bulk Testcases Created (${stepsCreated} with test steps)`);
     }
     catch (error) {
         throw handleApiError(error);
@@ -948,9 +761,11 @@ async function handleCreateBulkTestcase(args) {
 // Handler for update_testcase_field tool
 async function handleUpdateTestcaseField(args) {
     validateAuth();
+    const projectId = getProjectId(args.projectId);
+    const organizationId = await getOrganizationId(args.organizationId);
     const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/update-field/${args.projectId}?${queryParams.toString()}`;
+    queryParams.append("organizationId", organizationId.toString());
+    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/update-field/${projectId}?${queryParams.toString()}`;
     try {
         const response = await axios.patch(url, {
             ids: args.ids.split(','),
@@ -968,9 +783,11 @@ async function handleUpdateTestcaseField(args) {
 // Handler for delete_testcase tool
 async function handleDeleteTestcase(args) {
     validateAuth();
+    const projectId = getProjectId(args.projectId);
+    const organizationId = await getOrganizationId(args.organizationId);
     const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/delete-testcase/${args.projectId}?${queryParams.toString()}`;
+    queryParams.append("organizationId", organizationId.toString());
+    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/delete-testcase/${projectId}?${queryParams.toString()}`;
     try {
         const response = await axios.delete(url, {
             headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
@@ -982,96 +799,22 @@ async function handleDeleteTestcase(args) {
         throw handleApiError(error);
     }
 }
-// Handler for clone_testcase tool
-async function handleCloneTestcase(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/clone/${args.projectId}/${args.id}?${queryParams.toString()}`;
-    try {
-        const response = await axios.post(url, {}, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Testcase Cloned");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
-// Handler for create_test_step tool
-async function handleCreateTestStep(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/teststeps/${args.projectId}/${args.testcaseId}?${queryParams.toString()}`;
-    const steps = typeof args.steps === 'string' ? JSON.parse(args.steps) : args.steps;
-    try {
-        const response = await axios.post(url, { steps }, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Test Steps Created");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
-// Handler for delete_test_step tool
-async function handleDeleteTestStep(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/teststeps/${args.testcaseId}?${queryParams.toString()}`;
-    try {
-        const response = await axios.delete(url, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-            data: { stepIds: args.stepIds.split(',') },
-        });
-        return formatResponse(response.data, "Test Steps Deleted");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
-// Handler for download_testcases tool
-async function handleDownloadTestcases(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    if (args.filters)
-        queryParams.append("filters", args.filters);
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/download/${args.projectId}?${queryParams.toString()}`;
-    try {
-        const response = await axios.get(url, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Testcases Download");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
-// Handler for import_testcases tool
-async function handleImportTestcases(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/import/${args.projectId}?${queryParams.toString()}`;
-    try {
-        const response = await axios.post(url, { file: args.file }, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Testcases Imported");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
 // Handler for create_folder tool
 async function handleCreateFolder(args) {
     validateAuth();
+    const projectId = getProjectId(args.projectId);
+    const organizationId = await getOrganizationId(args.organizationId);
     const url = `${config.apiBaseUrl}/api/v1/folders/create-folders`;
+    const section = args.section || "TESTCASE";
+    const body = {
+        organizationId: organizationId,
+        projectId: projectId,
+        section: section,
+        name: args.name,
+        ...(args.parentId && { parentId: args.parentId }),
+    };
     try {
-        const response = await axios.post(url, args, {
+        const response = await axios.post(url, body, {
             headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
         });
         return formatResponse(response.data, "Folder Created");
@@ -1080,44 +823,14 @@ async function handleCreateFolder(args) {
         throw handleApiError(error);
     }
 }
-// Handler for delete_folder tool
-async function handleDeleteFolder(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/folders/delete/${args.id}?${queryParams.toString()}`;
-    try {
-        const response = await axios.delete(url, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Folder Deleted");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
-// Handler for update_folder tool
-async function handleUpdateFolder(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/folders/${args.id}?${queryParams.toString()}`;
-    try {
-        const response = await axios.patch(url, { folder_name: args.folder_name }, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Folder Updated");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
 // Handler for create_label tool
 async function handleCreateLabel(args) {
     validateAuth();
+    const projectId = getProjectId(args.projectId);
+    const organizationId = await getOrganizationId(args.organizationId);
     const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/labels/create/${args.projectId}?${queryParams.toString()}`;
+    queryParams.append("organizationId", organizationId.toString());
+    const url = `${config.apiBaseUrl}/api/v1/projects/labels/create/${projectId}?${queryParams.toString()}`;
     try {
         const response = await axios.post(url, { values: args.values }, {
             headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
@@ -1142,106 +855,42 @@ async function handleGetUserProfile(args) {
         throw handleApiError(error);
     }
 }
-// Handler for get_organization tool
-async function handleGetOrganization(args) {
-    validateAuth();
-    const url = `${config.apiBaseUrl}/api/v1/organizations/my-organization`;
-    try {
-        const response = await axios.get(url, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Organization Details");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
-// Handler for get_mapped_issues tool
-async function handleGetMappedIssues(args) {
-    validateAuth();
-    const url = `${config.apiBaseUrl}/api/v1/${args.organization_id}/${args.project_id}/${args.integration_type}/testcases/${args.testcase_id}/issues`;
-    try {
-        const response = await axios.get(url, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Mapped Issues");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
-// Handler for search_issues tool
-async function handleSearchIssues(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    if (args.search)
-        queryParams.append("search", args.search);
-    if (args.page)
-        queryParams.append("page", args.page.toString());
-    if (args.limit)
-        queryParams.append("limit", args.limit.toString());
-    const url = `${config.apiBaseUrl}/api/v1/${args.project_id}/${args.integration_type}/issues/search?${queryParams.toString()}`;
-    try {
-        const response = await axios.get(url, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Search Issues");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
-// Handler for map_issues tool
-async function handleMapIssues(args) {
-    validateAuth();
-    const url = `${config.apiBaseUrl}/api/v1/${args.organization_id}/${args.project_id}/${args.testcase_id}/${args.integration_type}/issues/map`;
-    const issues = typeof args.issues === 'string' ? JSON.parse(args.issues) : args.issues;
-    try {
-        const response = await axios.post(url, { issues }, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Issues Mapped");
-    }
-    catch (error) {
-        throw handleApiError(error);
-    }
-}
-// Handler for generate_testcases tool
-async function handleGenerateTestcases(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    if (args.requirement)
-        queryParams.append("requirement", args.requirement);
-    if (args.issue_id)
-        queryParams.append("issue_id", args.issue_id);
-    if (args.selected_fields)
-        queryParams.append("selected_fields", args.selected_fields);
-    const url = `${config.apiBaseUrl}/api/v1/${args.project_id}/testcases/generate?${queryParams.toString()}`;
-    try {
-        const response = await axios.get(url, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Generated Testcases");
-    }
-    catch (error) {
-        throw handleApiError(error);
+// Handler for set_active_project tool
+async function handleSetActiveProject(args) {
+    if (!args.projectId) {
+        throw new Error("projectId is required");
     }
+    setActiveProject(args.projectId);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Active project set to: ${args.projectId}\n\nYou can now use other tools without specifying projectId.`,
+            },
+        ],
+    };
 }
-// Handler for create_issue tool
-async function handleCreateIssue(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", args.organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/issues/create-issues/${args.projectId}?${queryParams.toString()}`;
-    try {
-        const response = await axios.post(url, args, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Issue Created/Updated");
-    }
-    catch (error) {
-        throw handleApiError(error);
+// Handler for get_active_project tool
+async function handleGetActiveProject() {
+    const projectId = cachedProjectId;
+    if (!projectId) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No active project is set. Use set_active_project or specify projectId in your next command.",
+                },
+            ],
+        };
     }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Current active project: ${projectId}`,
+            },
+        ],
+    };
 }
 // Helper function to validate authentication
 function validateAuth() {