@testkase/mcp-server 2.0.13 → 2.2.0

package/build/index.js

@@ -3,854 +3,1483 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import axios from "axios";
-// Get configuration from environment variables
 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;
+// ─── Frontend URL helper ─────────────────────────────────────────────────────
+function getFrontendBaseUrl() {
+    const url = new URL(config.apiBaseUrl);
+    url.hostname = url.hostname.replace(/^api\.?/, "");
+    return url.origin;
+}
+// ─── Auth helpers (reused from v1) ───────────────────────────────────────────
+function validateAuth() {
+    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.");
     }
-    // If cached, return cached value
-    if (cachedOrganizationId !== null) {
-        return cachedOrganizationId;
+    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.");
     }
-    // Fetch from API using PAT token
+}
+function getApiHeaders() {
+    return {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${config.patToken}`,
+    };
+}
+// ─── Cached org ID (auto-resolved from PAT, never a tool param) ─────────────
+let cachedOrganizationId = null;
+async function getOrganizationId() {
+    if (cachedOrganizationId !== null)
+        return cachedOrganizationId;
     validateAuth();
     try {
-        const response = await axios.get(`${config.apiBaseUrl}/api/v1/organizations/my-organization`, {
-            headers: {
-                "Content-Type": "application/json",
-                "Authorization": `Bearer ${config.patToken}`,
-            },
-        });
+        const response = await axios.get(`${config.apiBaseUrl}/api/v1/organizations/my-organization`, { headers: getApiHeaders() });
         const orgData = response.data?.data || response.data;
         if (orgData?.organization_id) {
-            const orgId = orgData.organization_id;
-            cachedOrganizationId = orgId;
-            return orgId;
+            cachedOrganizationId = orgData.organization_id;
+            return cachedOrganizationId;
         }
         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.");
+        if (error instanceof Error && error.message.includes("Could not determine"))
+            throw error;
+        throw new Error("Failed to fetch organization. Check your PAT token.");
+    }
+}
+// ─── API call helper ─────────────────────────────────────────────────────────
+async function callApi(method, path, options = {}) {
+    validateAuth();
+    const orgId = options.skipOrgId ? undefined : await getOrganizationId();
+    const queryParams = new URLSearchParams();
+    if (orgId)
+        queryParams.append("organizationId", orgId.toString());
+    if (options.query) {
+        for (const [key, val] of Object.entries(options.query)) {
+            if (val !== undefined && val !== null && val !== "") {
+                queryParams.append(key, String(val));
+            }
+        }
     }
+    const qs = queryParams.toString();
+    const url = `${config.apiBaseUrl}/api/v1/${path}${qs ? `?${qs}` : ""}`;
+    const response = await axios({
+        method,
+        url,
+        headers: getApiHeaders(),
+        ...(options.body !== undefined && { data: options.body }),
+    });
+    return response.data;
 }
-// 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;
+// ─── Error handler (reused) ──────────────────────────────────────────────────
+function handleApiError(error) {
+    if (axios.isAxiosError(error)) {
+        const e = error;
+        let msg = `API request failed: ${e.message}`;
+        if (e.response) {
+            msg += `\nStatus: ${e.response.status}`;
+            if (e.response.status === 401) {
+                cachedOrganizationId = null;
+            }
+            if (e.response.data) {
+                const d = e.response.data;
+                const safeMsg = d.message || d.error || (typeof d === "string" ? d : undefined);
+                if (safeMsg)
+                    msg += `\nDetails: ${String(safeMsg).slice(0, 500)}`;
+            }
+        }
+        return new Error(msg);
     }
-    // If cached, return cached value
-    if (cachedProjectId !== null) {
-        return cachedProjectId;
+    return error;
+}
+// ─── JSON response helper ────────────────────────────────────────────────────
+function jsonResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function safeJsonParse(raw, fieldName) {
+    if (typeof raw !== "string")
+        return raw;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Invalid JSON in ${fieldName}. Ensure the value is valid JSON.`);
     }
-    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;
+function validateId(id, fieldName) {
+    if (!/^[a-zA-Z0-9_\-]+$/.test(id)) {
+        throw new Error(`Invalid ${fieldName}: contains disallowed characters`);
+    }
+    return id;
 }
