@browserstack/mcp-server 1.2.7 → 1.2.8

package/dist/lib/tm-base-url.d.ts

@@ -0,0 +1,2 @@
+import { BrowserStackConfig } from "./types.js";
+export declare function getTMBaseURL(config: BrowserStackConfig): Promise<string>;

package/dist/lib/tm-base-url.js

@@ -0,0 +1,37 @@
+import { apiClient } from "./apiClient.js";
+import logger from "../logger.js";
+import { getBrowserStackAuth } from "./get-auth.js";
+const TM_BASE_URLS = [
+    "https://test-management.browserstack.com",
+    "https://test-management-eu.browserstack.com",
+    "https://test-management-in.browserstack.com",
+];
+let cachedBaseUrl = null;
+export async function getTMBaseURL(config) {
+    if (cachedBaseUrl) {
+        logger.debug(`Using cached TM base URL: ${cachedBaseUrl}`);
+        return cachedBaseUrl;
+    }
+    logger.info("No cached TM base URL found, testing available URLs with authentication");
+    const authString = getBrowserStackAuth(config);
+    const [username, password] = authString.split(":");
+    const authHeader = "Basic " + Buffer.from(`${username}:${password}`).toString("base64");
+    for (const baseUrl of TM_BASE_URLS) {
+        try {
+            const res = await apiClient.get({
+                url: `${baseUrl}/api/v2/projects/`,
+                headers: { Authorization: authHeader },
+                raise_error: false,
+            });
+            if (res.ok) {
+                cachedBaseUrl = baseUrl;
+                logger.info(`Selected TM base URL: ${baseUrl}`);
+                return baseUrl;
+            }
+        }
+        catch (err) {
+            logger.debug(`Failed TM base URL: ${baseUrl} (${err})`);
+        }
+    }
+    throw new Error("Unable to connect to BrowserStack Test Management. Please check your credentials and network connection.Please open an issue on GitHub if the problem persists");
+}

package/dist/lib/utils.d.ts

