@browserstack/mcp-server 1.2.25 → 1.2.27-beta.2

package/README.md

@@ -334,7 +334,7 @@ As of now we support 20 tools.
   List all test runs from the 'Shopping App' project that were executed last week and are currently marked in-progress
   ```
 
- 6. `updateTestRun` — Partially update a test run (status, tags, notes, associated test cases).
+ 6. `updateTestRun` — Update a test run's name/state and/or add test cases to it.
   **Prompt example**
 
   ```text

package/dist/tools/testmanagement-utils/list-testcases.js

@@ -65,7 +65,13 @@ export async function listTestCases(args, config) {
         const count = info?.count ?? test_cases.length;
         // Summary for more focused output
         const summary = test_cases
-            .map((tc) => `• ${tc.identifier}: ${tc.title} [${tc.case_type} | ${tc.priority}]`)
+            .map((tc) => {
+            const links = (tc.issues ?? [])
+                .filter((i) => i?.issue_type && i?.jira_id)
+                .map((i) => `${i.issue_type}:${i.jira_id}`)
+                .join(", ");
+            return `• ${tc.identifier}: ${tc.title} [${tc.case_type} | ${tc.priority}]${links ? ` {linked: ${links}}` : ""}`;
+        })
             .join("\n");
         return {
             content: [

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

@@ -17,11 +17,26 @@ export declare const UpdateTestRunSchema: z.ZodObject<{
             rejected: "rejected";
             closed: "closed";
         }>>;
+        add_test_cases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            test_case_ids: z.ZodArray<z.ZodString>;
+            configuration_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        preserve_existing_results: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 type UpdateTestRunArgs = z.infer<typeof UpdateTestRunSchema>;
 /**
  * Partially updates an existing test run.
+ *
+ * Dispatches to one of two BrowserStack endpoints based on the fields provided,
+ * mirroring how the platform splits these concerns across two endpoints:
+ *  - metadata (name / run_state) -> PATCH .../test-runs/{id}/update
+ *  - adding test cases -> PATCH .../test-runs/{id}/test-cases
+ *
+ * Either or both may be supplied in one call; each provided concern hits its
+ * own endpoint and both outcomes are reported. At least one must be provided.
+ * Removing test cases is intentionally not exposed — this tool is
+ * non-destructive.
  */
 export declare function updateTestRun(args: UpdateTestRunArgs, config: BrowserStackConfig): Promise<CallToolResult>;
 export {};

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

@@ -3,6 +3,19 @@ import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { z } from "zod";
 import { formatAxiosError } from "../../lib/error.js";
 import { getTMBaseURL } from "../../lib/tm-base-url.js";
+/**
+ * Selection of test cases (with optional configurations) to add.
+ */
+const TestCaseSelectionSchema = z.object({
+    test_case_ids: z
+        .array(z.string())
+        .min(1)
+        .describe("Test case IDs, e.g. TC-123"),
+    configuration_ids: z
+        .array(z.number())
+        .optional()
+        .describe("Configuration IDs to apply"),
+});
 /**
  * Schema for updating a test run with partial fields.
  */
@@ -24,22 +37,82 @@ export const UpdateTestRunSchema = z.object({
         ])
             .optional()
             .describe("Updated state of the test run"),
+        add_test_cases: z
+            .array(TestCaseSelectionSchema)
+            .optional()
+            .describe("Test cases to add to the run"),
+        preserve_existing_results: z
+            .boolean()
+            .optional()
+            .describe("Keep existing results when adding cases (default true)"),
     }),
 });