-// Tool definitions
-const GET_TESTCASES_TOOL = {
-    name: "get_testcases",
-    description: "Retrieve testcases from the active project. Returns list with title, status, priority, etc. " +
-        "Supports search and filters. Call get_my_projects first if no active project is set.",
+function jsonResponseWithHints(data, hints) {
+    const json = JSON.stringify(data, null, 2);
+    const hintsBlock = hints.length > 0
+        ? `\n\n---\nHINTS:\n${hints.map((h) => `- ${h}`).join("\n")}`
+        : "";
+    return {
+        content: [{ type: "text", text: json + hintsBlock }],
+    };
+}
+// ─── Error enrichment ───────────────────────────────────────────────────────
+const ERROR_HINTS = [
+    { pattern: /Invalid value.*for field/i,
+        hint: "RECOVERY: Call get_project_structure(projectId, include='field_options') to discover allowed values for this field, then retry." },
+    { pattern: /must be a number/i,
+        hint: "RECOVERY: This field requires a numeric ID. Call get_project_structure(projectId) to find valid IDs." },
+    { pattern: /folder_id/i,
+        hint: "RECOVERY: folder_id must be a numeric folder ID. Call get_project_structure(projectId, include='folders') to list folders with their IDs." },
+    { pattern: /status.*(401|unauthorized)/i,
+        hint: "RECOVERY: PAT token may be expired. User needs to regenerate from TestKase account settings." },
+    { pattern: /priority/i,
+        hint: "RECOVERY: Priority values are project-specific. Call get_project_structure(projectId, include='field_options') to discover allowed values." },
+];
+function enrichErrorMessage(errorMsg) {
+    for (const { pattern, hint } of ERROR_HINTS) {
+        if (pattern.test(errorMsg)) {
+            return `${errorMsg}\n\n${hint}`;
+        }
+    }
+    return errorMsg;
+}
+// ─── Field options cache (5-min TTL) ────────────────────────────────────────
+const fieldOptionsCache = new Map();
+const FIELD_OPTIONS_TTL = 5 * 60 * 1000; // 5 minutes
+async function getFieldOptions(projectId) {
+    const cached = fieldOptionsCache.get(projectId);
+    if (cached && Date.now() - cached.ts < FIELD_OPTIONS_TTL) {
+        return cached.data;
+    }
+    try {
+        const response = await callApi("get", `projects/fields/options/${projectId}`);
+        const options = response?.data || response || [];
+        fieldOptionsCache.set(projectId, { data: options, ts: Date.now() });
+        return options;
+    }
+    catch {
+        return cached?.data || [];
+    }
+}
+async function coerceFieldValue(projectId, fieldName, rawValue) {
+    if (rawValue === undefined || rawValue === null)
+        return rawValue;
+    const options = await getFieldOptions(projectId);
+    const fieldDef = options.find((f) => f.fieldName?.toLowerCase() === fieldName.toLowerCase());
+    if (!fieldDef?.values || !Array.isArray(fieldDef.values))
+        return rawValue;
+    const strValue = String(rawValue);
+    // Exact match
+    if (fieldDef.values.includes(strValue))
+        return strValue;
+    // Case-insensitive match
+    const match = fieldDef.values.find((v) => v.toLowerCase() === strValue.toLowerCase());
+    if (match)
+        return match;
+    // No match — return as-is, let API validate
+    return rawValue;
+}
+// ─── Param normalizer (handles camelCase / snake_case) ───────────────────────
+function p(args, ...names) {
+    for (const n of names) {
+        if (args[n] !== undefined)
+            return args[n];
+    }
+    return undefined;
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// TOOL DEFINITIONS (11 tools)
+// ═══════════════════════════════════════════════════════════════════════════════
+const LIST_PROJECTS_TOOL = {
+    name: "list_projects",
+    description: "List all projects the authenticated user has access to. " +
+        "Use this first to find a projectId, then pass it to other tools.",
     inputSchema: {
         type: "object",
         properties: {
-            search: { type: "string", description: "Search term to filter by title or summary" },
+            search: { type: "string", description: "Search by project name or ID" },
             page: { type: "number", description: "Page number (default: 1)" },
             limit: { type: "number", description: "Items per page (default: 20)" },
-            filters: { type: "string", description: "JSON filters. Example: {\"status\":[\"active\"],\"priority\":[\"high\"]}" },
         },
         required: [],
     },
 };
-const GET_TESTCASE_DETAIL_TOOL = {
-    name: "get_testcase_detail",
-    description: "Get full details of a testcase including test steps and attachments.",
+const GET_PROJECT_STRUCTURE_TOOL = {
+    name: "get_project_structure",
+    description: "Get the structure of a project: folders, labels, team members, and field options (allowed values for priority, status, etc.). " +
+        "IMPORTANT: Call this before create/update to discover allowed field values, which are project-specific.",
     inputSchema: {
         type: "object",
         properties: {
-            testcaseId: { type: "string", description: "The testcase ID" },
+            projectId: { type: "string", description: "Project ID (e.g. PRJ-1001)" },
+            section: {
+                type: "string",
+                enum: ["TESTCASE", "TEST_CYCLE", "TEST_PLAN"],
+                description: "Folder section (default: TESTCASE)",
+            },
+            include: {
+                type: "string",
+                description: "Comma-separated list of what to include: folders,labels,members,field_options (default: all)",
+            },
         },
-        required: ["testcaseId"],
+        required: ["projectId"],
     },
 };
-const GET_FOLDERS_TOOL = {
-    name: "get_folders",
-    description: "Get folder structure of the active project. Use folder IDs when creating testcases.",
+const SEARCH_TESTCASES_TOOL = {
+    name: "search_testcases",
+    description: "Search and list test cases in a project. Supports text search, filters, sorting, and pagination.",
     inputSchema: {
         type: "object",
         properties: {
-            search: { type: "string", description: "Search term to filter folders" },
+            projectId: { type: "string", description: "Project ID" },
+            search: { type: "string", description: "Search text (title or summary)" },
+            filters: {
+                type: "string",
+                description: 'JSON string of filters. Example: {"status":["active"],"priority":["high","critical"]}',
+            },
+            page: { type: "number", description: "Page number (default: 1)" },
+            limit: { type: "number", description: "Items per page (default: 20)" },
+            sortBy: { type: "string", description: "Field to sort by (e.g. created_at, title)" },
+            sortOrder: { type: "string", enum: ["asc", "desc"], description: "Sort direction" },
         },
-        required: [],
-    },
-};
-const GET_LABELS_TOOL = {
-    name: "get_labels",
-    description: "Get all labels available in the active project for categorizing testcases.",
-    inputSchema: {
-        type: "object",
-        properties: {},
-        required: [],
-    },
-};
-const GET_MY_PROJECTS_TOOL = {
-    name: "get_my_projects",
-    description: "IMPORTANT: Call this FIRST. Lists all projects. " +
-        "ALWAYS ASK the user which project to use, then call set_active_project with their choice.",
-    inputSchema: {
-        type: "object",
-        properties: {},
-        required: [],
+        required: ["projectId"],
     },
 };
-const CREATE_TESTCASE_TOOL = {
-    name: "create_testcase",
-    description: "Create a new testcase in the active project.",
+const GET_TESTCASE_TOOL = {
+    name: "get_testcase",
+    description: "Get full details of a single test case including test steps and attachments.",
     inputSchema: {
         type: "object",
         properties: {
-            title: { type: "string", description: "Testcase title (required)" },
-            summary: { type: "string", description: "Description/summary" },
-            priority: { type: "string", description: "low, medium, high, or critical" },
-            folder_id: { type: "string", description: "Folder ID from get_folders" },
-            test_steps: { type: "string", description: "JSON array: [{\"step\":\"...\",\"expected_result\":\"...\"}]" },
+            projectId: { type: "string", description: "Project ID" },
+            testcaseId: { type: "string", description: "Test case ID (e.g. TEST-123)" },
         },
-        required: ["title"],
+        required: ["projectId", "testcaseId"],
     },
 };
-const CREATE_BULK_TESTCASE_TOOL = {
-    name: "create_bulk_testcase",
-    description: "Create multiple testcases at once in the active project.",
+const MANAGE_TESTCASE_TOOL = {
+    name: "manage_testcase",
+    description: "IMPORTANT: Before creating/updating, call get_project_structure(projectId) to discover folder IDs and allowed field values.\n\n" +
+        "Create, bulk create, update, or delete test cases.\n\n" +
+        "ACTIONS:\n" +
+        "  create       - Create a single test case. Params: title (required), summary, priority, folder_id, labels, test_steps, precondition, status, automated, test_data, expected_result, platform, environment, features, owner_id, custom_fields\n" +
+        "  create_bulk  - Create multiple test cases. Params: testcases (JSON array)\n" +
+        "  update       - Update one field for test case(s). Params: ids, field, value (all required)\n" +
+        "  delete       - Delete test case(s). Params: ids (required)\n\n" +
+        "VALID UPDATE FIELDS: title, summary, precondition, priority, status, automated, test_data, expected_result, labels, features, platform, environment, custom_fields, owner_id, folder_id\n\n" +
+        "EXAMPLES:\n" +
+        "  Create:  { action: 'create', title: 'Verify login' }\n" +
+        "  Update:  { action: 'update', ids: 'TEST-1', field: 'priority', value: '<value from get_project_structure>' }\n" +
+        "  Delete:  { action: 'delete', ids: 'TEST-1,TEST-2' }",
     inputSchema: {
         type: "object",
         properties: {
-            testcases: { type: "string", description: "JSON array of testcases, each with title, summary, priority, test_steps" },
+            projectId: { type: "string", description: "Project ID" },
+            action: {
+                type: "string",
+                enum: ["create", "create_bulk", "update", "delete"],
+                description: "Action to perform",
+            },
+            // create params
+            title: { type: "string", description: "[create] Test case title" },
+            summary: { type: "string", description: "[create] Description/summary" },
+            priority: {
+                type: "string",
+                description: "[create] Priority. Values are project-specific — call get_project_structure(projectId, include='field_options') first to discover allowed values.",
+            },
+            folder_id: { type: "string", description: "[create] Folder ID to place the test case in" },
+            labels: {
+                type: "string",
+                description: "[create] Comma-separated label names",
+            },
+            test_steps: {
+                type: "string",
+                description: '[create] JSON array of test steps: [{"description":"...","test_data":"...","expected_result":"..."}]',
+            },
+            precondition: { type: "string", description: "[create] Preconditions for the test case" },
+            status: {
+                type: "string",
+                description: "[create] Status. Values are project-specific — call get_project_structure(projectId, include='field_options') first.",
+            },
+            automated: {
+                type: "string",
+                description: "[create] Automation status. Values are project-specific — call get_project_structure(projectId, include='field_options') first.",
+            },
+            test_data: { type: "string", description: "[create] Test data for the test case" },
+            expected_result: { type: "string", description: "[create] Expected result for the test case" },
+            platform: {
+                type: "string",
+                description: "[create] Platform. Values are project-specific — call get_project_structure(projectId, include='field_options') first.",
+            },
+            environment: { type: "string", description: "[create] Comma-separated environment values" },
+            features: { type: "string", description: "[create] Comma-separated feature/component names" },
+            owner_id: { type: "string", description: "[create] Owner user ID" },
+            custom_fields: {
+                type: "string",
+                description: '[create] JSON object of custom field values (e.g. {"custom1": "value", "custom2": ["val1","val2"]})',
+            },
+            // create_bulk params
+            testcases: {
+                type: "string",
+                description: "[create_bulk] JSON array of test cases, each with title, summary, priority, folder_id, test_steps",
+            },
+            // update/delete params
+            ids: {
+                type: "string",
+                description: "[update/delete] Test case IDs, comma-separated (e.g. 'TEST-1' or 'TEST-1,TEST-2')",
+            },
+            field: {
+                type: "string",
+                description: "[update] Field to update. Valid: title, summary, precondition, priority, status, automated, test_data, expected_result, labels, features, platform, environment, custom_fields, owner_id, folder_id. For priority/status/automated/platform/environment, call get_project_structure(include='field_options') to get allowed values.",
+            },
+            value: { type: "string", description: "[update] New value. String for most fields. For labels/features/environment: comma-separated. For custom_fields: JSON object (e.g. {\"fieldName\": \"value\"})" },
         },
-        required: ["testcases"],
+        required: ["projectId", "action"],
     },
 };
-const UPDATE_TESTCASE_FIELD_TOOL = {
-    name: "update_testcase_field",
-    description: "Update a field for one or multiple testcases.",
+const MANAGE_FOLDER_TOOL = {
+    name: "manage_folder",
+    description: "Create, rename, move, or delete folders. Works across all sections (TESTCASE, TEST_CYCLE, TEST_PLAN).\n\n" +
+        "ACTIONS:\n" +
+        "  create  - Create a folder. Params: name (required), section, parentId\n" +
+        "  rename  - Rename a folder. Params: folderId (required), name (required)\n" +
+        "  move    - Move a folder. Params: folderId (required), parentId (null for root)\n" +
+        "  delete  - Delete a folder. Params: folderId (required)",
     inputSchema: {
         type: "object",
         properties: {
-            ids: { type: "string", description: "Comma-separated testcase IDs" },
-            field: { type: "string", description: "Field name (title, summary, priority, status, etc.)" },
-            value: { type: "string", description: "New value" },
+            projectId: { type: "string", description: "Project ID" },
+            action: {
+                type: "string",
+                enum: ["create", "rename", "move", "delete"],
+                description: "Action to perform",
+            },
+            section: {
+                type: "string",
+                enum: ["TESTCASE", "TEST_CYCLE", "TEST_PLAN"],
+                description: "Folder section (default: TESTCASE)",
+            },
+            name: { type: "string", description: "[create/rename] Folder name (max 50 chars)" },
+            folderId: {
+                type: "number",
+                description: "[rename/move/delete] ID of the folder to modify",
+            },
+            parentId: {
+                type: "number",
+                description: "[create] Parent folder ID for subfolder. [move] New parent ID (null for root).",
+            },
         },
-        required: ["ids", "field", "value"],
+        required: ["projectId", "action"],
     },
 };
-const DELETE_TESTCASE_TOOL = {
-    name: "delete_testcase",
-    description: "Delete one or multiple testcases. ALWAYS confirm with user before deleting.",
+const SEARCH_TEST_CYCLES_TOOL = {
+    name: "search_test_cycles",
+    description: "List and search test cycles in a project with execution progress.",
     inputSchema: {
         type: "object",
         properties: {
-            ids: { type: "string", description: "Comma-separated testcase IDs to delete" },
+            projectId: { type: "string", description: "Project ID" },
+            search: { type: "string", description: "Search by title" },
+            folderId: { type: "number", description: "Filter by folder ID" },
+            status: { type: "string", description: "Filter by status (open, closed, etc.)" },
+            page: { type: "number", description: "Page number (default: 1)" },
+            limit: { type: "number", description: "Items per page (default: 20)" },
         },
-        required: ["ids"],
+        required: ["projectId"],
     },
 };
-const CREATE_FOLDER_TOOL = {
-    name: "create_folder",
-    description: "Create a new folder in the active project for organizing testcases.",
+const MANAGE_TEST_CYCLE_TOOL = {
+    name: "manage_test_cycle",
+    description: "Manage test cycles: create, update, delete, get details, list/link/unlink/assign test cases.\n\n" +
+        "ACTIONS:\n" +
+        "  create            - Create a cycle. Params: title (required), summary, status, planned_start_date, planned_end_date, folder_id\n" +
+        "  update            - Update a cycle. Params: cycleId (required), plus fields to change (title, summary, status, dates, folder_id)\n" +
+        "  delete            - Delete cycle(s). Params: ids (required, comma-separated)\n" +
+        "  get_details       - Get cycle details. Params: cycleId (required)\n" +
+        "  get_testcases     - List test cases in cycle. Params: cycleId (required), search, page, limit\n" +
+        "  link_testcases    - Link test cases to cycle. Params: cycleId (required), testcase_ids (required, comma-separated)\n" +
+        "  unlink_testcases  - Unlink test cases from cycle. Params: cycleId (required), testcase_ids (required, comma-separated)\n" +
+        "  assign_testcases  - Assign test cases to user. Params: cycleId (required), testcase_ids (required), assignee_id (required)\n\n" +
+        "VALID STATUSES: open, in_progress, completed",
     inputSchema: {
         type: "object",
         properties: {
-            name: { type: "string", description: "Folder name (max 50 characters)" },
-            parentId: { type: "number", description: "Parent folder ID for subfolder (optional)" },
+            projectId: { type: "string", description: "Project ID" },
+            action: {
+                type: "string",
+                enum: [
+                    "create",
+                    "update",
+                    "delete",
+                    "get_details",
+                    "get_testcases",
+                    "link_testcases",
+                    "unlink_testcases",
+                    "assign_testcases",
+                ],
+                description: "Action to perform",
+            },
+            // Identifiers
+            cycleId: {
+                type: "string",
+                description: "Test cycle ID (e.g. TCYCLE-1). Required for update/delete/get_details/get_testcases/link/unlink/assign.",
+            },
+            // create/update fields
+            title: { type: "string", description: "[create/update] Cycle title" },
+            summary: { type: "string", description: "[create/update] Description" },
+            status: {
+                type: "string",
+                description: "[create/update] Status: open, in_progress, completed",
+            },
+            planned_start_date: {
+                type: "string",
+                description: "[create/update] Start date (YYYY-MM-DD)",
+            },
+            planned_end_date: {
+                type: "string",
+                description: "[create/update] End date (YYYY-MM-DD)",
+            },
+            folder_id: {
+                type: "number",
+                description: "[create/update] Folder ID",
+            },
+            // delete
+            ids: {
+                type: "string",
+                description: "[delete] Comma-separated cycle IDs to delete",
+            },
+            // link/unlink/assign
+            testcase_ids: {
+                type: "string",
+                description: "[link_testcases/unlink_testcases/assign_testcases] Comma-separated test case IDs",
+            },
+            assignee_id: {
+                type: "number",
+                description: "[assign_testcases] User ID to assign",
+            },
+            // get_testcases params
+            search: { type: "string", description: "[get_testcases] Search text" },
+            page: { type: "number", description: "[get_testcases] Page number" },
+            limit: { type: "number", description: "[get_testcases] Items per page" },
         },
-        required: ["name"],
+        required: ["projectId", "action"],
     },
 };
-const CREATE_LABEL_TOOL = {
-    name: "create_label",
-    description: "Create new labels in the active project for categorizing testcases.",
+const EXECUTE_TESTS_TOOL = {
+    name: "execute_tests",
+    description: "Record test execution results for test cases in a test cycle. " +
+        "Pass a single result or an array of results. " +
+        "Valid execution statuses: pass, fail, blocked, not_executed.",
     inputSchema: {
         type: "object",
         properties: {
-            values: { type: "string", description: "Comma-separated label names" },
+            projectId: { type: "string", description: "Project ID" },
+            cycleId: { type: "string", description: "Test cycle ID (e.g. TCYCLE-1)" },
+            results: {
+                type: "string",
+                description: 'JSON array of results: [{"testcase_id":"TEST-1","execution_status":"pass","actual_result":"Worked","environment":"staging"}]. ' +
+                    "Each object must have testcase_id and execution_status. actual_result and environment are optional.",
+            },
         },
-        required: ["values"],
+        required: ["projectId", "cycleId", "results"],
     },
 };
-const GET_USER_PROFILE_TOOL = {
-    name: "get_user_profile",
-    description: "Get current logged-in user profile information",
+const MANAGE_TEST_PLAN_TOOL = {
+    name: "manage_test_plan",
+    description: "Manage test plans: create, update, delete, list, get details, link/unlink cycles, get cycles, get test cases.\n\n" +
+        "ACTIONS:\n" +
+        "  create         - Create a plan. Params: title (required), summary, status, planned_start_date, planned_end_date, folder_id\n" +
+        "  update         - Update a plan. Params: planId (required), plus fields to change (title, summary, status, dates, folder_id)\n" +
+        "  delete         - Delete plan(s). Params: ids (required, comma-separated)\n" +
+        "  list           - List all plans. Params: search, page, limit\n" +
+        "  get_details    - Get plan details. Params: planId (required)\n" +
+        "  link_cycles    - Link cycles to plan. Params: planId (required), cycle_ids (required, comma-separated)\n" +
+        "  unlink_cycles  - Unlink cycles from plan. Params: planId (required), cycle_ids (required, comma-separated)\n" +
+        "  get_cycles     - List cycles in plan. Params: planId (required), search, page, limit\n" +
+        "  get_testcases  - List test cases in plan. Params: planId (required), search, page, limit",
     inputSchema: {
         type: "object",
-        properties: {},
-        required: [],
+        properties: {
+            projectId: { type: "string", description: "Project ID" },
+            action: {
+                type: "string",
+                enum: [
+                    "create",
+                    "update",
+                    "delete",
+                    "list",
+                    "get_details",
+                    "link_cycles",
+                    "unlink_cycles",
+                    "get_cycles",
+                    "get_testcases",
+                ],
+                description: "Action to perform",
+            },
+            // Identifier
+            planId: {
+                type: "string",
+                description: "Test plan ID (e.g. TPLAN-1). Required for update/delete/get_details/link_cycles/unlink_cycles/get_cycles/get_testcases.",
+            },
+            // create/update fields
+            title: { type: "string", description: "[create/update] Plan title" },
+            summary: { type: "string", description: "[create/update] Description" },
+            status: { type: "string", description: "[create/update] Status" },
+            planned_start_date: {
+                type: "string",
+                description: "[create/update] Start date (YYYY-MM-DD)",
+            },
+            planned_end_date: {
+                type: "string",
+                description: "[create/update] End date (YYYY-MM-DD)",
+            },
+            folder_id: { type: "number", description: "[create/update] Folder ID" },
+            // delete
+            ids: {
+                type: "string",
+                description: "[delete] Comma-separated plan IDs to delete",
+            },
+            // link/unlink cycles
+            cycle_ids: {
+                type: "string",
+                description: "[link_cycles/unlink_cycles] Comma-separated test cycle IDs",
+            },
+            // list/get_cycles/get_testcases pagination
+            search: { type: "string", description: "[list/get_cycles/get_testcases] Search text" },
+            page: { type: "number", description: "[list/get_cycles/get_testcases] Page number" },
+            limit: { type: "number", description: "[list/get_cycles/get_testcases] Items per page" },
+        },
+        required: ["projectId", "action"],
     },
 };
-const SET_ACTIVE_PROJECT_TOOL = {
-    name: "set_active_project",
-    description: "Set active project AFTER user chooses from get_my_projects. All other tools use this project.",
+const GET_REPORT_TOOL = {
+    name: "get_report",
+    description: "Get reports and analytics for a project. Covers execution, coverage, trends, team, defects, and AI insights. " +
+        "Available report types: execution_summary, execution_by_cycle, execution_by_tester, execution_by_priority, " +
+        "execution_by_environment, execution_by_folder, requirement_coverage, traceability_matrix, " +
+        "failed_requirements, uncovered_requirements, testcase_coverage, unlinked_testcases, " +
+        "defects_by_folder, tester_workload, testcase_distribution, " +
+        "execution_trend, execution_burnup, execution_burndown, test_creation, cycle_comparison, " +
+        "scorecard_by_folder, scorecard_by_tester, created_vs_executed, execution_by_automation, " +
+        "defects_by_cycle, defects_by_tester, requirement_coverage_trend, " +
+        "flaky_tests, release_readiness, risk_heatmap_folder, risk_heatmap_feature, " +
+        "testcase_quality, predictive_failure, smart_prioritization, tester_effectiveness, " +
+        "stale_tests, defect_hotspots, cycle_health, suite_optimization, " +
+        "requirement_risk_matrix, execution_velocity, project_health.",
     inputSchema: {
         type: "object",
         properties: {
-            projectId: { type: "string", description: "Project ID chosen by user" },
+            projectId: { type: "string", description: "Project ID" },
+            report_type: {
+                type: "string",
+                description: "Report type (see description for full list)",
+            },
+            test_cycle_ids: {
+                type: "string",
+                description: "Comma-separated test cycle IDs to filter by",
+            },
+            test_plan_ids: {
+                type: "string",
+                description: "Comma-separated test plan IDs to filter by",
+            },
+            startDate: { type: "string", description: "Start date filter (YYYY-MM-DD)" },
+            endDate: { type: "string", description: "End date filter (YYYY-MM-DD)" },
+            granularity: {
+                type: "string",
+                enum: ["day", "week", "month"],
+                description: "Granularity for trend reports",
+            },
+            // cycle_comparison specific
+            cycle_ids: {
+                type: "string",
+                description: "[cycle_comparison] Comma-separated cycle IDs to compare",
+            },
         },
-        required: ["projectId"],
+        required: ["projectId", "report_type"],
     },
 };
-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: {},
-        required: [],
-    },
+// ═══════════════════════════════════════════════════════════════════════════════
+// REPORT TYPE → ENDPOINT MAPPING
+// ═══════════════════════════════════════════════════════════════════════════════
+const REPORT_TYPE_MAP = {
+    // Execution
+    execution_summary: "execution/summary",
+    execution_by_cycle: "execution/by-cycle",
+    execution_by_tester: "execution/by-tester",
+    execution_by_priority: "execution/by-priority",
+    execution_by_environment: "execution/by-environment",
+    execution_by_folder: "execution/by-folder",
+    // Coverage
+    requirement_coverage: "coverage/requirement-coverage",
+    traceability_matrix: "coverage/traceability-matrix",
+    failed_requirements: "coverage/failed-requirements",
+    uncovered_requirements: "coverage/uncovered-requirements",
+    testcase_coverage: "coverage/testcase-coverage",
+    unlinked_testcases: "coverage/unlinked-testcases",
+    // Defects
+    defects_by_folder: "defects/by-folder",
+    // Team
+    tester_workload: "team/tester-workload",
+    testcase_distribution: "team/testcase-distribution",
+    // Trends
+    execution_trend: "trends/execution-trend",
+    execution_burnup: "trends/execution-burnup",
+    execution_burndown: "trends/execution-burndown",
+    test_creation: "trends/test-creation",
+    cycle_comparison: "trends/cycle-comparison",
+    scorecard_by_folder: "trends/scorecard-by-folder",
+    scorecard_by_tester: "trends/scorecard-by-tester",
+    created_vs_executed: "trends/created-vs-executed",
+    execution_by_automation: "trends/execution-by-automation",
+    defects_by_cycle: "trends/defects-by-cycle",
+    defects_by_tester: "trends/defects-by-tester",
+    requirement_coverage_trend: "trends/requirement-coverage-trend",
+    // AI Insights
+    flaky_tests: "ai/flaky-tests",
+    release_readiness: "ai/release-readiness",
+    risk_heatmap_folder: "ai/risk-heatmap-folder",
+    risk_heatmap_feature: "ai/risk-heatmap-feature",
+    testcase_quality: "ai/testcase-quality",
+    predictive_failure: "ai/predictive-failure",
+    smart_prioritization: "ai/smart-prioritization",
+    tester_effectiveness: "ai/tester-effectiveness",
+    stale_tests: "ai/stale-tests",
+    defect_hotspots: "ai/defect-hotspots",
+    cycle_health: "ai/cycle-health",
+    suite_optimization: "ai/suite-optimization",
+    requirement_risk_matrix: "ai/requirement-risk-matrix",
+    execution_velocity: "ai/execution-velocity",
+    project_health: "ai/project-health",
 };
-// Create server instance
-const server = new Server({
-    name: "testkase-mcp-server",
-    version: "1.0.0",
-}, {
-    capabilities: {
-        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,
-            CREATE_TESTCASE_TOOL,
-            CREATE_BULK_TESTCASE_TOOL,
-            UPDATE_TESTCASE_FIELD_TOOL,
-            DELETE_TESTCASE_TOOL,
-            GET_FOLDERS_TOOL,
-            CREATE_FOLDER_TOOL,
-            GET_LABELS_TOOL,
-            CREATE_LABEL_TOOL,
-            GET_USER_PROFILE_TOOL,
-        ],
-    };
-});
-// Handle tool calls
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    try {
-        if (name === "get_my_projects") {
-            return await handleGetMyProjects(args);
-        }
-        else if (name === "set_active_project") {
-            return await handleSetActiveProject(args);
-        }
-        else if (name === "get_active_project") {
-            return await handleGetActiveProject();
-        }
-        else if (name === "get_testcases") {
-            return await handleGetTestcases(args);
-        }
-        else if (name === "get_testcase_detail") {
-            return await handleGetTestcaseDetail(args);
-        }
-        else if (name === "create_testcase") {
-            return await handleCreateTestcase(args);
-        }
-        else if (name === "create_bulk_testcase") {
-            return await handleCreateBulkTestcase(args);
-        }
-        else if (name === "update_testcase_field") {
-            return await handleUpdateTestcaseField(args);
-        }
-        else if (name === "delete_testcase") {
-            return await handleDeleteTestcase(args);
-        }
-        else if (name === "get_folders") {
-            return await handleGetFolders(args);
-        }
-        else if (name === "create_folder") {
-            return await handleCreateFolder(args);
-        }
-        else if (name === "get_labels") {
-            return await handleGetLabels(args);
-        }
-        else if (name === "create_label") {
-            return await handleCreateLabel(args);
-        }
-        else if (name === "get_user_profile") {
-            return await handleGetUserProfile(args);
-        }
-        throw new Error(`Unknown tool: ${name}`);
-    }
-    catch (error) {
-        if (error instanceof Error) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Error: ${error.message}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-        throw error;
-    }
-});
-// Handler for get_testcases tool
-async function handleGetTestcases(args) {
-    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", organizationId.toString());
-    if (args.page !== undefined)
-        queryParams.append("page", args.page.toString());
-    if (args.limit !== undefined)
-        queryParams.append("limit", args.limit.toString());
-    if (args.selectAll !== undefined)
-        queryParams.append("selectAll", args.selectAll.toString());
-    if (args.columns)
-        queryParams.append("columns", args.columns);
-    if (args.filters)
-        queryParams.append("filters", args.filters);
-    if (args.search)
-        queryParams.append("search", args.search);
-    if (args.searchType)
-        queryParams.append("searchType", args.searchType);
-    if (args.sortBy)
-        queryParams.append("sortBy", args.sortBy);
-    if (args.sortOrder)
-        queryParams.append("sortOrder", args.sortOrder);
-    if (args.create_start_date)
-        queryParams.append("create_start_date", args.create_start_date);
-    if (args.create_end_date)
-        queryParams.append("create_end_date", args.create_end_date);
-    if (args.updated_start_date)
-        queryParams.append("updated_start_date", args.updated_start_date);
-    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/${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
-    const headers = {
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${config.patToken}`,
-    };
-    try {
-        // Make API request
-        const response = await axios.get(url, { headers });
-        // Format the response
-        const data = response.data;
-        let resultText = `# Testcases for Project ${args.projectId}\n\n`;
-        if (data.data && Array.isArray(data.data)) {
-            resultText += `**Total Results:** ${data.total || data.data.length}\n`;
-            if (data.page)
-                resultText += `**Page:** ${data.page}\n`;
-            if (data.limit)
-                resultText += `**Limit:** ${data.limit}\n`;
-            resultText += `\n## Testcases (${data.data.length} items)\n\n`;
-            data.data.forEach((testcase, index) => {
-                resultText += `### ${index + 1}. ${testcase.title || "Untitled"}\n`;
-                resultText += `- **ID:** ${testcase.id}\n`;
-                if (testcase.status)
-                    resultText += `- **Status:** ${testcase.status}\n`;
-                if (testcase.priority)
-                    resultText += `- **Priority:** ${testcase.priority}\n`;
-                if (testcase.automated !== undefined)
-                    resultText += `- **Automated:** ${testcase.automated}\n`;
-                if (testcase.summary)
-                    resultText += `- **Summary:** ${testcase.summary}\n`;
-                if (testcase.owner_id)
-                    resultText += `- **Owner ID:** ${testcase.owner_id}\n`;
-                if (testcase.folder_id)
-                    resultText += `- **Folder ID:** ${testcase.folder_id}\n`;
-                if (testcase.created_at)
-                    resultText += `- **Created:** ${testcase.created_at}\n`;
-                if (testcase.updated_at)
-                    resultText += `- **Updated:** ${testcase.updated_at}\n`;
-                if (testcase.labels && Array.isArray(testcase.labels) && testcase.labels.length > 0) {
-                    resultText += `- **Labels:** ${testcase.labels.join(", ")}\n`;
-                }
-                if (testcase.features && Array.isArray(testcase.features) && testcase.features.length > 0) {
-                    resultText += `- **Features:** ${testcase.features.join(", ")}\n`;
-                }
-                resultText += `\n`;
-            });
-        }
-        else {
-            resultText += "No testcases found or unexpected response format.\n\n";
-            resultText += `**Raw Response:**\n\`\`\`json\n${JSON.stringify(data, null, 2)}\n\`\`\`\n`;
-        }
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: resultText,
-                },
-            ],
-        };
-    }
-    catch (error) {
-        if (axios.isAxiosError(error)) {
-            const axiosError = error;
-            let errorMessage = `API request failed: ${axiosError.message}`;
-            if (axiosError.response) {
-                errorMessage += `\nStatus: ${axiosError.response.status}`;
-                errorMessage += `\nResponse: ${JSON.stringify(axiosError.response.data)}`;
-            }
-            throw new Error(errorMessage);
-        }
-        throw error;
-    }
+// ═══════════════════════════════════════════════════════════════════════════════
+// TOOL HANDLERS
+// ═══════════════════════════════════════════════════════════════════════════════
+// 1. list_projects
+async function handleListProjects(args) {
+    const data = await callApi("get", "projects/user/my-projects", {
+        query: {
+            search: p(args, "search"),
+            page: p(args, "page"),
+            limit: p(args, "limit"),
+        },
+    });
+    return jsonResponseWithHints(data, [
+        "Next: call get_project_structure(projectId) to see folders, labels, and allowed field values.",
+    ]);
 }
-// Handler for get_testcase_detail tool
-async function handleGetTestcaseDetail(args) {
-    validateAuth();
-    const projectId = getProjectId(args.projectId);
-    const organizationId = await getOrganizationId(args.organizationId);
-    // Handle different param names AI might use
-    const testcaseId = args.testcaseId || args.testcase_id || args.id;
-    if (!testcaseId) {
-        throw new Error("testcaseId is required");
+// 2. get_project_structure
+async function handleGetProjectStructure(args) {
+    const projectId = p(args, "projectId", "project_id");
+    if (!projectId)
+        throw new Error("projectId is required");
+    validateId(projectId, "projectId");
+    const section = p(args, "section") || "TESTCASE";
+    const includeRaw = p(args, "include") || "folders,labels,members,field_options";
+    const includes = includeRaw.split(",").map((s) => s.trim().toLowerCase());
+    const orgId = await getOrganizationId();
+    const result = {};
+    const promises = [];
+    if (includes.includes("folders")) {
+        promises.push(callApi("get", "folders/get-folders", {
+            query: { projectId, section },
+        }).then((data) => {
+            result.folders = data;
+        }));
     }
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/get-testcase-detail/${projectId}/${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 Detail: ${testcaseId}`);
+    if (includes.includes("labels")) {
+        promises.push(callApi("get", `projects/labels/get-label/${projectId}`).then((data) => {
+            result.labels = data;
+        }));
     }
-    catch (error) {
-        throw handleApiError(error);
+    if (includes.includes("members")) {
+        promises.push(callApi("get", `projects/${projectId}/team-members`).then((data) => {
+            result.members = data;
+        }));
     }
-}
-// Handler for get_folders tool
-async function handleGetFolders(args) {
-    validateAuth();
-    const projectId = getProjectId(args.projectId);
-    const organizationId = await getOrganizationId(args.organizationId);
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", organizationId.toString());
-    queryParams.append("projectId", projectId);
-    queryParams.append("section", "TESTCASE");
-    if (args.search) {
-        queryParams.append("search", args.search);
-    }
-    const url = `${config.apiBaseUrl}/api/v1/folders/get-folders?${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, `Folders for Project: ${args.projectId}`);
-    }
-    catch (error) {
-        throw handleApiError(error);
+    if (includes.includes("field_options")) {
+        promises.push(callApi("get", `projects/fields/options/${projectId}`).then((data) => {
+            result.field_options = data?.data || data;
+        }));
     }
+    await Promise.all(promises);
+    return jsonResponseWithHints(result, [
+        "Use the field_options values above when creating/updating test cases.",
+    ]);
 }
-// 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", organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/labels/get-label/${projectId}?${queryParams.toString()}`;
-    try {
-        const response = await axios.get(url, {
-            headers: {
-                "Content-Type": "application/json",
-                "Authorization": `Bearer ${config.patToken}`,
-            },
+// 3. search_testcases
+async function handleSearchTestcases(args) {
+    const projectId = p(args, "projectId", "project_id");
+    if (!projectId)
+        throw new Error("projectId is required");
+    validateId(projectId, "projectId");
+    const data = await callApi("get", `projects/testcases/get-testcase/${projectId}`, {
+        query: {
+            search: p(args, "search"),
+            filters: p(args, "filters"),
+            page: p(args, "page"),
+            limit: p(args, "limit"),
+            sortBy: p(args, "sortBy", "sort_by"),
+            sortOrder: p(args, "sortOrder", "sort_order"),
+        },
+    });
+    const baseUrl = getFrontendBaseUrl();
+    if (Array.isArray(data?.data)) {
+        data.data.forEach((tc) => {
+            if (tc.id)
+                tc.url = `${baseUrl}/${projectId}/testcases/${tc.id}`;
         });
-        const data = response.data;
-        return formatResponse(data, `Labels for Project: ${args.projectId}`);
-    }
-    catch (error) {
-        throw handleApiError(error);
     }
+    return jsonResponse(data);
 }
-// Handler for get_my_projects tool
-async function handleGetMyProjects(args) {
-    validateAuth();
-    const queryParams = new URLSearchParams();
-    if (args.page)
-        queryParams.append("page", args.page.toString());
-    if (args.limit)
-        queryParams.append("limit", args.limit.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/user/my-projects?${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, "My Projects");
-    }
-    catch (error) {
-        throw handleApiError(error);
+// 4. get_testcase
+async function handleGetTestcase(args) {
+    const projectId = p(args, "projectId", "project_id");
+    const testcaseId = p(args, "testcaseId", "testcase_id", "id");
+    if (!projectId)
+        throw new Error("projectId is required");
+    if (!testcaseId)
+        throw new Error("testcaseId is required");
+    validateId(projectId, "projectId");
+    validateId(testcaseId, "testcaseId");
+    const data = await callApi("get", `projects/testcases/get-testcase-detail/${projectId}/${testcaseId}`);
+    if (data?.data?.testcase) {
+        data.data.testcase.url = `${getFrontendBaseUrl()}/${projectId}/testcases/${testcaseId}`;
     }
+    return jsonResponse(data);
 }
-// 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 and parse test_steps (JSON string) before sending to API
-    const { test_steps: test_steps_raw, testSteps, labels: labels_raw, ...restArgs } = args;
-    // Handle different param names AI might use
-    const test_steps_input = test_steps_raw || testSteps;
-    const test_steps = test_steps_input ? (typeof test_steps_input === 'string' ? JSON.parse(test_steps_input) : test_steps_input) : null;
-    // Build testcaseData with normalized field names
-    const testcaseData = {};
-    // Title (required)
-    testcaseData.title = restArgs.title || restArgs.name || restArgs.testcase_title;
-    if (!testcaseData.title)
-        throw new Error("title is required");
-    // Summary/description
-    if (restArgs.summary || restArgs.description) {
-        testcaseData.summary = restArgs.summary || restArgs.description;
-    }
-    // Priority
-    if (restArgs.priority) {
-        testcaseData.priority = restArgs.priority;
-    }
-    // Folder ID - handle both snake_case and camelCase
-    const folderId = restArgs.folder_id || restArgs.folderId;
-    if (folderId) {
-        testcaseData.folder_id = folderId;
-    }
-    // Parse labels from comma-separated string
-    if (labels_raw) {
-        testcaseData.labels = typeof labels_raw === 'string' ? labels_raw.split(',').map((l) => l.trim()) : labels_raw;
-    }
-    const queryParams = new URLSearchParams();
-    queryParams.append("organizationId", organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/create-testcase/${projectId}?${queryParams.toString()}`;
-    try {
-        // Step 1: Create testcase
-        const response = await axios.post(url, testcaseData, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        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}` },
-            });
+// 5. manage_testcase
+async function handleManageTestcase(args) {
+    const projectId = p(args, "projectId", "project_id");
+    const action = p(args, "action");
+    if (!projectId)
+        throw new Error("projectId is required");
+    if (!action)
+        throw new Error("action is required");
+    validateId(projectId, "projectId");
+    const orgId = await getOrganizationId();
+    switch (action) {
+        case "create": {
+            const title = p(args, "title", "name");
+            if (!title)
+                throw new Error("title is required for create action");
+            const testcaseData = { title };
+            if (p(args, "summary", "description"))
+                testcaseData.summary = p(args, "summary", "description");
+            if (p(args, "priority"))
+                testcaseData.priority = await coerceFieldValue(projectId, "priority", p(args, "priority"));
+            const rawFolderId = p(args, "folder_id", "folderId");
+            if (rawFolderId) {
+                const numFolderId = Number(rawFolderId);
+                testcaseData.folder_id = isNaN(numFolderId) ? rawFolderId : numFolderId;
+            }
+            const labelsRaw = p(args, "labels");
+            if (labelsRaw) {
+                testcaseData.labels =
+                    typeof labelsRaw === "string"
+                        ? labelsRaw.split(",").map((l) => l.trim()).filter(Boolean)
+                        : labelsRaw;
+            }
+            if (p(args, "precondition"))
+                testcaseData.precondition = p(args, "precondition");
+            if (p(args, "status"))
+                testcaseData.status = await coerceFieldValue(projectId, "status", p(args, "status"));
+            if (p(args, "automated"))
+                testcaseData.automated = await coerceFieldValue(projectId, "automated", p(args, "automated"));
+            if (p(args, "test_data"))
+                testcaseData.test_data = p(args, "test_data");
+            if (p(args, "expected_result"))
+                testcaseData.expected_result = p(args, "expected_result");
+            if (p(args, "platform"))
+                testcaseData.platform = await coerceFieldValue(projectId, "platform", p(args, "platform"));
+            const featuresRaw = p(args, "features");
+            if (featuresRaw) {
+                testcaseData.features = typeof featuresRaw === "string"
+                    ? featuresRaw.split(",").map((s) => s.trim())
+                    : featuresRaw;
+            }
+            const envRaw = p(args, "environment");
+            if (envRaw) {
+                testcaseData.environment = typeof envRaw === "string"
+                    ? envRaw.split(",").map((s) => s.trim())
+                    : envRaw;
+            }
+            const ownerId = p(args, "owner_id", "ownerId");
+            if (ownerId) {
+                const num = Number(ownerId);
+                testcaseData.owner_id = isNaN(num) ? ownerId : num;
+            }
+            const customFieldsRaw = p(args, "custom_fields", "customFields");
+            if (customFieldsRaw) {
+                const parsed = safeJsonParse(customFieldsRaw, "custom_fields");
+                for (const key of Object.keys(parsed)) {
+                    if (!Array.isArray(parsed[key])) {
+                        parsed[key] = [parsed[key]];
+                    }
+                }
+                testcaseData.custom_fields = parsed;
+            }
+            // Parse test_steps
+            const stepsRaw = p(args, "test_steps", "testSteps", "steps");
+            const testSteps = stepsRaw ? safeJsonParse(stepsRaw, "test_steps") : null;
+            // Step 1: Create testcase
+            const createResult = await callApi("post", `projects/testcases/create-testcase/${projectId}`, { body: testcaseData });
+            // Step 2: Add test steps if provided
+            const created = createResult?.data || createResult;
+            const tcId = created?.id || created?.testcaseId;
+            if (testSteps && Array.isArray(testSteps) && testSteps.length > 0 && tcId) {
+                // Backend endpoint accepts a single step per call, so loop through each step
+                for (const s of testSteps) {
+                    const step = {
+                        description: s.description || s.step,
+                        test_data: s.test_data,
+                        expected_result: s.expected_result,
+                    };
+                    await callApi("post", `projects/testcases/teststeps/${projectId}/${tcId}`, {
+                        body: step,
+                    });
+                }
+            }
+            if (tcId) {
+                const created2 = createResult?.data || createResult;
+                if (created2 && typeof created2 === "object") {
+                    created2.url = `${getFrontendBaseUrl()}/${projectId}/testcases/${tcId}`;
+                }
+            }
+            return jsonResponseWithHints(createResult, [
+                "To update fields, use manage_testcase(action='update', ids='<id>', field='<name>', value='<value>')",
+            ]);
         }
-        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 (handles test_steps internally)
-async function handleCreateBulkTestcase(args) {
-    validateAuth();
-    const projectId = getProjectId(args.projectId);
-    const organizationId = await getOrganizationId(args.organizationId);
-    // Handle different param names AI might use
-    const rawTestcases = args.testcases || args.test_cases || args.items;
-    if (!rawTestcases)
-        throw new Error("testcases is required (JSON array of testcases)");
-    const testcases = typeof rawTestcases === 'string' ? JSON.parse(rawTestcases) : rawTestcases;
-    // Normalize each testcase and separate test_steps for later processing
-    const testcasesWithSteps = testcases.map((tc) => {
-        // Normalize field names for each testcase
-        const normalized = {
-            title: tc.title || tc.name || tc.testcase_title,
-        };
-        if (tc.summary || tc.description)
-            normalized.summary = tc.summary || tc.description;
-        if (tc.priority)
-            normalized.priority = tc.priority;
-        if (tc.folder_id || tc.folderId)
-            normalized.folder_id = tc.folder_id || tc.folderId;
-        return {
-            testcase: normalized,
-            test_steps: tc.test_steps || tc.testSteps || tc.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 {
-        // 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}` },
-        });
-        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++;
+        case "create_bulk": {
+            const rawTestcases = p(args, "testcases", "test_cases", "items");
+            if (!rawTestcases)
+                throw new Error("testcases is required for create_bulk action");
+            const testcases = safeJsonParse(rawTestcases, "testcases");
+            // Separate test_steps for post-creation
+            const withSteps = testcases.map((tc) => {
+                const normalized = { title: tc.title || tc.name };
+                if (tc.summary || tc.description)
+                    normalized.summary = tc.summary || tc.description;
+                if (tc.priority)
+                    normalized.priority = tc.priority;
+                const rawFolderId = tc.folder_id || tc.folderId;
+                if (rawFolderId) {
+                    const numFolderId = Number(rawFolderId);
+                    normalized.folder_id = isNaN(numFolderId) ? rawFolderId : numFolderId;
+                }
+                if (tc.labels) {
+                    normalized.labels = typeof tc.labels === "string"
+                        ? tc.labels.split(",").map((l) => l.trim()).filter(Boolean)
+                        : tc.labels;
+                }
+                if (tc.precondition)
+                    normalized.precondition = tc.precondition;
+                if (tc.status)
+                    normalized.status = tc.status;
+                if (tc.automated)
+                    normalized.automated = tc.automated;
+                return {
+                    testcase: normalized,
+                    test_steps: tc.test_steps || tc.testSteps || tc.steps,
+                };
+            });
+            const cleanTestcases = withSteps.map((t) => t.testcase);
+            const bulkResult = await callApi("post", `projects/testcases/create-bulk-testcase/${projectId}`, { body: { testcases: cleanTestcases } });
+            // Add test steps for each created testcase
+            const results = bulkResult?.results || [];
+            let stepsCreated = 0;
+            for (let i = 0; i < results.length; i++) {
+                const r = results[i];
+                const steps = withSteps[i]?.test_steps;
+                if (r.status === "success" && steps?.length) {
+                    const tcId = r.testcaseId || r.id;
+                    if (tcId) {
+                        try {
+                            // Backend endpoint accepts a single step per call, so loop through each step
+                            for (const s of steps) {
+                                const step = {
+                                    description: s.description || s.step,
+                                    test_data: s.test_data,
+                                    expected_result: s.expected_result,
+                                };
+                                await callApi("post", `projects/testcases/teststeps/${projectId}/${tcId}`, {
+                                    body: step,
+                                });
+                            }
+                            stepsCreated++;
+                        }
+                        catch {
+                            // Non-fatal: steps failed but testcase was created
+                        }
                     }
-                    catch (e) {
-                        // Log but don't fail the whole operation
-                        console.error(`Failed to create steps for testcase ${testcaseId}`);
+                }
+            }
+            return jsonResponse({ ...bulkResult, steps_created_for: stepsCreated });
+        }
+        case "update": {
+            const ids = p(args, "ids", "testcase_ids", "testcaseIds");
+            const field = p(args, "field", "field_name", "fieldName");
+            const value = p(args, "value", "field_value", "fieldValue", "new_value");
+            if (!ids)
+                throw new Error("ids is required for update action");
+            if (!field)
+                throw new Error("field is required for update action");
+            if (value === undefined)
+                throw new Error("value is required for update action");
+            const idsStr = Array.isArray(ids) ? ids.join(",") : String(ids);
+            // Coerce field values for project-specific fields
+            const coercibleFields = ["priority", "status", "automated", "platform"];
+            // Parse value for fields that expect non-string types
+            let parsedValue = value;
+            if (field === "folder_id" || field === "owner_id") {
+                const num = Number(value);
+                parsedValue = isNaN(num) ? value : num;
+            }
+            else if (coercibleFields.includes(field)) {
+                parsedValue = await coerceFieldValue(projectId, field, value);
+            }
+            else if (field === "labels" || field === "features" || field === "environment") {
+                parsedValue = typeof value === "string" ? value.split(",").map((s) => s.trim()).filter(Boolean) : value;
+            }
+            else if (field === "custom_fields") {
+                const parsed = safeJsonParse(value, "custom_fields");
+                // Backend requires all custom field values as arrays
+                for (const key of Object.keys(parsed)) {
+                    if (!Array.isArray(parsed[key])) {
+                        parsed[key] = [parsed[key]];
                     }
                 }
+                parsedValue = parsed;
             }
+            const data = await callApi("patch", `projects/testcases/update-field/${projectId}`, {
+                body: { ids: idsStr, [field]: parsedValue },
+            });
+            return jsonResponse(data);
         }
-        return formatResponse(response.data, `Bulk Testcases Created (${stepsCreated} with test steps)`);
-    }
-    catch (error) {
-        throw handleApiError(error);
+        case "delete": {
+            const ids = p(args, "ids", "testcase_ids", "testcaseIds");
+            if (!ids)
+                throw new Error("ids is required for delete action");
+            const idsStr = Array.isArray(ids) ? ids.join(",") : String(ids);
+            const data = await callApi("delete", `projects/testcases/delete-testcase/${projectId}`, {
+                query: { ids: idsStr },
+            });
+            return jsonResponse(data);
+        }
+        default:
+            throw new Error(`Unknown action: ${action}. Use: create, create_bulk, update, delete`);
     }
 }
-// Handler for update_testcase_field tool
-async function handleUpdateTestcaseField(args) {
-    validateAuth();
-    const projectId = getProjectId(args.projectId);
-    const organizationId = await getOrganizationId(args.organizationId);
-    // Handle different param names AI might use
-    const ids = args.ids || args.testcase_ids || args.testcaseIds;
-    const field = args.field || args.field_name || args.fieldName;
-    const value = args.value || args.field_value || args.fieldValue || args.new_value;
-    if (!ids)
-        throw new Error("ids is required (comma-separated testcase IDs)");
-    if (!field)
-        throw new Error("field is required");
-    if (value === undefined)
-        throw new Error("value is required");
-    const queryParams = new URLSearchParams();
-    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: ids.split(','),
-            field: field,
-            value: value,
-        }, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Testcase Field Updated");
-    }
-    catch (error) {
-        throw handleApiError(error);
+// 6. manage_folder
+async function handleManageFolder(args) {
+    const projectId = p(args, "projectId", "project_id");
+    const action = p(args, "action");
+    if (!projectId)
+        throw new Error("projectId is required");
+    if (!action)
+        throw new Error("action is required");
+    validateId(projectId, "projectId");
+    const section = p(args, "section") || "TESTCASE";
+    const orgId = await getOrganizationId();
+    switch (action) {
+        case "create": {
+            const name = p(args, "name", "folder_name");
+            if (!name)
+                throw new Error("name is required for create action");
+            const body = {
+                organizationId: orgId,
+                projectId,
+                section,
+                name,
+            };
+            const parentId = p(args, "parentId", "parent_id");
+            if (parentId)
+                body.parentId = parentId;
+            const data = await callApi("post", "folders/create-folders", { body, skipOrgId: true });
+            return jsonResponse(data);
+        }
+        case "rename": {
+            const folderId = p(args, "folderId", "folder_id", "id");
+            const name = p(args, "name", "folder_name");
+            if (!folderId)
+                throw new Error("folderId is required for rename action");
+            if (!name)
+                throw new Error("name is required for rename action");
+            validateId(folderId, "folderId");
+            const data = await callApi("patch", `folders/${folderId}`, {
+                query: { projectId, section },
+                body: { name },
+            });
+            return jsonResponse(data);
+        }
+        case "move": {
+            const folderId = p(args, "folderId", "folder_id", "id");
+            if (!folderId)
+                throw new Error("folderId is required for move action");
+            validateId(folderId, "folderId");
+            const parentId = p(args, "parentId", "parent_id");
+            const data = await callApi("patch", `folders/${folderId}/move`, {
+                query: { projectId, section },
+                body: { parentId: parentId ?? null },
+            });
+            return jsonResponse(data);
+        }
+        case "delete": {
+            const folderId = p(args, "folderId", "folder_id", "id");
+            if (!folderId)
+                throw new Error("folderId is required for delete action");
+            validateId(folderId, "folderId");
+            const data = await callApi("delete", `folders/delete/${folderId}`, {
+                query: { projectId, section },
+            });
+            return jsonResponse(data);
+        }
+        default:
+            throw new Error(`Unknown action: ${action}. Use: create, rename, move, delete`);
     }
 }
-// Handler for delete_testcase tool
-async function handleDeleteTestcase(args) {
-    validateAuth();
-    const projectId = getProjectId(args.projectId);
-    const organizationId = await getOrganizationId(args.organizationId);
-    // Handle different param names AI might use
-    const ids = args.ids || args.testcase_ids || args.testcaseIds;
-    if (!ids)
-        throw new Error("ids is required (comma-separated testcase IDs)");
-    const queryParams = new URLSearchParams();
-    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}` },
-            data: { ids: ids.split(',') },
+// 7. search_test_cycles
+async function handleSearchTestCycles(args) {
+    const projectId = p(args, "projectId", "project_id");
+    if (!projectId)
+        throw new Error("projectId is required");
+    validateId(projectId, "projectId");
+    const data = await callApi("get", `projects/test-cycles/get-test-cycles/${projectId}`, {
+        query: {
+            search: p(args, "search"),
+            folderId: p(args, "folderId", "folder_id"),
+            status: p(args, "status"),
+            page: p(args, "page"),
+            limit: p(args, "limit"),
+        },
+    });
+    const baseUrl = getFrontendBaseUrl();
+    if (Array.isArray(data?.data)) {
+        data.data.forEach((cycle) => {
+            if (cycle.id)
+                cycle.url = `${baseUrl}/${projectId}/testcycles/${cycle.id}`;
         });
-        return formatResponse(response.data, "Testcase Deleted");
-    }
-    catch (error) {
-        throw handleApiError(error);
     }
+    return jsonResponse(data);
 }
-// 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`;
-    // Handle different param names AI might use
-    const folderName = args.name || args.folder_name;
-    if (!folderName) {
-        throw new Error("Folder name is required. Provide 'name' parameter.");
-    }
-    const parentId = args.parentId || args.parent_id;
-    const body = {
-        organizationId: organizationId,
-        projectId: projectId,
-        section: "TESTCASE",
-        name: folderName,
-        ...(parentId && { parentId: parentId }),
-    };
-    try {
-        const response = await axios.post(url, body, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Folder Created");
-    }
-    catch (error) {
-        throw handleApiError(error);
+// 8. manage_test_cycle
+async function handleManageTestCycle(args) {
+    const projectId = p(args, "projectId", "project_id");
+    const action = p(args, "action");
+    if (!projectId)
+        throw new Error("projectId is required");
+    if (!action)
+        throw new Error("action is required");
+    validateId(projectId, "projectId");
+    switch (action) {
+        case "create": {
+            const title = p(args, "title");
+            if (!title)
+                throw new Error("title is required for create action");
+            const body = { title };
+            if (p(args, "summary"))
+                body.summary = p(args, "summary");
+            if (p(args, "status"))
+                body.status = p(args, "status");
+            if (p(args, "planned_start_date", "plannedStartDate"))
+                body.planned_start_date = p(args, "planned_start_date", "plannedStartDate");
+            if (p(args, "planned_end_date", "plannedEndDate"))
+                body.planned_end_date = p(args, "planned_end_date", "plannedEndDate");
+            if (p(args, "folder_id", "folderId"))
+                body.folder_id = p(args, "folder_id", "folderId");
+            const data = await callApi("post", `projects/test-cycles/create-test-cycle/${projectId}`, { body });
+            return jsonResponse(data);
+        }
+        case "update": {
+            const cycleId = p(args, "cycleId", "cycle_id", "id");
+            if (!cycleId)
+                throw new Error("cycleId is required for update action");
+            const body = { id: cycleId };
+            if (p(args, "title"))
+                body.title = p(args, "title");
+            if (p(args, "summary"))
+                body.summary = p(args, "summary");
+            if (p(args, "status"))
+                body.status = p(args, "status");
+            if (p(args, "planned_start_date", "plannedStartDate"))
+                body.planned_start_date = p(args, "planned_start_date", "plannedStartDate");
+            if (p(args, "planned_end_date", "plannedEndDate"))
+                body.planned_end_date = p(args, "planned_end_date", "plannedEndDate");
+            if (p(args, "folder_id", "folderId"))
+                body.folder_id = p(args, "folder_id", "folderId");
+            const data = await callApi("post", `projects/test-cycles/create-test-cycle/${projectId}`, { body });
+            return jsonResponse(data);
+        }
+        case "delete": {
+            const ids = p(args, "ids", "cycleId", "cycle_id");
+            if (!ids)
+                throw new Error("ids (or cycleId) is required for delete action");
+            const idsStr = Array.isArray(ids) ? ids.join(",") : String(ids);
+            const data = await callApi("delete", `projects/test-cycles/delete-test-cycle/${projectId}`, { body: { ids: idsStr } });
+            return jsonResponse(data);
+        }
+        case "get_details": {
+            const cycleId = p(args, "cycleId", "cycle_id", "id");
+            if (!cycleId)
+                throw new Error("cycleId is required for get_details action");
+            validateId(cycleId, "cycleId");
+            const data = await callApi("get", `projects/test-cycles/get-test-cycle-details/${projectId}/${cycleId}`);
+            if (data?.data) {
+                data.data.url = `${getFrontendBaseUrl()}/${projectId}/testcycles/${cycleId}`;
+            }
+            return jsonResponse(data);
+        }
+        case "get_testcases": {
+            const cycleId = p(args, "cycleId", "cycle_id", "id");
+            if (!cycleId)
+                throw new Error("cycleId is required for get_testcases action");
+            validateId(cycleId, "cycleId");
+            const data = await callApi("get", `projects/test-cycles/testcases/${projectId}/${cycleId}`, {
+                query: {
+                    search: p(args, "search"),
+                    page: p(args, "page"),
+                    limit: p(args, "limit"),
+                },
+            });
+            return jsonResponse(data);
+        }
+        case "link_testcases": {
+            const cycleId = p(args, "cycleId", "cycle_id", "id");
+            const tcIds = p(args, "testcase_ids", "testcaseIds");
+            if (!cycleId)
+                throw new Error("cycleId is required for link_testcases action");
+            if (!tcIds)
+                throw new Error("testcase_ids is required for link_testcases action");
+            validateId(cycleId, "cycleId");
+            const idsStr = Array.isArray(tcIds) ? tcIds.join(",") : String(tcIds);
+            const data = await callApi("post", `projects/test-cycles/testcases/link/${projectId}/${cycleId}`, { body: { ids: idsStr } });
+            return jsonResponse(data);
+        }
+        case "unlink_testcases": {
+            const cycleId = p(args, "cycleId", "cycle_id", "id");
+            const tcIds = p(args, "testcase_ids", "testcaseIds");
+            if (!cycleId)
+                throw new Error("cycleId is required for unlink_testcases action");
+            if (!tcIds)
+                throw new Error("testcase_ids is required for unlink_testcases action");
+            validateId(cycleId, "cycleId");
+            const idsStr = Array.isArray(tcIds) ? tcIds.join(",") : String(tcIds);
+            const data = await callApi("delete", `projects/test-cycles/testcases/unlink/${projectId}/${cycleId}`, { body: { ids: idsStr } });
+            return jsonResponse(data);
+        }
+        case "assign_testcases": {
+            const cycleId = p(args, "cycleId", "cycle_id", "id");
+            const tcIds = p(args, "testcase_ids", "testcaseIds");
+            const assigneeId = p(args, "assignee_id", "assigneeId");
+            if (!cycleId)
+                throw new Error("cycleId is required for assign_testcases action");
+            if (!tcIds)
+                throw new Error("testcase_ids is required for assign_testcases action");
+            if (!assigneeId)
+                throw new Error("assignee_id is required for assign_testcases action");
+            validateId(cycleId, "cycleId");
+            const idsStr = Array.isArray(tcIds) ? tcIds.join(",") : String(tcIds);
+            const data = await callApi("patch", `projects/test-cycles/testcases/assign/${projectId}/${cycleId}`, { body: { ids: idsStr, assignee: Number(assigneeId) } });
+            return jsonResponse(data);
+        }
+        default:
+            throw new Error(`Unknown action: ${action}. Use: create, update, delete, get_details, get_testcases, link_testcases, unlink_testcases, assign_testcases`);
     }
 }
-// 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", organizationId.toString());
-    const url = `${config.apiBaseUrl}/api/v1/projects/labels/create/${projectId}?${queryParams.toString()}`;
-    // Handle different param names AI might use
-    const rawValues = args.values || args.labels || args.label_names || args.names;
-    if (!rawValues)
-        throw new Error("values is required (comma-separated label names)");
-    // Parse values from comma-separated string
-    const values = typeof rawValues === 'string' ? rawValues.split(',').map((v) => v.trim()) : rawValues;
-    try {
-        const response = await axios.post(url, { values }, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "Label Created");
-    }
-    catch (error) {
-        throw handleApiError(error);
+// 9. execute_tests
+async function handleExecuteTests(args) {
+    const projectId = p(args, "projectId", "project_id");
+    const cycleId = p(args, "cycleId", "cycle_id");
+    const resultsRaw = p(args, "results");
+    if (!projectId)
+        throw new Error("projectId is required");
+    if (!cycleId)
+        throw new Error("cycleId is required");
+    if (!resultsRaw)
+        throw new Error("results is required");
+    validateId(projectId, "projectId");
+    validateId(cycleId, "cycleId");
+    const results = safeJsonParse(resultsRaw, "results");
+    if (!Array.isArray(results) || results.length === 0) {
+        throw new Error("results must be a non-empty array");
     }
-}
-// Handler for get_user_profile tool
-async function handleGetUserProfile(args) {
-    validateAuth();
-    const url = `${config.apiBaseUrl}/api/v1/auth/me`;
-    try {
-        const response = await axios.get(url, {
-            headers: { "Content-Type": "application/json", "Authorization": `Bearer ${config.patToken}` },
-        });
-        return formatResponse(response.data, "User Profile");
+    // Validate all results have required fields
+    for (const r of results) {
+        if (!r.testcase_id && !r.testcaseId) {
+            throw new Error("testcase_id is required in each result");
+        }
+        if (!r.execution_status && !r.executionStatus) {
+            throw new Error("execution_status is required in each result. Valid values: pass, fail, blocked, not_executed");
+        }
     }
-    catch (error) {
-        throw handleApiError(error);
+    // Single result → use PATCH update-execution endpoint
+    if (results.length === 1) {
+        const r = results[0];
+        const testcaseId = r.testcase_id || r.testcaseId;
+        const body = {
+            execution_status: r.execution_status || r.executionStatus,
+        };
+        if (r.actual_result || r.actualResult)
+            body.actual_result = r.actual_result || r.actualResult;
+        if (r.environment)
+            body.environment = r.environment;
+        const data = await callApi("patch", `projects/test-cycles/testcases/update-execution/${projectId}/${cycleId}/${testcaseId}`, { body });
+        return jsonResponse(data);
     }
+    // Multiple results → use POST execute-bulk endpoint
+    const bulkResults = results.map((r) => ({
+        testcase_id: r.testcase_id || r.testcaseId,
+        execution_status: r.execution_status || r.executionStatus,
+        ...(r.actual_result || r.actualResult
+            ? { actual_result: r.actual_result || r.actualResult }
+            : {}),
+        ...(r.environment ? { environment: r.environment } : {}),
+    }));
+    const data = await callApi("post", `projects/test-cycles/execute-bulk/${projectId}/${cycleId}`, { body: { results: bulkResults } });
+    return jsonResponse(data);
 }
-// Handler for set_active_project tool
-async function handleSetActiveProject(args) {
-    // Handle different param names AI might use
-    const projectId = args.projectId || args.project_id;
-    if (!projectId) {
+// 10. manage_test_plan
+async function handleManageTestPlan(args) {
+    const projectId = p(args, "projectId", "project_id");
+    const action = p(args, "action");
+    if (!projectId)
         throw new Error("projectId is required");
-    }
-    setActiveProject(projectId);
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Active project set to: ${projectId}\n\nYou can now use other tools without specifying projectId.`,
-            },
-        ],
-    };
-}
-// 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.",
+    if (!action)
+        throw new Error("action is required");
+    validateId(projectId, "projectId");
+    switch (action) {
+        case "create": {
+            const title = p(args, "title");
+            if (!title)
+                throw new Error("title is required for create action");
+            const body = { title };
+            if (p(args, "summary"))
+                body.summary = p(args, "summary");
+            if (p(args, "status"))
+                body.status = p(args, "status");
+            if (p(args, "planned_start_date", "plannedStartDate"))
+                body.planned_start_date = p(args, "planned_start_date", "plannedStartDate");
+            if (p(args, "planned_end_date", "plannedEndDate"))
+                body.planned_end_date = p(args, "planned_end_date", "plannedEndDate");
+            if (p(args, "folder_id", "folderId"))
+                body.folder_id = p(args, "folder_id", "folderId");
+            const data = await callApi("post", `projects/test-plans/create-test-plan/${projectId}`, { body });
+            return jsonResponse(data);
+        }
+        case "update": {
+            const planId = p(args, "planId", "plan_id", "id");
+            if (!planId)
+                throw new Error("planId is required for update action");
+            const body = { id: planId };
+            if (p(args, "title"))
+                body.title = p(args, "title");
+            if (p(args, "summary"))
+                body.summary = p(args, "summary");
+            if (p(args, "status"))
+                body.status = p(args, "status");
+            if (p(args, "planned_start_date", "plannedStartDate"))
+                body.planned_start_date = p(args, "planned_start_date", "plannedStartDate");
+            if (p(args, "planned_end_date", "plannedEndDate"))
+                body.planned_end_date = p(args, "planned_end_date", "plannedEndDate");
+            if (p(args, "folder_id", "folderId"))
+                body.folder_id = p(args, "folder_id", "folderId");
+            const data = await callApi("post", `projects/test-plans/create-test-plan/${projectId}`, { body });
+            return jsonResponse(data);
+        }
+        case "delete": {
+            const ids = p(args, "ids", "planId", "plan_id");
+            if (!ids)
+                throw new Error("ids (or planId) is required for delete action");
+            const idsStr = Array.isArray(ids) ? ids.join(",") : String(ids);
+            const data = await callApi("delete", `projects/test-plans/delete-test-plan/${projectId}`, { body: { ids: idsStr } });
+            return jsonResponse(data);
+        }
+        case "list": {
+            const data = await callApi("get", `projects/test-plans/get-test-plans/${projectId}`, {
+                query: {
+                    search: p(args, "search"),
+                    page: p(args, "page"),
+                    limit: p(args, "limit"),
                 },
-            ],
-        };
+            });
+            const baseUrl = getFrontendBaseUrl();
+            if (Array.isArray(data?.data)) {
+                data.data.forEach((plan) => {
+                    if (plan.id)
+                        plan.url = `${baseUrl}/${projectId}/testplans/${plan.id}`;
+                });
+            }
+            return jsonResponse(data);
+        }
+        case "get_details": {
+            const planId = p(args, "planId", "plan_id", "id");
+            if (!planId)
+                throw new Error("planId is required for get_details action");
+            validateId(planId, "planId");
+            const data = await callApi("get", `projects/test-plans/get-test-plan-details/${projectId}/${planId}`);
+            if (data?.data) {
+                data.data.url = `${getFrontendBaseUrl()}/${projectId}/testplans/${planId}`;
+            }
+            return jsonResponse(data);
+        }
+        case "link_cycles": {
+            const planId = p(args, "planId", "plan_id", "id");
+            const cycleIds = p(args, "cycle_ids", "cycleIds");
+            if (!planId)
+                throw new Error("planId is required for link_cycles action");
+            if (!cycleIds)
+                throw new Error("cycle_ids is required for link_cycles action");
+            validateId(planId, "planId");
+            const idsStr = Array.isArray(cycleIds) ? cycleIds.join(",") : String(cycleIds);
+            const data = await callApi("post", `projects/test-plans/testcycles/link/${projectId}/${planId}`, { body: { ids: idsStr } });
+            return jsonResponse(data);
+        }
+        case "unlink_cycles": {
+            const planId = p(args, "planId", "plan_id", "id");
+            const cycleIds = p(args, "cycle_ids", "cycleIds");
+            if (!planId)
+                throw new Error("planId is required for unlink_cycles action");
+            if (!cycleIds)
+                throw new Error("cycle_ids is required for unlink_cycles action");
+            validateId(planId, "planId");
+            const idsStr = Array.isArray(cycleIds) ? cycleIds.join(",") : String(cycleIds);
+            const data = await callApi("delete", `projects/test-plans/testcycles/unlink/${projectId}/${planId}`, { body: { ids: idsStr } });
+            return jsonResponse(data);
+        }
+        case "get_cycles": {
+            const planId = p(args, "planId", "plan_id", "id");
+            if (!planId)
+                throw new Error("planId is required for get_cycles action");
+            validateId(planId, "planId");
+            const data = await callApi("get", `projects/test-plans/testcycles/list/${projectId}/${planId}`, {
+                query: {
+                    search: p(args, "search"),
+                    page: p(args, "page"),
+                    limit: p(args, "limit"),
+                },
+            });
+            return jsonResponse(data);
+        }
+        case "get_testcases": {
+            const planId = p(args, "planId", "plan_id", "id");
+            if (!planId)
+                throw new Error("planId is required for get_testcases action");
+            validateId(planId, "planId");
+            const data = await callApi("get", `projects/test-plans/testcases/list/${projectId}/${planId}`, {
+                query: {
+                    search: p(args, "search"),
+                    page: p(args, "page"),
+                    limit: p(args, "limit"),
+                },
+            });
+            return jsonResponse(data);
+        }
+        default:
+            throw new Error(`Unknown action: ${action}. Use: create, update, delete, list, get_details, link_cycles, unlink_cycles, get_cycles, get_testcases`);
     }
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Current active project: ${projectId}`,
-            },
-        ],
-    };
 }
-// Helper function to validate authentication
-function validateAuth() {
-    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.");
-    }
-    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.");
+// 11. get_report
+async function handleGetReport(args) {
+    const projectId = p(args, "projectId", "project_id");
+    const reportType = p(args, "report_type", "reportType");
+    if (!projectId)
+        throw new Error("projectId is required");
+    validateId(projectId, "projectId");
+    if (!reportType)
+        throw new Error("report_type is required");
+    const endpointPath = REPORT_TYPE_MAP[reportType];
+    if (!endpointPath) {
+        throw new Error(`Unknown report_type: ${reportType}. Valid types: ${Object.keys(REPORT_TYPE_MAP).join(", ")}`);
     }
+    const query = {};
+    // Common filters
+    if (p(args, "test_cycle_ids", "testCycleIds", "testCycleId"))
+        query.testCycleId = p(args, "test_cycle_ids", "testCycleIds", "testCycleId");
+    if (p(args, "test_plan_ids", "testPlanIds", "testPlanId"))
+        query.testPlanId = p(args, "test_plan_ids", "testPlanIds", "testPlanId");
+    if (p(args, "startDate", "start_date"))
+        query.startDate = p(args, "startDate", "start_date");
+    if (p(args, "endDate", "end_date"))
+        query.endDate = p(args, "endDate", "end_date");
+    if (p(args, "granularity"))
+        query.granularity = p(args, "granularity");
+    // cycle_comparison specific
+    if (p(args, "cycle_ids", "cycleIds"))
+        query.cycleIds = p(args, "cycle_ids", "cycleIds");
+    const data = await callApi("get", `projects/reports/${endpointPath}/${projectId}`, {
+        query,
+    });
+    return jsonResponse(data);
 }
-// Helper function to format API response
-function formatResponse(data, title) {
-    let resultText = `# ${title}\n\n`;
-    resultText += "```json\n";
-    resultText += JSON.stringify(data, null, 2);
-    resultText += "\n```\n";
-    return {
-        content: [
-            {
-                type: "text",
-                text: resultText,
-            },
-        ],
-    };
-}
-// Helper function to handle API errors
-function handleApiError(error) {
-    if (axios.isAxiosError(error)) {
-        const axiosError = error;
-        let errorMessage = `API request failed: ${axiosError.message}`;
-        if (axiosError.response) {
-            errorMessage += `\nStatus: ${axiosError.response.status}`;
-            errorMessage += `\nResponse: ${JSON.stringify(axiosError.response.data)}`;
+// ═══════════════════════════════════════════════════════════════════════════════
+// SERVER SETUP
+// ═══════════════════════════════════════════════════════════════════════════════
+const server = new Server({ name: "testkase-mcp-server", version: "2.2.0" }, { capabilities: { tools: {} } });
+// List all 11 tools
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        LIST_PROJECTS_TOOL,
+        GET_PROJECT_STRUCTURE_TOOL,
+        SEARCH_TESTCASES_TOOL,
+        GET_TESTCASE_TOOL,
+        MANAGE_TESTCASE_TOOL,
+        MANAGE_FOLDER_TOOL,
+        SEARCH_TEST_CYCLES_TOOL,
+        MANAGE_TEST_CYCLE_TOOL,
+        EXECUTE_TESTS_TOOL,
+        MANAGE_TEST_PLAN_TOOL,
+        GET_REPORT_TOOL,
+    ],
+}));
+// Route tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "list_projects":
+                return await handleListProjects(args);
+            case "get_project_structure":
+                return await handleGetProjectStructure(args);
+            case "search_testcases":
+                return await handleSearchTestcases(args);
+            case "get_testcase":
+                return await handleGetTestcase(args);
+            case "manage_testcase":
+                return await handleManageTestcase(args);
+            case "manage_folder":
+                return await handleManageFolder(args);
+            case "search_test_cycles":
+                return await handleSearchTestCycles(args);
+            case "manage_test_cycle":
+                return await handleManageTestCycle(args);
+            case "execute_tests":
+                return await handleExecuteTests(args);
+            case "manage_test_plan":
+                return await handleManageTestPlan(args);
+            case "get_report":
+                return await handleGetReport(args);
+            default:
+                throw new Error(`Unknown tool: ${name}`);
         }
-        return new Error(errorMessage);
     }
-    return error;
-}
-// Start the server
+    catch (error) {
+        const err = axios.isAxiosError(error) ? handleApiError(error) : (error instanceof Error ? error : new Error(String(error)));
+        const enrichedMessage = enrichErrorMessage(err.message);
+        return {
+            content: [{ type: "text", text: `Error: ${enrichedMessage}` }],
+            isError: true,
+        };
+    }
+});
+// Start
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("TestKase MCP Server running on stdio");
+    console.error("TestKase MCP Server v2.2.0 running on stdio (11 tools)");
 }
 main().catch((error) => {
     console.error("Fatal error in main():", error);