@browserstack/mcp-server 1.2.8-beta.1 → 1.2.8-beta.2

package/dist/tools/testmanagement-utils/update-testcase.d.ts

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { BrowserStackConfig } from "../../lib/types.js";
+export interface TestCaseUpdateRequest {
+    project_identifier: string;
+    test_case_identifier: string;
+    name?: string;
+    description?: string;
+    preconditions?: string;
+    test_case_steps?: Array<{
+        step: string;
+        result: string;
+    }>;
+}
+export declare const UpdateTestCaseSchema: z.ZodObject<{
+    project_identifier: z.ZodString;
+    test_case_identifier: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    preconditions: z.ZodOptional<z.ZodString>;
+    test_case_steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        step: z.ZodString;
+        result: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        step: string;
+        result: string;
+    }, {
+        step: string;
+        result: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    project_identifier: string;
+    test_case_identifier: string;
+    name?: string | undefined;
+    description?: string | undefined;
+    test_case_steps?: {
+        step: string;
+        result: string;
+    }[] | undefined;
+    preconditions?: string | undefined;
+}, {
+    project_identifier: string;
+    test_case_identifier: string;
+    name?: string | undefined;
+    description?: string | undefined;
+    test_case_steps?: {
+        step: string;
+        result: string;
+    }[] | undefined;
+    preconditions?: string | undefined;
+}>;
+/**
+ * Updates an existing test case in BrowserStack Test Management.
+ */
+export declare function updateTestCase(params: TestCaseUpdateRequest, config: BrowserStackConfig): Promise<CallToolResult>;

package/dist/tools/testmanagement-utils/update-testcase.js