+/**
+ * Builds the HTTP Basic auth header from per-request config credentials.
+ */
+function buildAuthHeader(config) {
+    return "Basic " + Buffer.from(getBrowserStackAuth(config)).toString("base64");
+}
 /**
  * Partially updates an existing test run.
+ *
+ * Dispatches to one of two BrowserStack endpoints based on the fields provided,
+ * mirroring how the platform splits these concerns across two endpoints:
+ *  - metadata (name / run_state) -> PATCH .../test-runs/{id}/update
+ *  - adding test cases -> PATCH .../test-runs/{id}/test-cases
+ *
+ * Either or both may be supplied in one call; each provided concern hits its
+ * own endpoint and both outcomes are reported. At least one must be provided.
+ * Removing test cases is intentionally not exposed — this tool is
+ * non-destructive.
  */
 export async function updateTestRun(args, config) {
+    const { name, run_state, add_test_cases } = args.test_run;
+    const addIds = add_test_cases?.flatMap((s) => s.test_case_ids) ?? [];
+    const hasTestCases = addIds.length > 0;
+    const hasMetadata = name !== undefined || run_state !== undefined;
+    if (!hasTestCases && !hasMetadata) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Nothing to update: provide name/run_state and/or add_test_cases.",
+                },
+            ],
+            isError: true,
+        };
+    }
+    const tmBaseUrl = await getTMBaseURL(config);
+    const authHeader = buildAuthHeader(config);
+    const tasks = [];
+    if (hasMetadata) {
+        tasks.push(updateTestRunMetadata(args, tmBaseUrl, authHeader));
+    }
+    if (hasTestCases) {
+        tasks.push(updateTestRunTestCases(args, tmBaseUrl, authHeader));
+    }
+    const results = await Promise.all(tasks);
+    if (results.length === 1) {
+        return results[0];
+    }
+    // Both concerns updated: aggregate outcomes; surface an error if either failed.
+    return {
+        content: results.flatMap((r) => r.content),
+        isError: results.some((r) => r.isError),
+    };
+}
+/**
+ * Updates test run metadata (name / run_state) via the /update endpoint.
+ */
+async function updateTestRunMetadata(args, baseUrl, authHeader) {
     try {
-        const body = { test_run: args.test_run };
-        const tmBaseUrl = await getTMBaseURL(config);
-        const url = `${tmBaseUrl}/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs/${encodeURIComponent(args.test_run_id)}/update`;
-        const authString = getBrowserStackAuth(config);
-        const [username, password] = authString.split(":");
+        const { name, run_state } = args.test_run;
+        const body = { test_run: { name, run_state } };
+        const url = `${baseUrl}/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs/${encodeURIComponent(args.test_run_id)}/update`;
         const resp = await apiClient.patch({
             url,
             headers: {
-                Authorization: "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
+                Authorization: authHeader,
                 "Content-Type": "application/json",
             },
             body,
@@ -70,3 +143,52 @@ export async function updateTestRun(args, config) {
         return formatAxiosError(err, "Failed to update test run");
     }
 }
+/**
+ * Adds test cases to a run via the /test-cases endpoint.
+ * This call is applied asynchronously by the backend.
+ */
+async function updateTestRunTestCases(args, baseUrl, authHeader) {
+    try {
+        const { add_test_cases, preserve_existing_results } = args.test_run;
+        const body = {
+            test_run: {
+                add_test_cases,
+                preserve_existing_results: preserve_existing_results ?? true,
+            },
+        };
+        const url = `${baseUrl}/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs/${encodeURIComponent(args.test_run_id)}/test-cases`;
+        const resp = await apiClient.patch({
+            url,
+            headers: {
+                Authorization: authHeader,
+                "Content-Type": "application/json",
+            },
+            body,
+        });
+        const data = resp.data;
+        if (!data.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to update test run test cases: ${JSON.stringify(data)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const added = add_test_cases?.flatMap((s) => s.test_case_ids) ?? [];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Queued test-case update for ${args.test_run_id} (added ${added.length}); changes apply asynchronously.`,
+                },
+                { type: "text", text: JSON.stringify(data, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        return formatAxiosError(err, "Failed to update test run test cases");
+    }
+}

package/dist/tools/testmanagement.js

@@ -400,7 +400,7 @@ export default function addTestManagementTools(server, config) {
     tools.listTestCaseTemplates = server.tool("listTestCaseTemplates", "List test-case templates with their numeric template_id. Use the id with createTestCase to apply a custom template (the 'template' slug only selects system templates).", ListTemplatesSchema.shape, (args) => listTemplatesTool(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));
-    tools.updateTestRun = server.tool("updateTestRun", "Update a test run in BrowserStack Test Management.", UpdateTestRunSchema.shape, (args) => updateTestRunTool(args, config, server));
+    tools.updateTestRun = server.tool("updateTestRun", "Update a test run's metadata and/or add test cases to it.", UpdateTestRunSchema.shape, (args) => updateTestRunTool(args, config, server));
     tools.addTestResult = server.tool("addTestResult", "Add a test result to a specific test run via BrowserStack Test Management API.", AddTestResultSchema.shape, (args) => addTestResultTool(args, config, server));
     tools.uploadProductRequirementFile = server.tool("uploadProductRequirementFile", "Upload files (e.g., PDRs, PDFs) to BrowserStack Test Management and retrieve a file mapping ID. This is utilized for generating test cases from files and is part of the Test Case Generator AI Agent in BrowserStack.", UploadFileSchema.shape, (args) => uploadProductRequirementFileTool(args, config, server));
     tools.createTestCasesFromFile = server.tool("createTestCasesFromFile", "Generate test cases from a file in BrowserStack Test Management using the Test Case Generator AI Agent.", CreateTestCasesFromFileSchema.shape, (args, context) => createTestCasesFromFileTool(args, context, config, server));

package/package.json

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