@@ -45,7 +45,7 @@ export declare function handleMCPError(toolName: string, server: McpServer, conf
             [x: string]: unknown;
             src: string;
             mimeType?: string | undefined;
-            sizes?: string | undefined;
+            sizes?: string[] | undefined;
         }[] | undefined;
     } | {
         [x: string]: unknown;

package/dist/tools/appautomate-utils/appium-sdk/constants.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { AppSDKSupportedFrameworkEnum, AppSDKSupportedTestingFrameworkEnum, AppSDKSupportedLanguageEnum, AppSDKSupportedPlatformEnum } from "./index.js";
+import { AppSDKSupportedFrameworkEnum, AppSDKSupportedTestingFrameworkEnum, AppSDKSupportedLanguageEnum } from "./index.js";
 export declare const APP_DEVICE_CONFIGS: {
     android: {
         deviceName: string;
@@ -12,12 +12,37 @@ export declare const APP_DEVICE_CONFIGS: {
 };
 export declare const STEP_DELIMITER = "---STEP---";
 export declare const DEFAULT_APP_PATH = "bs://sample.app";
+export declare const MobileDeviceSchema: z.ZodObject<{
+    platform: z.ZodEnum<["android", "ios"]>;
+    deviceName: z.ZodString;
+    osVersion: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    platform: "android" | "ios";
+    deviceName: string;
+    osVersion: string;
+}, {
+    platform: "android" | "ios";
+    deviceName: string;
+    osVersion: string;
+}>;
 export declare const SETUP_APP_AUTOMATE_DESCRIPTION = "Set up BrowserStack App Automate SDK integration for Appium-based mobile app testing. ONLY for Appium based framework . This tool configures SDK for various languages with appium. For pre-built Espresso or XCUITest test suites, use 'runAppTestsOnBrowserStack' instead.";
 export declare const SETUP_APP_AUTOMATE_SCHEMA: {
     detectedFramework: z.ZodNativeEnum<typeof AppSDKSupportedFrameworkEnum>;
     detectedTestingFramework: z.ZodNativeEnum<typeof AppSDKSupportedTestingFrameworkEnum>;
     detectedLanguage: z.ZodNativeEnum<typeof AppSDKSupportedLanguageEnum>;
-    devices: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodTuple<[z.ZodLiteral<AppSDKSupportedPlatformEnum.android>, z.ZodString, z.ZodString], null>, z.ZodTuple<[z.ZodLiteral<AppSDKSupportedPlatformEnum.ios>, z.ZodString, z.ZodString], null>]>, "many">>;
+    devices: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        platform: z.ZodEnum<["android", "ios"]>;
+        deviceName: z.ZodString;
+        osVersion: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        platform: "android" | "ios";
+        deviceName: string;
+        osVersion: string;
+    }, {
+        platform: "android" | "ios";
+        deviceName: string;
+        osVersion: string;
+    }>, "many">>;
     appPath: z.ZodString;
     project: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 };

package/dist/tools/appautomate-utils/appium-sdk/constants.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { AppSDKSupportedFrameworkEnum, AppSDKSupportedTestingFrameworkEnum, AppSDKSupportedLanguageEnum, AppSDKSupportedPlatformEnum, } from "./index.js";
+import { AppSDKSupportedFrameworkEnum, AppSDKSupportedTestingFrameworkEnum, AppSDKSupportedLanguageEnum, } from "./index.js";
 // App Automate specific device configurations
 export const APP_DEVICE_CONFIGS = {
     android: [
@@ -17,6 +17,15 @@ export const APP_DEVICE_CONFIGS = {
 export const STEP_DELIMITER = "---STEP---";
 // Default app path for examples
 export const DEFAULT_APP_PATH = "bs://sample.app";
+export const MobileDeviceSchema = z.object({
+    platform: z
+        .enum(["android", "ios"])
+        .describe("Platform name: 'android' or 'ios'"),
+    deviceName: z
+        .string()
+        .describe("Device name, e.g. 'Samsung Galaxy S24', 'Google Pixel 8', 'iPhone 15', 'iPhone 14 Pro'"),
+    osVersion: z.string().describe("OS version, e.g. '14', '16', '17', 'latest'"),
+});
 // Tool description and schema for setupBrowserStackAppAutomateTests
 export const SETUP_APP_AUTOMATE_DESCRIPTION = "Set up BrowserStack App Automate SDK integration for Appium-based mobile app testing. ONLY for Appium based framework . This tool configures SDK for various languages with appium. For pre-built Espresso or XCUITest test suites, use 'runAppTestsOnBrowserStack' instead.";
 export const SETUP_APP_AUTOMATE_SCHEMA = {
@@ -30,26 +39,7 @@ export const SETUP_APP_AUTOMATE_SCHEMA = {
         .nativeEnum(AppSDKSupportedLanguageEnum)
         .describe("The programming language used in the project. Supports Java and C#. Example: 'java', 'csharp'"),
     devices: z
-        .array(z.union([
-        // Android: [android, deviceName, osVersion]
-        z.tuple([
-            z
-                .literal(AppSDKSupportedPlatformEnum.android)
-                .describe("Platform identifier: 'android'"),
-            z
-                .string()
-                .describe("Device name, e.g. 'Samsung Galaxy S24', 'Google Pixel 8'"),
-            z.string().describe("Android version, e.g. '14', '16', 'latest'"),
-        ]),
-        // iOS: [ios, deviceName, osVersion]
-        z.tuple([
-            z
-                .literal(AppSDKSupportedPlatformEnum.ios)
-                .describe("Platform identifier: 'ios'"),
-            z.string().describe("Device name, e.g. 'iPhone 15', 'iPhone 14 Pro'"),
-            z.string().describe("iOS version, e.g. '17', '16', 'latest'"),
-        ]),
-    ]))
+        .array(MobileDeviceSchema)
         .max(3)
         .default([])
         .describe("Tuples describing target mobile devices. Add device only when user asks explicitly for it. Defaults to [] . Example: [['android', 'Samsung Galaxy S24', '14'], ['ios', 'iPhone 15', '17']]"),

package/dist/tools/appautomate-utils/appium-sdk/handler.js

@@ -12,7 +12,11 @@ export async function setupAppAutomateHandler(rawInput, config) {
     // Use variables for all major input properties
     const testingFramework = input.detectedTestingFramework;
     const language = input.detectedLanguage;
-    const inputDevices = input.devices ?? [];
+    const inputDevices = input.devices?.map((device) => [
+        device.platform,
+        device.deviceName,
+        device.osVersion,
+    ]) ?? [];
     const appPath = input.appPath;
     const framework = input.detectedFramework;
     //Validating if supported framework or not

package/dist/tools/appautomate-utils/native-execution/constants.d.ts

@@ -1,11 +1,35 @@
 import { z } from "zod";
 import { AppTestPlatform } from "./types.js";
-import { AppSDKSupportedPlatformEnum } from "../appium-sdk/types.js";
 export declare const RUN_APP_AUTOMATE_DESCRIPTION = "Execute pre-built native mobile test suites (Espresso for Android, XCUITest for iOS) by direct upload to BrowserStack. ONLY for compiled .apk/.ipa test files. This is NOT for SDK integration or Appium tests. For Appium-based testing with SDK setup, use 'setupBrowserStackAppAutomateTests' instead.";
+export declare const MobileDeviceSchema: z.ZodObject<{
+    platform: z.ZodEnum<["android", "ios"]>;
+    deviceName: z.ZodString;
+    osVersion: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    platform: "android" | "ios";
+    deviceName: string;
+    osVersion: string;
+}, {
+    platform: "android" | "ios";
+    deviceName: string;
+    osVersion: string;
+}>;
 export declare const RUN_APP_AUTOMATE_SCHEMA: {
     appPath: z.ZodString;
     testSuitePath: z.ZodString;
-    devices: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodTuple<[z.ZodLiteral<AppSDKSupportedPlatformEnum.android>, z.ZodString, z.ZodString], null>, z.ZodTuple<[z.ZodLiteral<AppSDKSupportedPlatformEnum.ios>, z.ZodString, z.ZodString], null>]>, "many">>;
+    devices: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        platform: z.ZodEnum<["android", "ios"]>;
+        deviceName: z.ZodString;
+        osVersion: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        platform: "android" | "ios";
+        deviceName: string;
+        osVersion: string;
+    }, {
+        platform: "android" | "ios";
+        deviceName: string;
+        osVersion: string;
+    }>, "many">>;
     project: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     detectedAutomationFramework: z.ZodNativeEnum<typeof AppTestPlatform>;
 };

package/dist/tools/appautomate-utils/native-execution/constants.js

@@ -1,7 +1,15 @@
 import { z } from "zod";
 import { AppTestPlatform } from "./types.js";
-import { AppSDKSupportedPlatformEnum } from "../appium-sdk/types.js";
 export const RUN_APP_AUTOMATE_DESCRIPTION = `Execute pre-built native mobile test suites (Espresso for Android, XCUITest for iOS) by direct upload to BrowserStack. ONLY for compiled .apk/.ipa test files. This is NOT for SDK integration or Appium tests. For Appium-based testing with SDK setup, use 'setupBrowserStackAppAutomateTests' instead.`;
+export const MobileDeviceSchema = z.object({
+    platform: z
+        .enum(["android", "ios"])
+        .describe("Platform name: 'android' or 'ios'"),
+    deviceName: z
+        .string()
+        .describe("Device name, e.g. 'Samsung Galaxy S24', 'Google Pixel 8', 'iPhone 15', 'iPhone 14 Pro'"),
+    osVersion: z.string().describe("OS version, e.g. '14', '16', '17', 'latest'"),
+});
 export const RUN_APP_AUTOMATE_SCHEMA = {
     appPath: z
         .string()
@@ -24,26 +32,7 @@ export const RUN_APP_AUTOMATE_SCHEMA = {
         "  zip -r Tests.zip *.xctestrun *-Runner.app\n\n" +
         "If in other directory, provide existing test file path"),
     devices: z
-        .array(z.union([
-        // Android: [android, deviceName, osVersion]
-        z.tuple([
-            z
-                .literal(AppSDKSupportedPlatformEnum.android)
-                .describe("Platform identifier: 'android'"),
-            z
-                .string()
-                .describe("Device name, e.g. 'Samsung Galaxy S24', 'Google Pixel 8'"),
-            z.string().describe("Android version, e.g. '14', '16', 'latest'"),
-        ]),
-        // iOS: [ios, deviceName, osVersion]
-        z.tuple([
-            z
-                .literal(AppSDKSupportedPlatformEnum.ios)
-                .describe("Platform identifier: 'ios'"),
-            z.string().describe("Device name, e.g. 'iPhone 15', 'iPhone 14 Pro'"),
-            z.string().describe("iOS version, e.g. '17', '16', 'latest'"),
-        ]),
-    ]))
+        .array(MobileDeviceSchema)
         .max(3)
         .default([])
         .describe("Tuples describing target mobile devices. Add device only when user asks explicitly for it. Defaults to [] . Example: [['android', 'Samsung Galaxy S24', '14'], ['ios', 'iPhone 15', '17']]"),

package/dist/tools/appautomate.js

@@ -229,7 +229,8 @@ export default function addAppAutomationTools(server, config) {
     tools.runAppTestsOnBrowserStack = server.tool("runAppTestsOnBrowserStack", RUN_APP_AUTOMATE_DESCRIPTION, RUN_APP_AUTOMATE_SCHEMA, async (args) => {
         try {
             trackMCP("runAppTestsOnBrowserStack", server.server.getClientVersion(), undefined, config);
-            return await runAppTestsOnBrowserStack(args, config);
+            const devicesAsArrays = args.devices.map((device) => [device.platform, device.deviceName, device.osVersion]);
+            return await runAppTestsOnBrowserStack({ ...args, devices: devicesAsArrays }, config);
         }
         catch (error) {
             trackMCP("runAppTestsOnBrowserStack", server.server.getClientVersion(), error, config);

package/dist/tools/sdk-utils/bstack/sdkHandler.js

@@ -7,9 +7,28 @@ export async function runBstackSDKOnly(input, config, isPercyAutomate = false) {
     const steps = [];
     const authString = getBrowserStackAuth(config);
     const [username, accessKey] = authString.split(":");
-    // Validate devices against real BrowserStack device data
-    const tupleTargets = input.devices;
-    const validatedEnvironments = await validateDevices(tupleTargets || [], input.detectedBrowserAutomationFramework);
+    const tupleTargets = input.devices?.map((device) => {
+        const platform = device.platform.toLowerCase();
+        if (platform === "windows" || platform === "macos") {
+            // Desktop: ["platform", "osVersion", "browser", "browserVersion"]
+            return [
+                platform,
+                device.osVersion || "latest",
+                device.browser || "",
+                device.browserVersion || "latest",
+            ];
+        }
+        else {
+            // Mobile: ["platform", "deviceName", "osVersion", "browser"]
+            return [
+                platform,
+                device.deviceName || "",
+                device.osVersion || "latest",
+                device.browser || "",
+            ];
+        }
+    }) || [];
+    const validatedEnvironments = await validateDevices(tupleTargets, input.detectedBrowserAutomationFramework);
     // Handle frameworks with unique setup instructions that don't use browserstack.yml
     if (input.detectedBrowserAutomationFramework === "cypress" ||
         input.detectedTestingFramework === "webdriverio") {

package/dist/tools/sdk-utils/common/constants.d.ts

@@ -6,6 +6,6 @@ export declare const RUN_ON_BROWSERSTACK_DESCRIPTION = "Set up and run automated
 export declare const SIMULATE_PERCY_CHANGE_DESCRIPTION = "Integrate Percy visual testing into new projects and demonstrate visual change detection through a step-by-step simulation. This tool handles initial Percy integration, setup, and creates a working demonstration for new users. Primary tool for prompts like: \"Integrate percy for this project\", \"Integrate percy in this project {project_name}\"";
 export declare const PERCY_REPLACE_REGEX: RegExp;
 export declare const PERCY_SNAPSHOT_INSTRUCTION = "\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n";
-export declare const PERCY_SIMULATE_INSTRUCTION = "\nMANDATORY: Aggressive, Accurate Percy Snapshots Integration\n\nPrerequisite: Before making any code changes in the user's repository, create and switch to a new branch named browserstack-simulation. Stage all changes but do not commit them. If the repository has not been initialized yet, run git init first.\n\nYou MUST follow these steps with NO EXCEPTIONS:\n1. Identify 4-5 key test files in the project that are critical for visual testing.\n2. For EACH identified test file, analyze the code to find EVERY location where a Percy snapshot should be called (e.g., after each navigation, UI change, or significant state in tests).\n3. Insert snapshot calls at ALL such points, not just the first or most obvious one.\n\nIteratively update every selected test file with percy snapshot calls at all identified points, ensuring comprehensive coverage of visual changes.";
-export declare const PERCY_SIMULATION_DRIVER_INSTRUCTION = "\nMANDATORY: Step-by-Step Percy Visual Change Simulation\nYou MUST follow these steps with NO EXCEPTIONS:\n\nSTEP 1: At this case we have added Percy snapshot commands to the test files at the appropriate locations (e.g., after navigation, UI change, or significant state). \n- Use ONLY existing snapshot names.\n- Do NOT add any popup injection or visual changes yet.\n- Do NOT run any Percy builds at this stage.\n\nSTEP 2: Run ONE comprehensive baseline Percy build that executes ALL tests containing Percy snapshots in a SINGLE build. This creates one baseline build with all snapshots for comparison. Use a command like: npx percy exec --label=mcp -- python -m pytest tests/ -k 'test_name1 or test_name2 or test_name3' -v to run multiple specific tests in one build.\"\n\nSTEP 3: Modify your test to inject a visible UI change (such as a popup) IMMEDIATELY BEFORE an EXISTING snapshot command (e.g., before percy_snapshot(self.driver, \"screenshot name\")).\n- Do NOT add a new snapshot name for the popup.\n- The popup must appear in an existing snapshot, not a new one.\n- Add this popup code in some test files before the percy_snapshot command you've added, to display the visual changes.\n\n```Javascript\npopup_script = `\nvar popup = document.createElement('div');\npopup.id = 'percy-test-popup';\npopup.style.cssText = popup.style.cssText = `\n  /* TODO: Add styles to make the popup large, centered, and visually noticeable.\n     Suggested properties: position: fixed; top/left; transform; background; color; font-size; padding; z-index; animation, etc. */\n`;\npopup.innerHTML = 'PERCY TEST<br>VISUAL CHANGE<br>DETECTED!';\ndocument.body.appendChild(popup);\n`;\n\n# Insert this just before the EXISTING snapshot command:\ndriver.execute_script(popup_script)\npercy_snapshot(self.driver, \"Before Adding to Cart\")  # (Do NOT change the snapshot name, keep existing one)\n```\n\nSTEP 4: Run a second Percy build with same label and same test command as the baseline.\n- The snapshot names must remain the same as in the baseline.\n- The visual change should now appear in the same snapshot as before.\n- Use the same build command you ran for the baseline.\n\nSTEP 5: Compare the two Percy builds to see the detected visual difference.\n\nSTEP 6: Now ask user if they want to expand percy for other testcases? If yes, call the \"expandPercyVisualTesting\" tool to enable complete coverage for the entire project.\n\nCONSTRAINTS:\n- Do NOT run any builds until explicitly instructed in the steps.\n- Do NOT add new snapshot names\u2014only use existing ones.\n- Do NOT add popup injection until the baseline is established.\n- Visual changes must appear in EXISTING snapshots, not new ones.\n\nVALIDATION CHECKPOINTS (before proceeding to the next step):\n- Are you adding only snapshot commands (not running builds)?\n- Are you reusing existing snapshot names (not creating new ones)?\n- Have you established the baseline first (before adding visual changes)\n\nCRITICAL: \nDo NOT run tests separately or create multiple builds during baseline establishment. The goal is to have exactly TWO builds total: (1) baseline build with all original snapshots, (2) modified build with the same tests but visual changes injected.\n";
+export declare const PERCY_SIMULATE_INSTRUCTION = "\nMANDATORY: Aggressive, Accurate Percy Snapshots Integration\n\nPrerequisite: Before making any code changes in the user's repository, create and switch to a new branch named percy-integration. Stage all changes but do not commit them. If the repository has not been initialized yet, run git init first.\n\nYou MUST follow these steps with NO EXCEPTIONS:\n1. Identify 4-5 key test files in the project that are critical for visual testing.\n2. For EACH identified test file, analyze the code to find EVERY location where a Percy snapshot should be called (e.g., after each navigation, UI change, or significant state in tests).\n3. Insert snapshot calls at ALL such points, not just the first or most obvious one.\n\nIteratively update every selected test file with percy snapshot calls at all identified points, ensuring comprehensive coverage of visual changes.";
+export declare const PERCY_SIMULATION_DRIVER_INSTRUCTION = "\nMANDATORY: Step-by-Step Percy Visual Change Simulation\nYou MUST follow these steps with NO EXCEPTIONS:\n\nSTEP 1: At this case we have added Percy snapshot commands to the test files at the appropriate locations (e.g., after navigation, UI change, or significant state). \n- Use ONLY existing snapshot names.\n- Do NOT add any popup injection or visual changes yet.\n- Do NOT run any Percy builds at this stage.\n\nSTEP 2: Run ONE comprehensive baseline Percy build that executes ALL tests containing Percy snapshots in a SINGLE build. This creates one baseline build with all snapshots for comparison. Use a command like: npx percy exec --labels=mcp -- python -m pytest tests/ -k 'test_name1 or test_name2 or test_name3' -v to run multiple specific tests in one build.\"\n\nSTEP 3: Modify your test to inject a visible UI change (such as a popup) IMMEDIATELY BEFORE an EXISTING snapshot command (e.g., before percy_snapshot(self.driver, \"screenshot name\")).\n- Do NOT add a new snapshot name for the popup.\n- The popup must appear in an existing snapshot, not a new one.\n- Add this popup code in some test files before the percy_snapshot command you've added, to display the visual changes.\n\n```Javascript\npopup_script = `\nvar popup = document.createElement('div');\npopup.id = 'percy-test-popup';\npopup.style.cssText = popup.style.cssText = `\n  /* TODO: Add styles to make the popup large, centered, and visually noticeable.\n     Suggested properties: position: fixed; top/left; transform; background; color; font-size; padding; z-index; animation, etc. */\n`;\npopup.innerHTML = 'PERCY TEST<br>VISUAL CHANGE<br>DETECTED!';\ndocument.body.appendChild(popup);\n`;\n\n# Insert this just before the EXISTING snapshot command:\ndriver.execute_script(popup_script)\npercy_snapshot(self.driver, \"Before Adding to Cart\")  # (Do NOT change the snapshot name, keep existing one)\n```\n\nSTEP 4: Run a second Percy build with same label and same test command as the baseline.\n- The snapshot names must remain the same as in the baseline.\n- The visual change should now appear in the same snapshot as before.\n- Use the same build command you ran for the baseline.\n\nSTEP 5: Compare the two Percy builds to see the detected visual difference.\n\nSTEP 6: Now ask user if they want to expand percy for other testcases? If yes, call the \"expandPercyVisualTesting\" tool to expand the coverage for the project.\n\nCONSTRAINTS:\n- Do NOT run any builds until explicitly instructed in the steps.\n- Do NOT add new snapshot names\u2014only use existing ones.\n- Do NOT add popup injection until the baseline is established.\n- Visual changes must appear in EXISTING snapshots, not new ones.\n\nVALIDATION CHECKPOINTS (before proceeding to the next step):\n- Are you adding only snapshot commands (not running builds)?\n- Are you reusing existing snapshot names (not creating new ones)?\n- Have you established the baseline first (before adding visual changes)\n\nCRITICAL: \nDo NOT run tests separately or create multiple builds during baseline establishment. The goal is to have exactly TWO builds total: (1) baseline build with all original snapshots, (2) modified build with the same tests but visual changes injected.\n";
 export declare const PERCY_VERIFICATION_REGEX: RegExp;

package/dist/tools/sdk-utils/common/constants.js

@@ -20,7 +20,7 @@ Process files in STRICT sequential order using tool addPercySnapshotCommands() w
 export const PERCY_SIMULATE_INSTRUCTION = `
 MANDATORY: Aggressive, Accurate Percy Snapshots Integration
 
-Prerequisite: Before making any code changes in the user's repository, create and switch to a new branch named browserstack-simulation. Stage all changes but do not commit them. If the repository has not been initialized yet, run git init first.
+Prerequisite: Before making any code changes in the user's repository, create and switch to a new branch named percy-integration. Stage all changes but do not commit them. If the repository has not been initialized yet, run git init first.
 
 You MUST follow these steps with NO EXCEPTIONS:
 1. Identify 4-5 key test files in the project that are critical for visual testing.
@@ -37,7 +37,7 @@ STEP 1: At this case we have added Percy snapshot commands to the test files at
 - Do NOT add any popup injection or visual changes yet.
 - Do NOT run any Percy builds at this stage.
 
-STEP 2: Run ONE comprehensive baseline Percy build that executes ALL tests containing Percy snapshots in a SINGLE build. This creates one baseline build with all snapshots for comparison. Use a command like: npx percy exec --label=mcp -- python -m pytest tests/ -k 'test_name1 or test_name2 or test_name3' -v to run multiple specific tests in one build."
+STEP 2: Run ONE comprehensive baseline Percy build that executes ALL tests containing Percy snapshots in a SINGLE build. This creates one baseline build with all snapshots for comparison. Use a command like: npx percy exec --labels=mcp -- python -m pytest tests/ -k 'test_name1 or test_name2 or test_name3' -v to run multiple specific tests in one build."
 
 STEP 3: Modify your test to inject a visible UI change (such as a popup) IMMEDIATELY BEFORE an EXISTING snapshot command (e.g., before percy_snapshot(self.driver, "screenshot name")).
 - Do NOT add a new snapshot name for the popup.
@@ -68,7 +68,7 @@ STEP 4: Run a second Percy build with same label and same test command as the ba
 
 STEP 5: Compare the two Percy builds to see the detected visual difference.
 
-STEP 6: Now ask user if they want to expand percy for other testcases? If yes, call the "expandPercyVisualTesting" tool to enable complete coverage for the entire project.
+STEP 6: Now ask user if they want to expand percy for other testcases? If yes, call the "expandPercyVisualTesting" tool to expand the coverage for the project.
 
 CONSTRAINTS:
 - Do NOT run any builds until explicitly instructed in the steps.

package/dist/tools/sdk-utils/common/schema.d.ts

@@ -27,11 +27,25 @@ export declare const RunTestsOnBrowserStackParamsShape: {
     detectedLanguage: z.ZodNativeEnum<typeof SDKSupportedLanguageEnum>;
     detectedBrowserAutomationFramework: z.ZodNativeEnum<typeof SDKSupportedBrowserAutomationFrameworkEnum>;
     detectedTestingFramework: z.ZodNativeEnum<typeof SDKSupportedTestingFrameworkEnum>;
-    devices: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodTuple<[z.ZodNativeEnum<{
-        readonly WINDOWS: "windows";
-    }>, z.ZodString, z.ZodString, z.ZodString], null>, z.ZodTuple<[z.ZodLiteral<"android">, z.ZodString, z.ZodString, z.ZodString], null>, z.ZodTuple<[z.ZodLiteral<"ios">, z.ZodString, z.ZodString, z.ZodString], null>, z.ZodTuple<[z.ZodNativeEnum<{
-        readonly MACOS: "macos";
-    }>, z.ZodString, z.ZodString, z.ZodString], null>]>, "many">>;
+    devices: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        platform: z.ZodEnum<["windows", "macos", "android", "ios"]>;
+        deviceName: z.ZodOptional<z.ZodString>;
+        osVersion: z.ZodString;
+        browser: z.ZodOptional<z.ZodString>;
+        browserVersion: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        platform: "android" | "windows" | "macos" | "ios";
+        osVersion: string;
+        deviceName?: string | undefined;
+        browser?: string | undefined;
+        browserVersion?: string | undefined;
+    }, {
+        platform: "android" | "windows" | "macos" | "ios";
+        osVersion: string;
+        deviceName?: string | undefined;
+        browser?: string | undefined;
+        browserVersion?: string | undefined;
+    }>, "many">>;
 };
 export declare const SetUpPercySchema: z.ZodObject<{
     projectName: z.ZodString;
@@ -63,23 +77,49 @@ export declare const RunTestsOnBrowserStackSchema: z.ZodObject<{
     detectedLanguage: z.ZodNativeEnum<typeof SDKSupportedLanguageEnum>;
     detectedBrowserAutomationFramework: z.ZodNativeEnum<typeof SDKSupportedBrowserAutomationFrameworkEnum>;
     detectedTestingFramework: z.ZodNativeEnum<typeof SDKSupportedTestingFrameworkEnum>;
-    devices: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodTuple<[z.ZodNativeEnum<{
-        readonly WINDOWS: "windows";
-    }>, z.ZodString, z.ZodString, z.ZodString], null>, z.ZodTuple<[z.ZodLiteral<"android">, z.ZodString, z.ZodString, z.ZodString], null>, z.ZodTuple<[z.ZodLiteral<"ios">, z.ZodString, z.ZodString, z.ZodString], null>, z.ZodTuple<[z.ZodNativeEnum<{
-        readonly MACOS: "macos";
-    }>, z.ZodString, z.ZodString, z.ZodString], null>]>, "many">>;
+    devices: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        platform: z.ZodEnum<["windows", "macos", "android", "ios"]>;
+        deviceName: z.ZodOptional<z.ZodString>;
+        osVersion: z.ZodString;
+        browser: z.ZodOptional<z.ZodString>;
+        browserVersion: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        platform: "android" | "windows" | "macos" | "ios";
+        osVersion: string;
+        deviceName?: string | undefined;
+        browser?: string | undefined;
+        browserVersion?: string | undefined;
+    }, {
+        platform: "android" | "windows" | "macos" | "ios";
+        osVersion: string;
+        deviceName?: string | undefined;
+        browser?: string | undefined;
+        browserVersion?: string | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     projectName: string;
     detectedLanguage: SDKSupportedLanguageEnum;
     detectedBrowserAutomationFramework: SDKSupportedBrowserAutomationFrameworkEnum;
     detectedTestingFramework: SDKSupportedTestingFrameworkEnum;
-    devices: (["windows", string, string, string] | ["android", string, string, string] | ["ios", string, string, string] | ["macos", string, string, string])[];
+    devices: {
+        platform: "android" | "windows" | "macos" | "ios";
+        osVersion: string;
+        deviceName?: string | undefined;
+        browser?: string | undefined;
+        browserVersion?: string | undefined;
+    }[];
 }, {
     projectName: string;
     detectedLanguage: SDKSupportedLanguageEnum;
     detectedBrowserAutomationFramework: SDKSupportedBrowserAutomationFrameworkEnum;
     detectedTestingFramework: SDKSupportedTestingFrameworkEnum;
-    devices?: (["windows", string, string, string] | ["android", string, string, string] | ["ios", string, string, string] | ["macos", string, string, string])[] | undefined;
+    devices?: {
+        platform: "android" | "windows" | "macos" | "ios";
+        osVersion: string;
+        deviceName?: string | undefined;
+        browser?: string | undefined;
+        browserVersion?: string | undefined;
+    }[] | undefined;
 }>;
 export type SetUpPercyInput = z.infer<typeof SetUpPercySchema>;
 export type RunTestsOnBrowserStackInput = z.infer<typeof RunTestsOnBrowserStackSchema>;

package/dist/tools/sdk-utils/common/schema.js

@@ -31,6 +31,27 @@ export const SetUpPercyParamsShape = {
         .optional()
         .describe("An array of absolute file paths to specific UI test files. Use this when you want to target specific test files rather than entire folders. If not provided, will use folderPaths instead."),
 };
+// Device schema for BrowserStack Automate (supports desktop and mobile)
+const DeviceSchema = z.object({
+    platform: z
+        .enum(["windows", "macos", "android", "ios"])
+        .describe("Platform name, e.g. 'windows', 'macos', 'android', 'ios'"),
+    deviceName: z
+        .string()
+        .optional()
+        .describe("Device name for mobile platforms, e.g. 'iPhone 15', 'Samsung Galaxy S24'"),
+    osVersion: z
+        .string()
+        .describe("OS version, e.g. '11', 'Sequoia', '14', '17', 'latest'"),
+    browser: z
+        .string()
+        .optional()
+        .describe("Browser name, e.g. 'chrome', 'safari', 'edge', 'firefox'"),
+    browserVersion: z
+        .string()
+        .optional()
+        .describe("Browser version for desktop platforms only (windows, macos), e.g. '132', 'latest', 'oldest'. Not used for mobile devices (android, ios)."),
+});
 export const RunTestsOnBrowserStackParamsShape = {
     projectName: z
         .string()
@@ -39,49 +60,10 @@ export const RunTestsOnBrowserStackParamsShape = {
     detectedBrowserAutomationFramework: z.nativeEnum(SDKSupportedBrowserAutomationFrameworkEnum),
     detectedTestingFramework: z.nativeEnum(SDKSupportedTestingFrameworkEnum),
     devices: z
-        .array(z.union([
-        // Windows: [windows, osVersion, browser, browserVersion]
-        z.tuple([
-            z
-                .nativeEnum(WindowsPlatformEnum)
-                .describe("Platform identifier: 'windows'"),
-            z.string().describe("Windows version, e.g. '10', '11'"),
-            z.string().describe("Browser name, e.g. 'chrome', 'firefox', 'edge'"),
-            z
-                .string()
-                .describe("Browser version, e.g. '132', 'latest', 'oldest'"),
-        ]),
-        // Android: [android, name, model, osVersion, browser]
-        z.tuple([
-            z
-                .literal(PlatformEnum.ANDROID)
-                .describe("Platform identifier: 'android'"),
-            z
-                .string()
-                .describe("Device name, e.g. 'Samsung Galaxy S24', 'Google Pixel 8'"),
-            z.string().describe("Android version, e.g. '14', '16', 'latest'"),
-            z.string().describe("Browser name, e.g. 'chrome', 'samsung browser'"),
-        ]),
-        // iOS: [ios, name, model, osVersion, browser]
-        z.tuple([
-            z.literal(PlatformEnum.IOS).describe("Platform identifier: 'ios'"),
-            z.string().describe("Device name, e.g. 'iPhone 12 Pro'"),
-            z.string().describe("iOS version, e.g. '17', 'latest'"),
-            z.string().describe("Browser name, typically 'safari'"),
-        ]),
-        // macOS: [mac|macos, name, model, browser, browserVersion]
-        z.tuple([
-            z
-                .nativeEnum(MacOSPlatformEnum)
-                .describe("Platform identifier: 'mac' or 'macos'"),
-            z.string().describe("macOS version name, e.g. 'Sequoia', 'Ventura'"),
-            z.string().describe("Browser name, e.g. 'safari', 'chrome'"),
-            z.string().describe("Browser version, e.g. 'latest'"),
-        ]),
-    ]))
+        .array(DeviceSchema)
         .max(3)
         .default([])
-        .describe("Preferred tuples of target devices.Add device only when user asks explicitly for it. Defaults to [] . Example: [['windows', '11', 'chrome', 'latest']]"),
+        .describe("Device objects array. Use the object format directly - no transformation needed. Add only when user explicitly requests devices. Examples: [{ platform: 'windows', osVersion: '11', browser: 'chrome', browserVersion: 'latest' }] or [{ platform: 'android', deviceName: 'Samsung Galaxy S24', osVersion: '14', browser: 'chrome' }]."),
 };
 export const SetUpPercySchema = z.object(SetUpPercyParamsShape);
 export const RunTestsOnBrowserStackSchema = z.object(RunTestsOnBrowserStackParamsShape);

package/dist/tools/testmanagement-utils/TCG-utils/api.js

@@ -2,12 +2,14 @@ import { apiClient } from "../../../lib/apiClient.js";
 import { TCG_TRIGGER_URL, TCG_POLL_URL, FETCH_DETAILS_URL, FORM_FIELDS_URL, BULK_CREATE_URL, } from "./config.js";
 import { createTestCasePayload } from "./helpers.js";
 import { getBrowserStackAuth } from "../../../lib/get-auth.js";
+import { getTMBaseURL } from "../../../lib/tm-base-url.js";
 /**
  * Fetch default and custom form fields for a project.
  */
 export async function fetchFormFields(projectId, config) {
+    const tmBaseUrl = await getTMBaseURL(config);
     const res = await apiClient.get({
-        url: FORM_FIELDS_URL(projectId),
+        url: FORM_FIELDS_URL(tmBaseUrl, projectId),
         headers: {
             "API-TOKEN": getBrowserStackAuth(config),
         },
@@ -18,8 +20,9 @@ export async function fetchFormFields(projectId, config) {
  * Trigger AI-based test case generation for a document.
  */
 export async function triggerTestCaseGeneration(document, documentId, folderId, projectId, source, config) {
+    const tmBaseUrl = await getTMBaseURL(config);
     const res = await apiClient.post({
-        url: TCG_TRIGGER_URL,
+        url: TCG_TRIGGER_URL(tmBaseUrl),
         headers: {
             "API-TOKEN": getBrowserStackAuth(config),
             "Content-Type": "application/json",
@@ -31,7 +34,7 @@ export async function triggerTestCaseGeneration(document, documentId, folderId,
             folderId,
             projectId,
             source,
-            webhookUrl: `https://test-management.browserstack.com/api/v1/projects/${projectId}/folder/${folderId}/webhooks/tcg`,
+            webhookUrl: `${tmBaseUrl}/api/v1/projects/${projectId}/folder/${folderId}/webhooks/tcg`,
         },
     });
     if (res.status !== 200) {
@@ -46,8 +49,9 @@ export async function fetchTestCaseDetails(documentId, folderId, projectId, test
     if (testCaseIds.length === 0) {
         throw new Error("No testCaseIds provided to fetchTestCaseDetails");
     }
+    const tmBaseUrl = await getTMBaseURL(config);
     const res = await apiClient.post({
-        url: FETCH_DETAILS_URL,
+        url: FETCH_DETAILS_URL(tmBaseUrl),
         headers: {
             "API-TOKEN": getBrowserStackAuth(config),
             "request-source": source,
@@ -71,11 +75,13 @@ export async function fetchTestCaseDetails(documentId, folderId, projectId, test
 export async function pollTestCaseDetails(traceRequestId, config) {
     const detailMap = {};
     let done = false;
+    const tmBaseUrl = await getTMBaseURL(config);
+    const TCG_POLL_URL_VALUE = TCG_POLL_URL(tmBaseUrl);
     while (!done) {
         // add a bit of jitter to avoid synchronized polling storms
         await new Promise((r) => setTimeout(r, 10000 + Math.random() * 5000));
         const poll = await apiClient.post({
-            url: `${TCG_POLL_URL}?x-bstack-traceRequestId=${encodeURIComponent(traceRequestId)}`,
+            url: `${TCG_POLL_URL_VALUE}?x-bstack-traceRequestId=${encodeURIComponent(traceRequestId)}`,
             headers: {
                 "API-TOKEN": getBrowserStackAuth(config),
             },
@@ -108,12 +114,14 @@ export async function pollScenariosTestDetails(args, traceId, context, documentI
     const scenariosMap = {};
     const detailPromises = [];
     let iteratorCount = 0;
+    const tmBaseUrl = await getTMBaseURL(config);
+    const TCG_POLL_URL_VALUE = TCG_POLL_URL(tmBaseUrl);
     // Promisify interval-style polling using a wrapper
     await new Promise((resolve, reject) => {
         const intervalId = setInterval(async () => {
             try {
                 const poll = await apiClient.post({
-                    url: `${TCG_POLL_URL}?x-bstack-traceRequestId=${encodeURIComponent(traceId)}`,
+                    url: `${TCG_POLL_URL_VALUE}?x-bstack-traceRequestId=${encodeURIComponent(traceId)}`,
                     headers: {
                         "API-TOKEN": getBrowserStackAuth(config),
                     },
@@ -203,6 +211,8 @@ export async function bulkCreateTestCases(scenariosMap, projectId, folderId, fie
     const total = Object.keys(scenariosMap).length;
     let doneCount = 0;
     let testCaseCount = 0;
+    const tmBaseUrl = await getTMBaseURL(config);
+    const BULK_CREATE_URL_VALUE = BULK_CREATE_URL(tmBaseUrl, projectId, folderId);
     for (const { id, testcases } of Object.values(scenariosMap)) {
         const testCaseLength = testcases.length;
         testCaseCount += testCaseLength;
@@ -213,7 +223,7 @@ export async function bulkCreateTestCases(scenariosMap, projectId, folderId, fie
         };
         try {
             const resp = await apiClient.post({
-                url: BULK_CREATE_URL(projectId, folderId),
+                url: BULK_CREATE_URL_VALUE,
                 headers: {
                     "API-TOKEN": getBrowserStackAuth(config),
                     "Content-Type": "application/json",
@@ -251,7 +261,8 @@ export async function bulkCreateTestCases(scenariosMap, projectId, folderId, fie
     return resultString;
 }
 export async function projectIdentifierToId(projectId, config) {
-    const url = `https://test-management.browserstack.com/api/v1/projects/?q=${projectId}`;
+    const tmBaseUrl = await getTMBaseURL(config);
+    const url = `${tmBaseUrl}/api/v1/projects/?q=${projectId}`;
     const response = await apiClient.get({
         url,
         headers: {
@@ -270,7 +281,8 @@ export async function projectIdentifierToId(projectId, config) {
     throw new Error(`Project with identifier ${projectId} not found.`);
 }
 export async function testCaseIdentifierToDetails(projectId, testCaseIdentifier, config) {
-    const url = `https://test-management.browserstack.com/api/v1/projects/${projectId}/test-cases/search?q[query]=${testCaseIdentifier}`;
+    const tmBaseUrl = await getTMBaseURL(config);
+    const url = `${tmBaseUrl}/api/v1/projects/${projectId}/test-cases/search?q[query]=${testCaseIdentifier}`;
     const response = await apiClient.get({
         url,
         headers: {

package/dist/tools/testmanagement-utils/TCG-utils/config.d.ts

@@ -1,5 +1,5 @@
-export declare const TCG_TRIGGER_URL = "https://test-management.browserstack.com/api/v1/integration/tcg/test-generation/suggest-test-cases";
-export declare const TCG_POLL_URL = "https://test-management.browserstack.com/api/v1/integration/tcg/test-generation/test-cases-polling";
-export declare const FETCH_DETAILS_URL = "https://test-management.browserstack.com/api/v1/integration/tcg/test-generation/fetch-test-case-details";
-export declare const FORM_FIELDS_URL: (projectId: string) => string;
-export declare const BULK_CREATE_URL: (projectId: string, folderId: string) => string;
+export declare const TCG_TRIGGER_URL: (baseUrl: string) => string;
+export declare const TCG_POLL_URL: (baseUrl: string) => string;
+export declare const FETCH_DETAILS_URL: (baseUrl: string) => string;
+export declare const FORM_FIELDS_URL: (baseUrl: string, projectId: string) => string;
+export declare const BULK_CREATE_URL: (baseUrl: string, projectId: string, folderId: string) => string;

package/dist/tools/testmanagement-utils/TCG-utils/config.js

@@ -1,5 +1,5 @@
-export const TCG_TRIGGER_URL = "https://test-management.browserstack.com/api/v1/integration/tcg/test-generation/suggest-test-cases";
-export const TCG_POLL_URL = "https://test-management.browserstack.com/api/v1/integration/tcg/test-generation/test-cases-polling";
-export const FETCH_DETAILS_URL = "https://test-management.browserstack.com/api/v1/integration/tcg/test-generation/fetch-test-case-details";
-export const FORM_FIELDS_URL = (projectId) => `https://test-management.browserstack.com/api/v1/projects/${projectId}/form-fields-v2`;
-export const BULK_CREATE_URL = (projectId, folderId) => `https://test-management.browserstack.com/api/v1/projects/${projectId}/folder/${folderId}/bulk-test-cases`;
+export const TCG_TRIGGER_URL = (baseUrl) => `${baseUrl}/api/v1/integration/tcg/test-generation/suggest-test-cases`;
+export const TCG_POLL_URL = (baseUrl) => `${baseUrl}/api/v1/integration/tcg/test-generation/test-cases-polling`;
+export const FETCH_DETAILS_URL = (baseUrl) => `${baseUrl}/api/v1/integration/tcg/test-generation/fetch-test-case-details`;
+export const FORM_FIELDS_URL = (baseUrl, projectId) => `${baseUrl}/api/v1/projects/${projectId}/form-fields-v2`;
+export const BULK_CREATE_URL = (baseUrl, projectId, folderId) => `${baseUrl}/api/v1/projects/${projectId}/folder/${folderId}/bulk-test-cases`;

package/dist/tools/testmanagement-utils/add-test-result.js

@@ -1,6 +1,7 @@
 import { apiClient } from "../../lib/apiClient.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { z } from "zod";
+import { getTMBaseURL } from "../../lib/tm-base-url.js";
 /**
  * Schema for adding a test result to a test run.
  */
@@ -28,7 +29,8 @@ export const AddTestResultSchema = z.object({
 export async function addTestResult(rawArgs, config) {
     try {
         const args = AddTestResultSchema.parse(rawArgs);
-        const url = `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs/${encodeURIComponent(args.test_run_id)}/results`;
+        const tmBaseUrl = await getTMBaseURL(config);
+        const url = `${tmBaseUrl}/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs/${encodeURIComponent(args.test_run_id)}/results`;
         const body = {
             test_result: args.test_result,
             test_case_id: args.test_case_id,

package/dist/tools/testmanagement-utils/create-lca-steps.js

@@ -3,6 +3,7 @@ import { apiClient } from "../../lib/apiClient.js";
 import { projectIdentifierToId, testCaseIdentifierToDetails, } from "./TCG-utils/api.js";
 import { pollLCAStatus } from "./poll-lca-status.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
+import { getTMBaseURL } from "../../lib/tm-base-url.js";
 /**
  * Schema for creating LCA steps for a test case
  */
@@ -55,7 +56,8 @@ export async function createLCASteps(args, context, config) {
         const projectId = await projectIdentifierToId(args.project_identifier, config);
         // Get the test case ID and folder ID from identifier
         const { testCaseId, folderId } = await testCaseIdentifierToDetails(projectId, args.test_case_identifier, config);
-        const url = `https://test-management.browserstack.com/api/v1/projects/${projectId}/test-cases/${testCaseId}/lcnc`;
+        const tmBaseUrl = await getTMBaseURL(config);
+        const url = `${tmBaseUrl}/api/v1/projects/${projectId}/test-cases/${testCaseId}/lcnc`;
         const payload = {
             base_url: args.base_url,
             credentials: args.credentials,
@@ -63,7 +65,7 @@ export async function createLCASteps(args, context, config) {
             test_name: args.test_name,
             test_case_details: args.test_case_details,
             version: "v2",
-            webhook_path: `https://test-management.browserstack.com/api/v1/projects/${projectId}/test-cases/${testCaseId}/webhooks/lcnc`,
+            webhook_path: `${tmBaseUrl}/api/v1/projects/${projectId}/test-cases/${testCaseId}/webhooks/lcnc`,
         };
         await apiClient.post({
             url,

package/dist/tools/testmanagement-utils/create-project-folder.js

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { formatAxiosError } from "../../lib/error.js";
 import { projectIdentifierToId } from "../testmanagement-utils/TCG-utils/api.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
+import { getTMBaseURL } from "../../lib/tm-base-url.js";
 // Schema for combined project/folder creation
 export const CreateProjFoldSchema = z.object({
     project_name: z
@@ -43,8 +44,9 @@ export async function createProjectOrFolder(args, config) {
         try {
             const authString = getBrowserStackAuth(config);
             const [username, password] = authString.split(":");
+            const tmBaseUrl = await getTMBaseURL(config);
             const res = await apiClient.post({
-                url: "https://test-management.browserstack.com/api/v2/projects",
+                url: `${tmBaseUrl}/api/v2/projects`,
                 headers: {
                     "Content-Type": "application/json",
                     Authorization: "Basic " +
@@ -69,8 +71,9 @@ export async function createProjectOrFolder(args, config) {
         if (!projId)
             throw new Error("Cannot create folder without project_identifier.");
         try {
+            const tmBaseUrl = await getTMBaseURL(config);
             const res = await apiClient.post({
-                url: `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(projId)}/folders`,
+                url: `${tmBaseUrl}/api/v2/projects/${encodeURIComponent(projId)}/folders`,
                 headers: {
                     "Content-Type": "application/json",
                     Authorization: "Basic " +
@@ -98,7 +101,7 @@ export async function createProjectOrFolder(args, config) {
               - ID: ${folder.id}
               - Name: ${folder.name}
               - Project Identifier: ${projId}
-            Access it here: https://test-management.browserstack.com/projects/${projectId}/folder/${folder.id}/`,
+            Access it here: ${tmBaseUrl}/projects/${projectId}/folder/${folder.id}/`,
                     },
                 ],
             };

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

@@ -2,6 +2,7 @@ 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";
 export const CreateTestCaseSchema = z.object({
     project_identifier: z
         .string()
@@ -78,8 +79,9 @@ export async function createTestCase(params, config) {
     const authString = getBrowserStackAuth(config);
     const [username, password] = authString.split(":");
     try {
+        const tmBaseUrl = await getTMBaseURL(config);
         const response = await apiClient.post({
-            url: `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(params.project_identifier)}/folders/${encodeURIComponent(params.folder_id)}/test-cases`,
+            url: `${tmBaseUrl}/api/v2/projects/${encodeURIComponent(params.project_identifier)}/folders/${encodeURIComponent(params.folder_id)}/test-cases`,
             headers: {
                 "Content-Type": "application/json",
                 Authorization: "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
@@ -109,7 +111,7 @@ export async function createTestCase(params, config) {
             - Identifier: ${tc.identifier}
             - Title: ${tc.title}
 
-          You can view it here: https://test-management.browserstack.com/projects/${projectId}/folder/search?q=${tc.identifier}`,
+          You can view it here: ${tmBaseUrl}/projects/${projectId}/folder/search?q=${tc.identifier}`,
                 },
                 {
                     type: "text",

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

@@ -2,6 +2,7 @@ import { apiClient } from "../../lib/apiClient.js";
 import { z } from "zod";
 import { formatAxiosError } from "../../lib/error.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
+import { getTMBaseURL } from "../../lib/tm-base-url.js";
 /**
  * Schema for creating a test run.
  */
@@ -54,7 +55,8 @@ export async function createTestRun(rawArgs, config) {
             },
         };
         const args = CreateTestRunSchema.parse(inputArgs);
-        const url = `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs`;
+        const tmBaseUrl = await getTMBaseURL(config);
+        const url = `${tmBaseUrl}/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs`;
         const authString = getBrowserStackAuth(config);
         const [username, password] = authString.split(":");
         const response = await apiClient.post({

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

@@ -2,6 +2,7 @@ import { apiClient } from "../../lib/apiClient.js";
 import { z } from "zod";
 import { formatAxiosError } from "../../lib/error.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
+import { getTMBaseURL } from "../../lib/tm-base-url.js";
 /**
  * Schema for listing test cases with optional filters.
  */
@@ -38,7 +39,8 @@ export async function listTestCases(args, config) {
             params.append("priority", args.priority);
         if (args.p !== undefined)
             params.append("p", args.p.toString());
-        const url = `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-cases?${params.toString()}`;
+        const tmBaseUrl = await getTMBaseURL(config);
+        const url = `${tmBaseUrl}/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-cases?${params.toString()}`;
         const authString = getBrowserStackAuth(config);
         const [username, password] = authString.split(":");
         const resp = await apiClient.get({

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

@@ -2,6 +2,7 @@ import { apiClient } from "../../lib/apiClient.js";
 import { z } from "zod";
 import { formatAxiosError } from "../../lib/error.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
+import { getTMBaseURL } from "../../lib/tm-base-url.js";
 /**
  * Schema for listing test runs with optional filters.
  */
@@ -23,7 +24,8 @@ export async function listTestRuns(args, config) {
         if (args.run_state) {
             params.set("run_state", args.run_state);
         }
-        const url = `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs?` + params.toString();
+        const tmBaseUrl = await getTMBaseURL(config);
+        const url = `${tmBaseUrl}/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs?` + params.toString();
         const authString = getBrowserStackAuth(config);
         const [username, password] = authString.split(":");
         const resp = await apiClient.get({

package/dist/tools/testmanagement-utils/poll-lca-status.js

@@ -1,5 +1,6 @@
 import { apiClient } from "../../lib/apiClient.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
+import { getTMBaseURL } from "../../lib/tm-base-url.js";
 /**
  * Poll test case details to check LCA build status
  */
@@ -7,7 +8,8 @@ export async function pollLCAStatus(projectId, folderId, testCaseId, context, ma
 initialWaitMs = 2 * 60 * 1000, // 2 minutes initial wait
 pollIntervalMs = 10 * 1000, // 10 seconds interval
 config) {
-    const url = `https://test-management.browserstack.com/api/v1/projects/${projectId}/folder/${folderId}/test-cases/${testCaseId}`;
+    const tmBaseUrl = await getTMBaseURL(config);
+    const url = `${tmBaseUrl}/api/v1/projects/${projectId}/folder/${folderId}/test-cases/${testCaseId}`;
     const startTime = Date.now();
     // Send initial notification that polling is starting
     const notificationInterval = Math.min(initialWaitMs, pollIntervalMs);

package/dist/tools/testmanagement-utils/testcase-from-file.js

@@ -3,6 +3,7 @@ import { buildDefaultFieldMaps, findBooleanFieldId, } from "./TCG-utils/helpers.
 import { signedUrlMap } from "../../lib/inmemory-store.js";
 import logger from "../../logger.js";
 import { projectIdentifierToId } from "./TCG-utils/api.js";
+import { getTMBaseURL } from "../../lib/tm-base-url.js";
 export async function createTestCasesFromFile(args, context, config) {
     logger.info(`createTestCasesFromFile called with projectId: ${args.projectReferenceId}, folderId: ${args.folderId}`);
     if (args.projectReferenceId.startsWith("PR-")) {
@@ -31,7 +32,8 @@ export async function createTestCasesFromFile(args, context, config) {
     const scenariosMap = await pollScenariosTestDetails(args, traceId, context, documentId, source, config);
     const resultString = await bulkCreateTestCases(scenariosMap, args.projectReferenceId, args.folderId, fieldMaps, booleanFieldId, traceId, context, documentId, config);
     signedUrlMap.delete(args.documentId);
-    const dashboardURL = `https://test-management.browserstack.com/projects/${args.projectReferenceId}/folder/${args.folderId}/test-cases`;
+    const tmBaseUrl = await getTMBaseURL(config);
+    const dashboardURL = `${tmBaseUrl}/projects/${args.projectReferenceId}/folder/${args.folderId}/test-cases`;
     return {
         content: [
             {

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

@@ -2,6 +2,7 @@ import { apiClient } from "../../lib/apiClient.js";
 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";
 /**
  * Schema for updating a test run with partial fields.
  */
@@ -31,7 +32,8 @@ export const UpdateTestRunSchema = z.object({
 export async function updateTestRun(args, config) {
     try {
         const body = { test_run: args.test_run };
-        const url = `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs/${encodeURIComponent(args.test_run_id)}/update`;
+        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 resp = await apiClient.patch({

package/dist/tools/testmanagement-utils/upload-file.js

@@ -7,6 +7,7 @@ import { v4 as uuidv4 } from "uuid";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { signedUrlMap } from "../../lib/inmemory-store.js";
 import { projectIdentifierToId } from "./TCG-utils/api.js";
+import { getTMBaseURL } from "../../lib/tm-base-url.js";
 /**
  * Schema for the upload file tool
  */
@@ -41,7 +42,8 @@ export async function uploadFile(args, config) {
         const projectIdResponse = await projectIdentifierToId(project_identifier, config);
         const formData = new FormData();
         formData.append("attachments[]", fs.createReadStream(file_path));
-        const uploadUrl = `https://test-management.browserstack.com/api/v1/projects/${projectIdResponse}/generic/attachments/ai_uploads`;
+        const tmBaseUrl = await getTMBaseURL(config);
+        const uploadUrl = `${tmBaseUrl}/api/v1/projects/${projectIdResponse}/generic/attachments/ai_uploads`;
         const response = await apiClient.post({
             url: uploadUrl,
             headers: {

package/package.json

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