@@ -0,0 +1,142 @@
+import { apiClient } from "../../lib/apiClient.js";
+import { z } from "zod";
+import { formatAxiosError } from "../../lib/error.js";
+import { projectIdentifierToId } from "./TCG-utils/api.js";
+import { getTMBaseURL } from "../../lib/tm-base-url.js";
+import { getBrowserStackAuth } from "../../lib/get-auth.js";
+import logger from "../../logger.js";
+export const UpdateTestCaseSchema = z.object({
+    project_identifier: z
+        .string()
+        .describe("The ID of the BrowserStack project containing the test case to update."),
+    test_case_identifier: z
+        .string()
+        .describe("The ID of the test case to update. This can be found using the listTestCases tool."),
+    name: z.string().optional().describe("Updated name of the test case."),
+    description: z
+        .string()
+        .optional()
+        .describe("Updated brief description of the test case."),
+    preconditions: z
+        .string()
+        .optional()
+        .describe("Updated preconditions for the test case."),
+    test_case_steps: z
+        .array(z.object({
+        step: z.string().describe("The action to perform in this step."),
+        result: z.string().describe("The expected result of this step."),
+    }))
+        .optional()
+        .describe("Updated list of test case steps with expected results."),
+});
+/**
+ * Updates an existing test case in BrowserStack Test Management.
+ */
+export async function updateTestCase(params, config) {
+    const authString = getBrowserStackAuth(config);
+    const [username, password] = authString.split(":");
+    // Build the request body with only the fields to update
+    const testCaseBody = {};
+    if (params.name !== undefined) {
+        testCaseBody.name = params.name;
+    }
+    if (params.description !== undefined) {
+        testCaseBody.description = params.description;
+    }
+    if (params.preconditions !== undefined) {
+        testCaseBody.preconditions = params.preconditions;
+    }
+    if (params.test_case_steps !== undefined) {
+        testCaseBody.steps = params.test_case_steps;
+    }
+    const body = { test_case: testCaseBody };
+    try {
+        const tmBaseUrl = await getTMBaseURL(config);
+        const response = await apiClient.patch({
+            url: `${tmBaseUrl}/api/v2/projects/${encodeURIComponent(params.project_identifier)}/test-cases/${encodeURIComponent(params.test_case_identifier)}`,
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
+            },
+            body,
+        });
+        const { data } = response.data;
+        if (!data.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to update test case: ${JSON.stringify(response.data)}`,
+                        isError: true,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const tc = data.test_case;
+        // Convert project identifier to project ID for dashboard URL
+        const projectId = await projectIdentifierToId(params.project_identifier, config);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Test case successfully updated:
+          
+**Test Case Details:**
+- **ID**: ${tc.identifier}
+- **Name**: ${tc.title}
+- **Description**: ${tc.description || "N/A"}
+- **Case Type**: ${tc.case_type}
+- **Priority**: ${tc.priority}
+- **Status**: ${tc.status}
+
+**View on BrowserStack Dashboard:**
+https://test-management.browserstack.com/projects/${projectId}/folders/${tc.folder_id}/test-cases/${tc.identifier}
+
+The test case has been updated successfully and is now available in your BrowserStack Test Management project.`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        logger.error("Failed to update test case: %s", err);
+        logger.error("Error details:", JSON.stringify(err.response?.data || err.message));
+        if (err.response?.status === 404) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Test case not found. Please verify the project_identifier ("${params.project_identifier}") and test_case_identifier ("${params.test_case_identifier}") are correct. Make sure to use actual values, not placeholders like "your_project_id".
+            
+Error details: ${JSON.stringify(err.response?.data || err.message)}`,
+                        isError: true,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (err.response?.status === 403) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Access denied. You don't have permission to update this test case.",
+                        isError: true,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const errorMessage = formatAxiosError(err, "Failed to update test case");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to update test case: ${errorMessage}. Please verify your credentials and try again.`,
+                    isError: true,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/testmanagement.d.ts

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import { CreateProjFoldSchema } from "./testmanagement-utils/create-project-folder.js";
 import { TestCaseCreateRequest } from "./testmanagement-utils/create-testcase.js";
+import { TestCaseUpdateRequest } from "./testmanagement-utils/update-testcase.js";
 import { ListTestCasesSchema } from "./testmanagement-utils/list-testcases.js";
 import { CreateTestRunSchema } from "./testmanagement-utils/create-testrun.js";
 import { ListTestRunsSchema } from "./testmanagement-utils/list-testruns.js";
@@ -20,6 +21,10 @@ export declare function createProjectOrFolderTool(args: z.infer<typeof CreatePro
  * Creates a test case in BrowserStack Test Management.
  */
 export declare function createTestCaseTool(args: TestCaseCreateRequest, config: BrowserStackConfig, server: McpServer): Promise<CallToolResult>;
+/**
+ * Updates an existing test case in BrowserStack Test Management.
+ */
+export declare function updateTestCaseTool(args: TestCaseUpdateRequest, config: BrowserStackConfig, server: McpServer): Promise<CallToolResult>;
 /**
  * Lists test cases in a project with optional filters (status, priority, custom fields, etc.)
  */

package/dist/tools/testmanagement.js

@@ -2,6 +2,7 @@ import { trackMCP } from "../lib/instrumentation.js";
 import logger from "../logger.js";
 import { createProjectOrFolder, CreateProjFoldSchema, } from "./testmanagement-utils/create-project-folder.js";
 import { createTestCase as createTestCaseAPI, sanitizeArgs, CreateTestCaseSchema, } from "./testmanagement-utils/create-testcase.js";
+import { updateTestCase as updateTestCaseAPI, UpdateTestCaseSchema, } from "./testmanagement-utils/update-testcase.js";
 import { listTestCases, ListTestCasesSchema, } from "./testmanagement-utils/list-testcases.js";
 import { CreateTestRunSchema, createTestRun, } from "./testmanagement-utils/create-testrun.js";
 import { ListTestRunsSchema, listTestRuns, } from "./testmanagement-utils/list-testruns.js";
@@ -60,6 +61,29 @@ export async function createTestCaseTool(args, config, server) {
         };
     }
 }
+/**
+ * Updates an existing test case in BrowserStack Test Management.
+ */
+export async function updateTestCaseTool(args, config, server) {
+    try {
+        trackMCP("updateTestCase", server.server.getClientVersion(), undefined, config);
+        return await updateTestCaseAPI(args, config);
+    }
+    catch (err) {
+        logger.error("Failed to update test case: %s", err);
+        trackMCP("updateTestCase", server.server.getClientVersion(), err, config);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to update test case: ${err instanceof Error ? err.message : "Unknown error"}. Please open an issue on GitHub if the problem persists`,
+                    isError: true,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
 /**
  * Lists test cases in a project with optional filters (status, priority, custom fields, etc.)
  */
@@ -245,6 +269,7 @@ export default function addTestManagementTools(server, config) {
     const tools = {};
     tools.createProjectOrFolder = server.tool("createProjectOrFolder", "Create a project and/or folder in BrowserStack Test Management.", CreateProjFoldSchema.shape, (args) => createProjectOrFolderTool(args, config, server));
     tools.createTestCase = server.tool("createTestCase", "Use this tool to create a test case in BrowserStack Test Management.", CreateTestCaseSchema.shape, (args) => createTestCaseTool(args, config, server));
+    tools.updateTestCase = server.tool("updateTestCase", "Use this tool to update an existing test case in BrowserStack Test Management. Allows editing test case details like name, description, steps, owner, priority, and more.", UpdateTestCaseSchema.shape, (args) => updateTestCaseTool(args, config, server));
     tools.listTestCases = server.tool("listTestCases", "List test cases in a project with optional filters (status, priority, custom fields, etc.)", ListTestCasesSchema.shape, (args) => listTestCasesTool(args, config, server));
     tools.createTestRun = server.tool("createTestRun", "Create a test run in BrowserStack Test Management.", CreateTestRunSchema.shape, (args) => createTestRunTool(args, config, server));
     tools.listTestRuns = server.tool("listTestRuns", "List test runs in a project with optional filters (date ranges, assignee, state, etc.)", ListTestRunsSchema.shape, (args) => listTestRunsTool(args, config, server));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserstack/mcp-server",
-  "version": "1.2.8-beta.1",
+  "version": "1.2.8-beta.2",
   "description": "BrowserStack's Official MCP Server",
   "mcpName": "io.github.browserstack/mcp-server",
   "main": "dist/index.js",