@browserstack/mcp-server 1.2.21-beta.2 → 1.2.22-beta.1

package/README.md

@@ -85,6 +85,8 @@ Similar to the app testing, you can use the following prompts to test your **web
 Auto-analyze, diagnose, and even fix broken test scripts right in your IDE or LLM. Instantly fetch logs, identify root causes, and apply context-aware fixes. No more debugging loops.
 Below are few example prompts to run/debug/fix your automated tests on BrowserStack's [Test Platform](https://www.browserstack.com/test-platform).
 
+> **Note:** When fetching Root Cause Analysis (RCA) for a test, the server returns the suggested fix as a proposal only. It never applies code changes automatically — your assistant must present the suggestion and wait for your explicit approval before editing any files.
+
 ```bash
 #Port test suite to BrowserStack
 "Setup test suite to run on BrowserStack infra"

package/dist/tools/rca-agent-utils/format-rca.js

@@ -4,6 +4,9 @@ export function formatRCAData(rcaData) {
         return "No RCA data available.";
     }
     let output = "## Root Cause Analysis Report\n\n";
+    // Track whether any test case carries a fix suggestion so we can append the
+    // approval-gate directive only when it is relevant.
+    let hasFixSuggestion = false;
     rcaData.testCases.forEach((testCase, index) => {
         // Show test case ID with smaller heading
         output += `### Test Case ${index + 1}\n`;
@@ -22,7 +25,8 @@ export function formatRCAData(rcaData) {
                 output += `**Detailed Analysis:**\n${rca.description}\n\n`;
             }
             if (rca.possible_fix) {
-                output += `**Recommended Fix:**\n${rca.possible_fix}\n\n`;
+                hasFixSuggestion = true;
+                output += `**Suggested Fix (proposal only — do not apply without explicit user approval):**\n${rca.possible_fix}\n\n`;
             }
         }
         else if (testCase.rcaData?.error) {
@@ -33,5 +37,11 @@ export function formatRCAData(rcaData) {
         }
         output += "---\n\n";
     });
+    if (hasFixSuggestion) {
+        output +=
+            "> **Action required:** The fixes above are suggestions only. " +
+                "Present them to the user and apply code changes ONLY after the user " +
+                "explicitly approves. Do not modify any files automatically.\n";
+    }
     return output;
 }

package/dist/tools/rca-agent.js

@@ -99,7 +99,7 @@ export async function listTestIdsTool(args, config) {
 }
 export default function addRCATools(server, config) {
     const tools = {};
-    tools.fetchRCA = server.tool("fetchRCA", "Retrieves AI-RCA (Root Cause Analysis) data for a BrowserStack Automate and App-Automate session and provides insights into test failures.", FETCH_RCA_PARAMS, async (args) => {
+    tools.fetchRCA = server.tool("fetchRCA", "Fetch AI Root Cause Analysis for failed BrowserStack Automate/App-Automate tests. Suggests fixes only; never auto-apply, require explicit user approval.", FETCH_RCA_PARAMS, async (args) => {
         try {
             trackMCP("fetchRCA", server.server.getClientVersion(), undefined, config);
             return await fetchRCADataTool(args, config);

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

@@ -9,6 +9,7 @@ interface IssueTracker {
     name: string;
     host: string;
 }
+export type CustomFieldValue = string | number | boolean | Array<string | number>;
 export interface TestCaseCreateRequest {
     project_identifier: string;
     folder_id: string;
@@ -20,9 +21,10 @@ export interface TestCaseCreateRequest {
     issues?: string[];
     issue_tracker?: IssueTracker;
     tags?: string[];
-    custom_fields?: Record<string, string>;
+    custom_fields?: Record<string, CustomFieldValue>;
     automation_status?: string;
     priority?: string;
+    template?: string;
 }
 export interface TestCaseResponse {
     data: {
@@ -52,6 +54,7 @@ export interface TestCaseResponse {
         };
     };
 }
+export declare const customFieldValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
 export declare const CreateTestCaseSchema: z.ZodObject<{
     project_identifier: z.ZodString;
     folder_id: z.ZodString;
@@ -69,9 +72,10 @@ export declare const CreateTestCaseSchema: z.ZodObject<{
         host: z.ZodString;
     }, z.core.$strip>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>>;
     automation_status: z.ZodOptional<z.ZodString>;
     priority: z.ZodOptional<z.ZodString>;
+    template: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare function sanitizeArgs(args: any): any;
 export declare function createTestCase(params: TestCaseCreateRequest, config: BrowserStackConfig): Promise<CallToolResult>;

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

@@ -4,6 +4,13 @@ import { formatAxiosError } from "../../lib/error.js";
 import { fetchFormFields, normalizeDefaultFieldValue, projectIdentifierToId, } from "./TCG-utils/api.js";
 import { getTMBaseURL } from "../../lib/tm-base-url.js";
 import logger from "../../logger.js";
+// Scalar value, or an array of values for multi-select custom fields.
+export const customFieldValueSchema = z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.array(z.union([z.string(), z.number()])),
+]);
 export const CreateTestCaseSchema = z.object({
     project_identifier: z
         .string()
@@ -48,9 +55,9 @@ export const CreateTestCaseSchema = z.object({
         .optional()
         .describe("Tags to attach to the test case. This should be strictly in array format not the string of json"),
     custom_fields: z
-        .record(z.string(), z.string())
+        .record(z.string(), customFieldValueSchema)
         .optional()
-        .describe("Map of custom field names to values."),
+        .describe("Map of custom field NAME to value; use an array for multi-select fields."),
     automation_status: z
         .string()
         .optional()
@@ -59,6 +66,10 @@ export const CreateTestCaseSchema = z.object({
         .string()
         .optional()
         .describe("Priority of the test case. Accepts either display name (e.g. 'Critical', 'High', 'Medium', 'Low') or internal name (e.g. 'medium'). If omitted, the project default (usually 'Medium') is applied. Valid values are per-project and discoverable via the form-fields endpoint."),
+    template: z
+        .string()
+        .optional()
+        .describe("Template internal slug, e.g. 'test_case_steps' or 'test_case_bdd'. Use the slug, not the display name."),
 });
 export function sanitizeArgs(args) {
     const cleaned = { ...args };
@@ -70,6 +81,8 @@ export function sanitizeArgs(args) {
         delete cleaned.preconditions;
     if (cleaned.automation_status === null)
         delete cleaned.automation_status;
+    if (cleaned.template === null)
+        delete cleaned.template;
     if (cleaned.issue_tracker) {
         if (cleaned.issue_tracker.name === undefined ||
             cleaned.issue_tracker.host === undefined) {
@@ -126,22 +139,28 @@ export async function createTestCase(params, config) {
         }
         const tc = data.test_case;
         const projectId = await projectIdentifierToId(params.project_identifier, config);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Test case successfully created:
+        const content = [];
+        // The TM API silently ignores an unrecognized template slug and falls back
+        // to the default. Surface that instead of letting it pass as success.
+        if (params.template &&
+            tc.template &&
+            String(tc.template).toLowerCase() !==
+                String(params.template).toLowerCase()) {
+            content.push({
+                type: "text",
+                text: `Warning: requested template "${params.template}" was not applied — the test case was created with "${tc.template}". BrowserStack expects the template's internal slug (e.g. "test_case_steps", "test_case_bdd") and silently uses the default for unrecognized values.`,
+            });
+        }
+        content.push({
+            type: "text",
+            text: `Test case successfully created:
             - Identifier: ${tc.identifier}
             - Title: ${tc.title}
 
           You can view it here: ${tmBaseUrl}/projects/${projectId}/folder/search?q=${tc.identifier}`,
-                },
-                {
-                    type: "text",
-                    text: JSON.stringify(tc, null, 2),
-                },
-            ],
-        };
+        });
+        content.push({ type: "text", text: JSON.stringify(tc, null, 2) });
+        return { content };
     }
     catch (err) {
         // Delegate to our centralized Axios error formatter

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

@@ -18,7 +18,7 @@ export interface TestCaseUpdateRequest {
     status?: string;
     tags?: string[];
     issues?: string[];
-    custom_fields?: Record<string, string | number | boolean>;
+    custom_fields?: Record<string, string | number | boolean | Array<string | number>>;
 }
 export declare const UpdateTestCaseSchema: z.ZodObject<{
     project_identifier: z.ZodString;
@@ -37,7 +37,7 @@ export declare const UpdateTestCaseSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     issues: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>>>;
 }, z.core.$strip>;
 /**
  * Updates an existing test case in BrowserStack Test Management.

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

@@ -58,9 +58,14 @@ export const UpdateTestCaseSchema = z.object({
         .optional()
         .describe("Replacement list of linked Jira/Asana/Azure issue IDs for the test case."),
     custom_fields: z
-        .record(z.string(), z.union([z.string(), z.number(), z.boolean()]))
+        .record(z.string(), z.union([
+        z.string(),
+        z.number(),
+        z.boolean(),
+        z.array(z.union([z.string(), z.number()])),
+    ]))
         .optional()
-        .describe("Map of custom field name/id to value. Valid field names and value types are per-project; discover them via the project's form fields."),
+        .describe("Map of custom field NAME to value; use an array for multi-select fields."),
 });
 /**
  * Normalise default-field inputs (priority/case_type/automation_status) to

package/package.json

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