@browserstack/mcp-server 2.2.2 → 2.2.3-beta.2

package/dist/config.d.ts

@@ -1,3 +1,5 @@
+declare const GRR_REGIONS: readonly ["us", "eu", "in"];
+export type GrrRegion = (typeof GRR_REGIONS)[number];
 /**
  * USE_OWN_LOCAL_BINARY_PROCESS:
  *   If true, the system will not start a new local binary process, but will use the user's own process.
@@ -26,6 +28,7 @@ export declare class Config {
      * "deferred" | "elicit". Anything else is ignored.
      */
     readonly ASK_BROWSERSTACK_RELAY_TRANSPORT: string | undefined;
+    readonly BROWSERSTACK_GRR_REGION: GrrRegion;
     constructor(DEV_MODE: boolean, browserstackLocalOptions: Record<string, any>, USE_OWN_LOCAL_BINARY_PROCESS: boolean, REMOTE_MCP: boolean, UPLOAD_BASE_DIR: string | undefined, O11Y_TFA_RCA_BASE_URL: string, BROWSERSTACK_AUTOMATION_BASE_URL: string, BROWSERSTACK_O11Y_UI_BASE_URL: string, ASK_BROWSERSTACK_ATLAS_URL: string | undefined, ASK_BROWSERSTACK_AUTH_TOKEN_URL: string | undefined, 
     /**
      * Which relay transport to use, overriding what the deployment implies.
@@ -39,7 +42,7 @@ export declare class Config {
      *
      * "deferred" | "elicit". Anything else is ignored.
      */
-    ASK_BROWSERSTACK_RELAY_TRANSPORT: string | undefined);
+    ASK_BROWSERSTACK_RELAY_TRANSPORT: string | undefined, BROWSERSTACK_GRR_REGION?: GrrRegion);
 }
 declare const config: Config;
 export default config;

package/dist/config.js

@@ -34,6 +34,17 @@ const DEFAULT_O11Y_TFA_RCA_BASE_URL = "https://api-automation.browserstack.com";
 const DEFAULT_BROWSERSTACK_AUTOMATION_BASE_URL = "https://api-automation.browserstack.com";
 // Overridable via BROWSERSTACK_O11Y_UI_BASE_URL to point at a staging UI.
 const DEFAULT_BROWSERSTACK_O11Y_UI_BASE_URL = "https://automation.browserstack.com";
+// BROWSERSTACK_GRR_REGION: "us" (default), "eu" or "in". Invalid values fail at startup.
+const GRR_REGIONS = ["us", "eu", "in"];
+function parseGrrRegion(raw) {
+    const value = (raw || "").trim().toLowerCase();
+    if (!value)
+        return "us";
+    if (GRR_REGIONS.includes(value)) {
+        return value;
+    }
+    throw new Error(`Invalid BROWSERSTACK_GRR_REGION "${raw}". Use one of: ${GRR_REGIONS.join(", ")}.`);
+}
 /**
  * USE_OWN_LOCAL_BINARY_PROCESS:
  *   If true, the system will not start a new local binary process, but will use the user's own process.
@@ -50,6 +61,7 @@ export class Config {
     ASK_BROWSERSTACK_ATLAS_URL;
     ASK_BROWSERSTACK_AUTH_TOKEN_URL;
     ASK_BROWSERSTACK_RELAY_TRANSPORT;
+    BROWSERSTACK_GRR_REGION;
     constructor(DEV_MODE, browserstackLocalOptions, USE_OWN_LOCAL_BINARY_PROCESS, REMOTE_MCP, UPLOAD_BASE_DIR, O11Y_TFA_RCA_BASE_URL, BROWSERSTACK_AUTOMATION_BASE_URL, BROWSERSTACK_O11Y_UI_BASE_URL, 
     // askBrowserStackAI's process-startup settings. Declared here rather than read from
     // process.env inside src/tools/, per rules/tool-design.md — and so the remote wrapper,
@@ -71,7 +83,7 @@ export class Config {
      *
      * "deferred" | "elicit". Anything else is ignored.
      */
-    ASK_BROWSERSTACK_RELAY_TRANSPORT) {
+    ASK_BROWSERSTACK_RELAY_TRANSPORT, BROWSERSTACK_GRR_REGION = "us") {
         this.DEV_MODE = DEV_MODE;
         this.browserstackLocalOptions = browserstackLocalOptions;
         this.USE_OWN_LOCAL_BINARY_PROCESS = USE_OWN_LOCAL_BINARY_PROCESS;
@@ -83,6 +95,7 @@ export class Config {
         this.ASK_BROWSERSTACK_ATLAS_URL = ASK_BROWSERSTACK_ATLAS_URL;
         this.ASK_BROWSERSTACK_AUTH_TOKEN_URL = ASK_BROWSERSTACK_AUTH_TOKEN_URL;
         this.ASK_BROWSERSTACK_RELAY_TRANSPORT = ASK_BROWSERSTACK_RELAY_TRANSPORT;
+        this.BROWSERSTACK_GRR_REGION = BROWSERSTACK_GRR_REGION;
     }
 }
 const config = new Config(process.env.DEV_MODE === "true", browserstackLocalOptions, process.env.USE_OWN_LOCAL_BINARY_PROCESS === "true", process.env.REMOTE_MCP === "true", process.env.MCP_UPLOAD_BASE_DIR && process.env.MCP_UPLOAD_BASE_DIR.length > 0
@@ -103,5 +116,5 @@ const config = new Config(process.env.DEV_MODE === "true", browserstackLocalOpti
     process.env.ASK_BROWSERSTACK_AUTH_TOKEN_URL.trim().length > 0
     ? process.env.ASK_BROWSERSTACK_AUTH_TOKEN_URL
     : undefined, (process.env.ASK_BROWSERSTACK_RELAY_TRANSPORT || "").trim().toLowerCase() ||
-    undefined);
+    undefined, parseGrrRegion(process.env.BROWSERSTACK_GRR_REGION));
 export default config;

package/dist/lib/api.js

@@ -1,7 +1,9 @@
 import { getBrowserStackAuth } from "./get-auth.js";
 import { apiClient } from "./apiClient.js";
+import { getRegionalHost } from "./regional-host.js";
 export async function getLatestO11YBuildInfo(buildName, projectName, config) {
-    const buildsUrl = `https://api-observability.browserstack.com/ext/v1/builds/latest?build_name=${encodeURIComponent(buildName)}&project_name=${encodeURIComponent(projectName)}`;
+    const host = getRegionalHost("observabilityApi");
+    const buildsUrl = `${host}/ext/v1/builds/latest?build_name=${encodeURIComponent(buildName)}&project_name=${encodeURIComponent(projectName)}`;
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const buildsResponse = await apiClient.get({

package/dist/lib/error.d.ts

@@ -1,4 +1,14 @@
 import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Returns the most specific human-readable text for an error raised by an
+ * API call, capped at 500 characters. For an AxiosError with a response body
+ * it prefers the body's `message`, `error` or `errors` field, serialising
+ * objects, and uses the whole body when none of those fields exist. An empty,
+ * whitespace-only or HTML-document body falls back to the error's own message.
+ * @param err - The error object to describe
+ * @param defaultText - The fallback error message
+ */
+export declare function errorText(err: unknown, defaultText: string): string;
 /**
  * Formats an AxiosError into a CallToolResult with an appropriate message.
  * @param err - The error object to format

package/dist/lib/error.js

@@ -1,23 +1,75 @@
 import { AxiosError } from "axios";
+const MAX_ERROR_TEXT = 500;
+const BODY_FIELDS = ["message", "error", "errors"];
+function clip(text) {
+    return text.length > MAX_ERROR_TEXT ? text.slice(0, MAX_ERROR_TEXT) : text;
+}
+const HTML_DOCUMENT = /^\s*<(!doctype|html)\b/i;
+function stringify(value) {
+    if (typeof value === "string") {
+        return HTML_DOCUMENT.test(value) ? "" : value.trim();
+    }
+    if (value === undefined || value === null)
+        return "";
+    try {
+        const json = JSON.stringify(value);
+        return json === "{}" || json === "[]" ? "" : (json ?? "");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Text taken from an API error body: the first non-empty `message`, `error`
+ * or `errors` field when any of them is present, otherwise the whole body.
+ * Returns undefined when the body carries no usable text.
+ */
+function bodyText(data) {
+    if (typeof data !== "object" || data === null) {
+        const text = stringify(data);
+        return text ? clip(text) : undefined;
+    }
+    const record = data;
+    const named = BODY_FIELDS.filter((key) => key in record);
+    if (named.length > 0) {
+        for (const key of named) {
+            const text = stringify(record[key]);
+            if (text)
+                return clip(text);
+        }
+        return undefined;
+    }
+    const text = stringify(record);
+    return text ? clip(text) : undefined;
+}
+/**
+ * Returns the most specific human-readable text for an error raised by an
+ * API call, capped at 500 characters. For an AxiosError with a response body
+ * it prefers the body's `message`, `error` or `errors` field, serialising
+ * objects, and uses the whole body when none of those fields exist. An empty,
+ * whitespace-only or HTML-document body falls back to the error's own message.
+ * @param err - The error object to describe
+ * @param defaultText - The fallback error message
+ */
+export function errorText(err, defaultText) {
+    if (err instanceof AxiosError) {
+        const text = bodyText(err.response?.data);
+        if (text)
+            return text;
+        return clip(err.message || defaultText);
+    }
+    if (err instanceof Error)
+        return clip(err.message || defaultText);
+    return defaultText;
+}
 /**
  * Formats an AxiosError into a CallToolResult with an appropriate message.
  * @param err - The error object to format
  * @param defaultText - The fallback error message
  */
 export function formatAxiosError(err, defaultText) {
-    let text = defaultText;
-    if (err instanceof AxiosError && err.response?.data) {
-        const message = err.response.data.message ||
-            err.response.data.error ||
-            err.message ||
-            defaultText;
-        text = message;
-    }
-    else if (err instanceof Error) {
-        text = err.message;
-    }
     return {
-        content: [{ type: "text", text }],
+        content: [{ type: "text", text: errorText(err, defaultText) }],
         isError: true,
     };
 }

package/dist/lib/regional-host.d.ts

@@ -0,0 +1,40 @@
+import { GrrRegion } from "../config.js";
+type Hosts = Record<GrrRegion, string>;
+declare const HOSTS: {
+    readonly automateApi: Hosts;
+    readonly appAutomateApi: Hosts;
+    readonly appAutomateUpload: {
+        readonly us: "https://api-cloud.browserstack.com";
+        readonly eu: string;
+        readonly in: string;
+    };
+    readonly appAutomateHub: {
+        readonly us: "hub.browserstack.com";
+        readonly eu: "hub-eu-only.browserstack.com";
+        readonly in: "hub-aps-only.browserstack.com";
+    };
+    readonly accessibilityApi: {
+        readonly us: "https://api-accessibility.browserstack.com";
+        readonly eu: "https://api-accessibility-eu.browserstack.com";
+        readonly in: "https://api-accessibility-in.browserstack.com";
+    };
+    readonly accessibilityDashboard: {
+        readonly us: "https://accessibility.browserstack.com";
+        readonly eu: "https://accessibility-eu.browserstack.com";
+        readonly in: "https://accessibility-in.browserstack.com";
+    };
+    readonly observabilityApi: {
+        readonly us: "https://api-observability.browserstack.com";
+        readonly eu: "https://api-observability-eu.browserstack.com";
+        readonly in: "https://api-observability-in.browserstack.com";
+    };
+    readonly automationApi: {
+        readonly us: "https://api-automation.browserstack.com";
+        readonly eu: "https://api-automation-eu.browserstack.com";
+        readonly in: "https://api-automation-in.browserstack.com";
+    };
+};
+export type RegionalHostKind = keyof typeof HOSTS;
+export declare function hostFor(kind: RegionalHostKind, region: GrrRegion): string;
+export declare function getRegionalHost(kind: RegionalHostKind): string;
+export {};

package/dist/lib/regional-host.js

@@ -0,0 +1,51 @@
+import appConfig from "../config.js";
+const AUTOMATE_API = {
+    us: "https://api.browserstack.com",
+    eu: "https://api-eu-only.browserstack.com",
+    in: "https://api-aps-only.browserstack.com",
+};
+const HOSTS = {
+    automateApi: AUTOMATE_API,
+    appAutomateApi: AUTOMATE_API,
+    appAutomateUpload: {
+        us: "https://api-cloud.browserstack.com",
+        eu: AUTOMATE_API.eu,
+        in: AUTOMATE_API.in,
+    },
+    appAutomateHub: {
+        us: "hub.browserstack.com",
+        eu: "hub-eu-only.browserstack.com",
+        in: "hub-aps-only.browserstack.com",
+    },
+    accessibilityApi: {
+        us: "https://api-accessibility.browserstack.com",
+        eu: "https://api-accessibility-eu.browserstack.com",
+        in: "https://api-accessibility-in.browserstack.com",
+    },
+    accessibilityDashboard: {
+        us: "https://accessibility.browserstack.com",
+        eu: "https://accessibility-eu.browserstack.com",
+        in: "https://accessibility-in.browserstack.com",
+    },
+    observabilityApi: {
+        us: "https://api-observability.browserstack.com",
+        eu: "https://api-observability-eu.browserstack.com",
+        in: "https://api-observability-in.browserstack.com",
+    },
+    automationApi: {
+        us: "https://api-automation.browserstack.com",
+        eu: "https://api-automation-eu.browserstack.com",
+        in: "https://api-automation-in.browserstack.com",
+    },
+};
+export function hostFor(kind, region) {
+    return HOSTS[kind][region];
+}
+export function getRegionalHost(kind) {
+    if (kind === "automationApi" &&
+        appConfig.BROWSERSTACK_AUTOMATION_BASE_URL &&
+        appConfig.BROWSERSTACK_AUTOMATION_BASE_URL !== HOSTS.automationApi.us) {
+        return appConfig.BROWSERSTACK_AUTOMATION_BASE_URL;
+    }
+    return hostFor(kind, appConfig.BROWSERSTACK_GRR_REGION ?? "us");
+}

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

@@ -9,6 +9,11 @@ const TM_BASE_URLS = [
 ];
 let cachedBaseUrl = null;
 export async function getTMBaseURL(config) {
+    // Unset or "us" falls through to the probe below.
+    const grrRegion = appConfig.BROWSERSTACK_GRR_REGION;
+    if (grrRegion === "eu" || grrRegion === "in") {
+        return `https://test-management-${grrRegion}.browserstack.com`;
+    }
     // Skip the module-level cache in remote (multi-tenant) mode: it is process-shared,
     // so the first user's region would be served to every subsequent user — breaking
     // requests for users on a different region's BrowserStack account.

package/dist/lib/utils.js

@@ -7,6 +7,9 @@ export function sanitizeUrlParam(param) {
     return param.replace(/[;&|`$(){}[\]<>]/g, "");
 }
 const ONE_MB = 1048576;
+// sharp's default (~268M px) lets one image decode to ~1 GB of RGBA; 25M px caps it near 100 MB.
+const MAX_INPUT_PIXELS = 25_000_000;
+const MAX_IMAGE_DIMENSION = 1920;
 let sharpConfigured = false;
 //Compresses a base64 image intelligently to keep it under 1 MB if needed.
 export async function maybeCompressBase64(base64) {
@@ -25,11 +28,19 @@ export async function maybeCompressBase64(base64) {
             sharp.concurrency(1);
             sharpConfigured = true;
         }
-        const compressedBuffer = await sharp(buffer).png({ quality }).toBuffer();
+        const image = globalConfig.REMOTE_MCP
+            ? sharp(buffer, { limitInputPixels: MAX_INPUT_PIXELS }).resize({
+                width: MAX_IMAGE_DIMENSION,
+                height: MAX_IMAGE_DIMENSION,
+                fit: "inside",
+                withoutEnlargement: true,
+            })
+            : sharp(buffer);
+        const compressedBuffer = await image.png({ quality }).toBuffer();
         return compressedBuffer.toString("base64");
     }
     catch (err) {
-        logger.warn("Image compression unavailable (sharp failed to load); returning the uncompressed image. %s", err instanceof Error ? err.message : String(err));
+        logger.warn("Image compression failed; returning the uncompressed image. %s", err instanceof Error ? err.message : String(err));
         return base64;
     }
 }

package/dist/tools/accessiblity-utils/accessibility-rag.js

@@ -1,8 +1,9 @@
 import { apiClient } from "../../lib/apiClient.js";
 import { wrapUntrusted } from "../../lib/untrusted-content.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
 export async function queryAccessibilityRAG(userQuery, config) {
-    const url = "https://accessibility.browserstack.com/api/tcg-proxy/search";
+    const url = `${getRegionalHost("accessibilityDashboard")}/api/tcg-proxy/search`;
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const response = await apiClient.post({

package/dist/tools/accessiblity-utils/auth-config.js

@@ -1,5 +1,6 @@
 import { apiClient } from "../../lib/apiClient.js";
 import logger from "../../logger.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
 /**
  * Allowlist of non-sensitive fields safe to return to the LLM/tool caller.
  * Everything else (site username/password, selectors, undeclared keys) is
@@ -52,7 +53,7 @@ export class AccessibilityAuthConfig {
         };
         try {
             const response = await apiClient.post({
-                url: "https://api-accessibility.browserstack.com/api/website-scanner/v1/auth_configs",
+                url: `${getRegionalHost("accessibilityApi")}/api/website-scanner/v1/auth_configs`,
                 headers: {
                     Authorization: "Basic " +
                         Buffer.from(`${this.auth.username}:${this.auth.password}`).toString("base64"),
@@ -91,7 +92,7 @@ export class AccessibilityAuthConfig {
         };
         try {
             const response = await apiClient.post({
-                url: "https://api-accessibility.browserstack.com/api/website-scanner/v1/auth_configs",
+                url: `${getRegionalHost("accessibilityApi")}/api/website-scanner/v1/auth_configs`,
                 headers: {
                     Authorization: "Basic " +
                         Buffer.from(`${this.auth.username}:${this.auth.password}`).toString("base64"),
@@ -120,7 +121,7 @@ export class AccessibilityAuthConfig {
         try {
             // No GET-by-id route exists; list and select.
             const response = await apiClient.get({
-                url: "https://api-accessibility.browserstack.com/api/website-scanner/v1/auth_configs",
+                url: `${getRegionalHost("accessibilityApi")}/api/website-scanner/v1/auth_configs`,
                 headers: {
                     Authorization: "Basic " +
                         Buffer.from(`${this.auth.username}:${this.auth.password}`).toString("base64"),

package/dist/tools/accessiblity-utils/report-fetcher.js

@@ -1,4 +1,5 @@
 import { apiClient } from "../../lib/apiClient.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
 export class AccessibilityReportFetcher {
     auth;
     setAuth(auth) {
@@ -6,7 +7,7 @@ export class AccessibilityReportFetcher {
     }
     async getReportLink(scanId, scanRunId) {
         // Initiate CSV link generation
-        const initUrl = `https://api-accessibility.browserstack.com/api/website-scanner/v1/scans/${scanId}/scan_runs/issues?scan_run_id=${scanRunId}`;
+        const initUrl = `${getRegionalHost("accessibilityApi")}/api/website-scanner/v1/scans/${scanId}/scan_runs/issues?scan_run_id=${scanRunId}`;
         let basicAuthHeader = undefined;
         if (this.auth) {
             const { username, password } = this.auth;
@@ -23,7 +24,7 @@ export class AccessibilityReportFetcher {
         }
         const taskId = initData.data.task_id;
         // Poll for the generated CSV link (task is async, may take a few seconds)
-        const reportUrl = `https://api-accessibility.browserstack.com/api/website-scanner/v1/scans/${scanId}/scan_runs/issues?task_id=${encodeURIComponent(taskId)}`;
+        const reportUrl = `${getRegionalHost("accessibilityApi")}/api/website-scanner/v1/scans/${scanId}/scan_runs/issues?task_id=${encodeURIComponent(taskId)}`;
         const maxAttempts = 3;
         const pollIntervalMs = 2000;
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {

package/dist/tools/accessiblity-utils/scanner.js

@@ -3,6 +3,7 @@ import { randomUUID } from "node:crypto";
 import logger from "../../logger.js";
 import { isLocalURL, ensureLocalBinarySetup, killExistingBrowserStackLocalProcesses, } from "../../lib/local.js";
 import config from "../../config.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
 export class AccessibilityScanner {
     auth;
     setAuth(auth) {
@@ -64,7 +65,7 @@ export class AccessibilityScanner {
         }
         try {
             const response = await apiClient.post({
-                url: "https://api-accessibility.browserstack.com/api/website-scanner/v1/scans",
+                url: `${getRegionalHost("accessibilityApi")}/api/website-scanner/v1/scans`,
                 headers: {
                     Authorization: "Basic " +
                         Buffer.from(`${this.auth.username}:${this.auth.password}`).toString("base64"),
@@ -92,7 +93,7 @@ export class AccessibilityScanner {
     async pollStatus(scanId, scanRunId) {
         try {
             const response = await apiClient.get({
-                url: `https://api-accessibility.browserstack.com/api/website-scanner/v1/scans/${scanId}/scan_runs/${scanRunId}/status`,
+                url: `${getRegionalHost("accessibilityApi")}/api/website-scanner/v1/scans/${scanId}/scan_runs/${scanRunId}/status`,
                 headers: {
                     Authorization: "Basic " +
                         Buffer.from(`${this.auth?.username}:${this.auth?.password}`).toString("base64"),

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

@@ -5,6 +5,7 @@ import { customFuzzySearch } from "../../../lib/fuzzy.js";
 import { getBrowserStackAuth } from "../../../lib/get-auth.js";
 import { validateUploadPath, APP_BINARY_EXTENSIONS, MAX_APP_UPLOAD_BYTES, } from "../../../lib/upload-validator.js";
 import appConfig from "../../../config.js";
+import { getRegionalHost } from "../../../lib/regional-host.js";
 /**
  * Finds devices that exactly match the provided display name.
  * Uses fuzzy search first, and then filters for exact case-insensitive match.
@@ -84,7 +85,7 @@ export async function uploadApp(appPath, username, password) {
     const formData = new FormData();
     formData.append("file", fs.createReadStream(safePath));
     const response = await apiClient.post({
-        url: "https://api-cloud.browserstack.com/app-automate/upload",
+        url: `${getRegionalHost("appAutomateUpload")}/app-automate/upload`,
         headers: {
             ...formData.getHeaders(),
             Authorization: "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
@@ -124,25 +125,25 @@ async function uploadFileToBrowserStack(filePath, endpoint, responseKey, config,
 }
 //Uploads an Android app (.apk or .aab) to BrowserStack Espresso endpoint and returns the app_url
 export async function uploadEspressoApp(appPath, config) {
-    return uploadFileToBrowserStack(appPath, "https://api-cloud.browserstack.com/app-automate/espresso/v2/app", "app_url", config, { allowedExtensions: [".apk", ".aab"] });
+    return uploadFileToBrowserStack(appPath, `${getRegionalHost("appAutomateUpload")}/app-automate/espresso/v2/app`, "app_url", config, { allowedExtensions: [".apk", ".aab"] });
 }
 //Uploads an Espresso test suite (.apk) to BrowserStack and returns the test_suite_url
 export async function uploadEspressoTestSuite(testSuitePath, config) {
-    return uploadFileToBrowserStack(testSuitePath, "https://api-cloud.browserstack.com/app-automate/espresso/v2/test-suite", "test_suite_url", config, { allowedExtensions: [".apk"] });
+    return uploadFileToBrowserStack(testSuitePath, `${getRegionalHost("appAutomateUpload")}/app-automate/espresso/v2/test-suite`, "test_suite_url", config, { allowedExtensions: [".apk"] });
 }
 //Uploads an iOS app (.ipa) to BrowserStack XCUITest endpoint and returns the app_url
 export async function uploadXcuiApp(appPath, config) {
-    return uploadFileToBrowserStack(appPath, "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/app", "app_url", config, { allowedExtensions: [".ipa"] });
+    return uploadFileToBrowserStack(appPath, `${getRegionalHost("appAutomateUpload")}/app-automate/xcuitest/v2/app`, "app_url", config, { allowedExtensions: [".ipa"] });
 }
 //Uploads an XCUITest test suite (.zip) to BrowserStack and returns the test_suite_url
 export async function uploadXcuiTestSuite(testSuitePath, config) {
-    return uploadFileToBrowserStack(testSuitePath, "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/test-suite", "test_suite_url", config, { allowedExtensions: [".zip"] });
+    return uploadFileToBrowserStack(testSuitePath, `${getRegionalHost("appAutomateUpload")}/app-automate/xcuitest/v2/test-suite`, "test_suite_url", config, { allowedExtensions: [".zip"] });
 }
 // Triggers an Espresso test run on BrowserStack and returns the build_id
 export async function triggerEspressoBuild(app_url, test_suite_url, devices, project, config) {
     const authHeader = "Basic " + Buffer.from(getBrowserStackAuth(config)).toString("base64");
     const response = await apiClient.post({
-        url: "https://api-cloud.browserstack.com/app-automate/espresso/v2/build",
+        url: `${getRegionalHost("appAutomateUpload")}/app-automate/espresso/v2/build`,
         headers: {
             Authorization: authHeader,
             "Content-Type": "application/json",
@@ -166,7 +167,7 @@ export async function triggerXcuiBuild(app_url, test_suite_url, devices, project
         password: config["browserstack-access-key"],
     };
     const response = await apiClient.post({
-        url: "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build",
+        url: `${getRegionalHost("appAutomateUpload")}/app-automate/xcuitest/v2/build`,
         headers: {
             Authorization: "Basic " +
                 Buffer.from(`${auth.username}:${auth.password}`).toString("base64"),

package/dist/tools/appautomate.js

@@ -12,6 +12,7 @@ import { Platform, } from "./appautomate-utils/native-execution/types.js";
 import { getDevicesAndBrowsers, BrowserStackProducts, } from "../lib/device-cache.js";
 import { findMatchingDevice, getDeviceVersions, resolveVersion, validateArgs, uploadApp, uploadEspressoApp, uploadEspressoTestSuite, triggerEspressoBuild, uploadXcuiApp, uploadXcuiTestSuite, triggerXcuiBuild, } from "./appautomate-utils/native-execution/appautomate.js";
 import { RUN_APP_AUTOMATE_DESCRIPTION, RUN_APP_AUTOMATE_SCHEMA, } from "./appautomate-utils/native-execution/constants.js";
+import { getRegionalHost } from "../lib/regional-host.js";
 /**
  * Launches an app on a selected BrowserStack device and takes a screenshot.
  */
@@ -63,7 +64,7 @@ async function takeAppScreenshot(args) {
         try {
             driver = await remote({
                 protocol: "https",
-                hostname: "hub.browserstack.com",
+                hostname: getRegionalHost("appAutomateHub"),
                 port: 443,
                 path: "/wd/hub",
                 capabilities,

package/dist/tools/automate-utils/fetch-screenshots.d.ts

@@ -1,6 +1,10 @@
 import { SessionType } from "../../lib/constants.js";
 import { BrowserStackConfig } from "../../lib/types.js";
-export declare function fetchAutomationScreenshots(sessionId: string, sessionType: SessionType | undefined, config: BrowserStackConfig): Promise<{
+export declare const MAX_SCREENSHOT_BYTES: number | undefined;
+export declare function parseScreenshotUrls(text: string): string[];
+export type Screenshot = {
     url: string;
     base64: string;
-}[]>;
+    mimeType: string;
+};
+export declare function fetchAutomationScreenshots(sessionId: string, sessionType: SessionType | undefined, config: BrowserStackConfig): Promise<Screenshot[]>;

package/dist/tools/automate-utils/fetch-screenshots.js

@@ -3,10 +3,17 @@ import { SessionType } from "../../lib/constants.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { apiClient } from "../../lib/apiClient.js";
 import globalConfig from "../../config.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
+import { MAX_LOG_BYTES } from "../failurelogs-utils/utils.js";
+export const MAX_SCREENSHOT_BYTES = globalConfig.REMOTE_MCP
+    ? 10 * 1024 * 1024
+    : undefined;
 async function extractScreenshotUrls(sessionId, sessionType, config) {
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
-    const baseUrl = `https://api.browserstack.com/${sessionType === SessionType.Automate ? "automate" : "app-automate"}`;
+    const isAutomate = sessionType === SessionType.Automate;
+    const host = getRegionalHost(isAutomate ? "automateApi" : "appAutomateApi");
+    const baseUrl = `${host}/${isAutomate ? "automate" : "app-automate"}`;
     const url = `${baseUrl}/sessions/${sessionId}/logs`;
     const response = await apiClient.get({
         url,
@@ -14,47 +21,112 @@ async function extractScreenshotUrls(sessionId, sessionType, config) {
             "Content-Type": "application/json",
             Authorization: `Basic ${auth}`,
         },
+        maxContentLength: MAX_LOG_BYTES,
         raise_error: false,
     });
+    if (response.status === 413) {
+        throw new Error("The logs for this session are too large (over 5 MB) to find screenshots here. Open the session in the BrowserStack dashboard to view them.");
+    }
     await assertOkResponse(response, "Session");
     const text = typeof response.data === "string"
         ? response.data
         : JSON.stringify(response.data);
+    return parseScreenshotUrls(text);
+}
+const LOG_PREFIX = String.raw `^\d{4}-\d{2}-\d{2} \d{1,2}:\d{1,2}:\d{1,2}:\d{1,3} `;
+const LINE_TYPE_PATTERN = new RegExp(`${LOG_PREFIX}([A-Z_]+) `);
+const SCREENSHOT_REQUEST_PATTERN = new RegExp(String.raw `${LOG_PREFIX}REQUEST \[[^\]]+\] GET /session/[^/\s]+/screenshot(\s|$)`);
+const RESPONSE_VALUE_PATTERN = new RegExp(String.raw `${LOG_PREFIX}RESPONSE \{"value"\s*:\s*"(https://[^"]+)"`);
+const DEBUG_SCREENSHOT_PATTERN = new RegExp(String.raw `${LOG_PREFIX}DEBUG (https://\S+)$`);
+const TRUSTED_HOST_PATTERN = /(^|\.)browserstack\.com$|\.s3([.-][a-z0-9-]+)*\.amazonaws\.com$|\.backblazeb2\.com$/;
+function isTrustedScreenshotUrl(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === "https:" && TRUSTED_HOST_PATTERN.test(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+export function parseScreenshotUrls(text) {
     const urls = [];
-    const SCREENSHOT_PATTERN = /REQUEST.*GET.*\/screenshot/;
-    const RESPONSE_VALUE_PATTERN = /"value"\s*:\s*"([^"]+)"/;
-    // Split logs into lines and process them
-    const lines = text.split("\n");
-    for (let i = 0; i < lines.length - 1; i++) {
-        const currentLine = lines[i];
-        const nextLine = lines[i + 1];
-        if (SCREENSHOT_PATTERN.test(currentLine)) {
-            const match = nextLine.match(RESPONSE_VALUE_PATTERN);
-            if (match && match[1]) {
-                urls.push(match[1]);
+    const lines = text.split("\n").map((line) => line.trimEnd());
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const debugMatch = line.match(DEBUG_SCREENSHOT_PATTERN);
+        if (debugMatch) {
+            urls.push(debugMatch[1]);
+            continue;
+        }
+        if (!SCREENSHOT_REQUEST_PATTERN.test(line)) {
+            continue;
+        }
+        for (let j = i + 1; j < lines.length; j++) {
+            const lineType = lines[j].match(LINE_TYPE_PATTERN)?.[1];
+            if (lineType === "REQUEST") {
+                break;
+            }
+            if (lineType === "RESPONSE") {
+                const valueMatch = lines[j].match(RESPONSE_VALUE_PATTERN);
+                if (valueMatch) {
+                    urls.push(valueMatch[1]);
+                }
+                break;
             }
         }
     }
-    return urls;
+    return [...new Set(urls)].filter(isTrustedScreenshotUrl);
+}
+function detectImageMimeType(buffer) {
+    if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {
+        return "image/jpeg";
+    }
+    return "image/png";
 }
+// Returns null for a screenshot over MAX_SCREENSHOT_BYTES so the rest still load.
 async function fetchAndCompress(url) {
-    const response = await apiClient.get({ url, responseType: "arraybuffer" });
+    const response = await apiClient.get({
+        url,
+        responseType: "arraybuffer",
+        maxContentLength: MAX_SCREENSHOT_BYTES,
+        raise_error: false,
+    });
+    if (response.status === 413) {
+        return null;
+    }
+    if (!response.ok) {
+        throw new Error(`Failed to download screenshot: ${response.status} ${response.statusText}`);
+    }
     // Axios returns response.data as a Buffer for binary data
-    const base64 = Buffer.from(response.data).toString("base64");
-    return { url, base64: await maybeCompressBase64(base64) };
+    const buffer = Buffer.from(response.data);
+    const base64 = await maybeCompressBase64(buffer.toString("base64"));
+    // Detect AFTER compression: sharp re-encodes anything over 1 MB to PNG, so
+    // reading the original bytes would label a large JPEG with the wrong type.
+    return {
+        url,
+        base64,
+        mimeType: detectImageMimeType(Buffer.from(base64, "base64")),
+    };
 }
 //Converts screenshot URLs to base64 encoded images
 async function convertUrlsToBase64(urls) {
+    let results;
     // Hosted pods are memory-constrained: process one image at a time. Local runs
     // keep the concurrent path.
     if (globalConfig.REMOTE_MCP) {
-        const screenshots = [];
+        results = [];
         for (const url of urls) {
-            screenshots.push(await fetchAndCompress(url));
+            results.push(await fetchAndCompress(url));
         }
-        return screenshots;
     }
-    return Promise.all(urls.map(fetchAndCompress));
+    else {
+        results = await Promise.all(urls.map(fetchAndCompress));
+    }
+    const screenshots = results.filter((s) => s !== null);
+    if (urls.length > 0 && screenshots.length === 0) {
+        throw new Error("The screenshots in this session are too large (over 10 MB each) to fetch here. Open the session in the BrowserStack dashboard to view them.");
+    }
+    return screenshots;
 }
 //Fetches and converts screenshot URLs to base64 encoded images
 export async function fetchAutomationScreenshots(sessionId, sessionType = SessionType.Automate, config) {

package/dist/tools/automate-utils/list-session-ids.d.ts

@@ -23,6 +23,6 @@ export interface SessionIdRecord {
     browserUrl?: string;
     videoUrl?: string;
 }
-export declare function sessionsListUrl(sessionType: SessionType, buildId: string): string;
+export declare function sessionsListUrl(sessionType: SessionType, buildId: string, host?: string): string;
 export declare function mapSessionRecords(payload: unknown, statusFilter?: string): SessionIdRecord[];
 export declare function listSessionIds(args: ListSessionIdsArgs, config: BrowserStackConfig): Promise<SessionIdRecord[]>;

package/dist/tools/automate-utils/list-session-ids.js

@@ -1,6 +1,7 @@
 import { SessionType } from "../../lib/constants.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { apiClient } from "../../lib/apiClient.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
 export const DEFAULT_SESSION_LIST_LIMIT = 10;
 /** The REST session list returned 404: no Automate/App Automate build has this hashed id. */
 export class UnknownBuildError extends Error {
@@ -9,13 +10,13 @@ export class UnknownBuildError extends Error {
         this.name = "UnknownBuildError";
     }
 }
-export function sessionsListUrl(sessionType, buildId) {
+export function sessionsListUrl(sessionType, buildId, host) {
     const encodedBuildId = encodeURIComponent(buildId);
     switch (sessionType) {
         case SessionType.Automate:
-            return `https://api.browserstack.com/automate/builds/${encodedBuildId}/sessions.json`;
+            return `${host ?? "https://api.browserstack.com"}/automate/builds/${encodedBuildId}/sessions.json`;
         case SessionType.AppAutomate:
-            return `https://api-cloud.browserstack.com/app-automate/builds/${encodedBuildId}/sessions.json`;
+            return `${host ?? "https://api-cloud.browserstack.com"}/app-automate/builds/${encodedBuildId}/sessions.json`;
         default: {
             const _exhaustive = sessionType;
             throw new Error(`Unsupported session type: ${_exhaustive}`);
@@ -66,7 +67,9 @@ export async function listSessionIds(args, config) {
         params.offset = args.offset;
     }
     const response = await apiClient.get({
-        url: sessionsListUrl(args.sessionType, buildId),
+        url: sessionsListUrl(args.sessionType, buildId, getRegionalHost(args.sessionType === SessionType.Automate
+            ? "automateApi"
+            : "appAutomateUpload")),
         headers: {
             "Content-Type": "application/json",
             Authorization: `Basic ${auth}`,

package/dist/tools/automate-utils/resolve-hashed-build-id.d.ts

@@ -2,7 +2,7 @@ import { SessionType } from "../../lib/constants.js";
 import { BrowserStackConfig } from "../../lib/types.js";
 export declare function isObservabilityBuildUuid(id: string): boolean;
 export declare function isHashedBuildId(id: string): boolean;
-export declare function sessionDetailsUrl(sessionType: SessionType, sessionId: string): string;
+export declare function sessionDetailsUrl(sessionType: SessionType, sessionId: string, host?: string): string;
 /**
  * Resolve the hashed build id that a session belongs to via the Automate /
  * App Automate session detail endpoint. Returns undefined when the session

package/dist/tools/automate-utils/resolve-hashed-build-id.js

@@ -2,8 +2,8 @@ import { SessionType } from "../../lib/constants.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { apiClient } from "../../lib/apiClient.js";
 import logger from "../../logger.js";
-import { getAutomationBaseUrl } from "../rca-agent-utils/constants.js";
 import { extractTestIds } from "../rca-agent-utils/get-failed-test-id.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
 // Observability (Test Reporting & Analytics) build ids are usually UUIDs but
 // some are 40-char hex, the same shape as Automate / App Automate "hashed ids".
 // The two are never interchangeable, and the observability build API does not
@@ -19,13 +19,13 @@ export function isObservabilityBuildUuid(id) {
 export function isHashedBuildId(id) {
     return HASHED_BUILD_ID_RE.test(id.trim());
 }
-export function sessionDetailsUrl(sessionType, sessionId) {
+export function sessionDetailsUrl(sessionType, sessionId, host = "https://api.browserstack.com") {
     const encoded = encodeURIComponent(sessionId);
     switch (sessionType) {
         case SessionType.Automate:
-            return `https://api.browserstack.com/automate/sessions/${encoded}.json`;
+            return `${host}/automate/sessions/${encoded}.json`;
         case SessionType.AppAutomate:
-            return `https://api.browserstack.com/app-automate/sessions/${encoded}.json`;
+            return `${host}/app-automate/sessions/${encoded}.json`;
         default: {
             const _exhaustive = sessionType;
             throw new Error(`Unsupported session type: ${_exhaustive}`);
@@ -41,7 +41,7 @@ export async function resolveBuildIdFromSession(sessionId, sessionType, config)
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const response = await apiClient.get({
-        url: sessionDetailsUrl(sessionType, sessionId),
+        url: sessionDetailsUrl(sessionType, sessionId, getRegionalHost(sessionType === SessionType.Automate ? "automateApi" : "appAutomateApi")),
         headers: {
             "Content-Type": "application/json",
             Authorization: `Basic ${auth}`,
@@ -66,7 +66,7 @@ export async function resolveBuildIdFromSession(sessionId, sessionType, config)
 export async function findSessionIdForObservabilityBuild(observabilityBuildId, config) {
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
-    const baseUrl = `${getAutomationBaseUrl()}/ext/v1/builds/${encodeURIComponent(observabilityBuildId)}/testRuns`;
+    const baseUrl = `${getRegionalHost("automationApi")}/ext/v1/builds/${encodeURIComponent(observabilityBuildId)}/testRuns`;
     let nextPage;
     for (let page = 0; page < MAX_TEST_RUN_PAGES; page++) {
         const response = await apiClient.get({

package/dist/tools/automate.js

@@ -14,7 +14,7 @@ export async function fetchAutomationScreenshotsTool(args, config) {
                 content: [
                     {
                         type: "text",
-                        text: "No screenshots found in the session or some unexpected error occurred",
+                        text: "No screenshots found in the session logs. Run with browserstack.debug: true to capture visual-log screenshots.",
                     },
                 ],
                 isError: true,
@@ -23,7 +23,7 @@ export async function fetchAutomationScreenshotsTool(args, config) {
         const results = screenshots.map((screenshot, index) => ({
             type: "image",
             data: screenshot.base64,
-            mimeType: "image/png",
+            mimeType: screenshot.mimeType,
             _meta: { url: screenshot.url, index: index + 1 },
         }));
         return {

package/dist/tools/build-insights.js

@@ -3,11 +3,13 @@ import logger from "../logger.js";
 import { fetchFromBrowserStackAPI, handleMCPError } from "../lib/utils.js";
 import { trackMCP } from "../lib/instrumentation.js";
 import { resolveHashedBuildId } from "./automate-utils/resolve-hashed-build-id.js";
+import { getRegionalHost } from "../lib/regional-host.js";
 // Tool function that fetches build insights from two APIs
 export async function fetchBuildInsightsTool(args, config) {
     try {
-        const buildUrl = `https://api-automation.browserstack.com/ext/v1/builds/${args.buildId}`;
-        const qualityGateUrl = `https://api-automation.browserstack.com/ext/v1/quality-gates/${args.buildId}`;
+        const host = getRegionalHost("automationApi");
+        const buildUrl = `${host}/ext/v1/builds/${args.buildId}`;
+        const qualityGateUrl = `${host}/ext/v1/quality-gates/${args.buildId}`;
         // Quality gate data is optional — a failure there should not block build insights
         const [buildData, qualityData] = await Promise.all([
             fetchFromBrowserStackAPI(buildUrl, config),

package/dist/tools/failurelogs-utils/app-automate.js

@@ -2,9 +2,10 @@ import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { filterLinesByKeywords, MAX_LOG_BYTES, validateLogResponse, } from "./utils.js";
 import { apiClient } from "../../lib/apiClient.js";
 import { wrapUntrusted } from "../../lib/untrusted-content.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
 // DEVICE LOGS
 export async function retrieveDeviceLogs(sessionId, buildId, config) {
-    const url = `https://api.browserstack.com/app-automate/builds/${buildId}/sessions/${sessionId}/deviceLogs`;
+    const url = `${getRegionalHost("appAutomateApi")}/app-automate/builds/${buildId}/sessions/${sessionId}/deviceLogs`;
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const response = await apiClient.get({
@@ -29,7 +30,7 @@ export async function retrieveDeviceLogs(sessionId, buildId, config) {
 }
 // APPIUM LOGS
 export async function retrieveAppiumLogs(sessionId, buildId, config) {
-    const url = `https://api.browserstack.com/app-automate/builds/${buildId}/sessions/${sessionId}/appiumlogs`;
+    const url = `${getRegionalHost("appAutomateApi")}/app-automate/builds/${buildId}/sessions/${sessionId}/appiumlogs`;
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const response = await apiClient.get({
@@ -54,7 +55,7 @@ export async function retrieveAppiumLogs(sessionId, buildId, config) {
 }
 // CRASH LOGS
 export async function retrieveCrashLogs(sessionId, buildId, config) {
-    const url = `https://api.browserstack.com/app-automate/builds/${buildId}/sessions/${sessionId}/crashlogs`;
+    const url = `${getRegionalHost("appAutomateApi")}/app-automate/builds/${buildId}/sessions/${sessionId}/crashlogs`;
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const response = await apiClient.get({

package/dist/tools/failurelogs-utils/automate.js

@@ -2,9 +2,10 @@ import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { wrapUntrusted } from "../../lib/untrusted-content.js";
 import { filterLinesByKeywords, MAX_LOG_BYTES, validateLogResponse, } from "./utils.js";
 import { apiClient } from "../../lib/apiClient.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
 // NETWORK LOGS
 export async function retrieveNetworkFailures(sessionId, config) {
-    const url = `https://api.browserstack.com/automate/sessions/${sessionId}/networklogs`;
+    const url = `${getRegionalHost("automateApi")}/automate/sessions/${sessionId}/networklogs`;
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const response = await apiClient.get({
@@ -43,7 +44,7 @@ export async function retrieveNetworkFailures(sessionId, config) {
 }
 // SESSION LOGS
 export async function retrieveSessionFailures(sessionId, config) {
-    const url = `https://api.browserstack.com/automate/sessions/${sessionId}/logs`;
+    const url = `${getRegionalHost("automateApi")}/automate/sessions/${sessionId}/logs`;
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const response = await apiClient.get({
@@ -68,7 +69,7 @@ export async function retrieveSessionFailures(sessionId, config) {
 }
 // CONSOLE LOGS
 export async function retrieveConsoleFailures(sessionId, config) {
-    const url = `https://api.browserstack.com/automate/sessions/${sessionId}/consolelogs`;
+    const url = `${getRegionalHost("automateApi")}/automate/sessions/${sessionId}/consolelogs`;
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const response = await apiClient.get({

package/dist/tools/failurelogs-utils/video.js

@@ -2,9 +2,11 @@ import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { apiClient } from "../../lib/apiClient.js";
 import { SessionType } from "../../lib/constants.js";
 import { validateLogResponse } from "./utils.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
 export async function retrieveSessionVideo(sessionId, sessionType, config) {
     const product = sessionType === SessionType.AppAutomate ? "app-automate" : "automate";
-    const url = `https://api.browserstack.com/${product}/sessions/${encodeURIComponent(sessionId)}.json`;
+    const host = getRegionalHost(sessionType === SessionType.AppAutomate ? "appAutomateApi" : "automateApi");
+    const url = `${host}/${product}/sessions/${encodeURIComponent(sessionId)}.json`;
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const response = await apiClient.get({

package/dist/tools/rca-agent-utils/get-build-id.js

@@ -1,5 +1,7 @@
+import { getRegionalHost } from "../../lib/regional-host.js";
 export async function getBuildId(projectName, buildName, username, accessKey) {
-    const url = new URL("https://api-automation.browserstack.com/ext/v1/builds/latest");
+    const host = getRegionalHost("automationApi");
+    const url = new URL(`${host}/ext/v1/builds/latest`);
     url.searchParams.append("project_name", projectName);
     url.searchParams.append("build_name", buildName);
     url.searchParams.append("user_name", username);

package/dist/tools/rca-agent-utils/get-failed-test-id.d.ts

@@ -1,4 +1,4 @@
 import { TestStatus, FailedTestInfo, TestDetails } from "./types.js";
-export declare function getTestIds(buildId: string, authString: string, status?: TestStatus, includeFailureDetail?: boolean): Promise<FailedTestInfo[]>;
+export declare function getTestIds(buildId: string, authString: string, status?: TestStatus, includeFailureDetail?: boolean, host?: string): Promise<FailedTestInfo[]>;
 export declare function extractTestIds(hierarchy: TestDetails[], status?: TestStatus, includeFailureDetail?: boolean): FailedTestInfo[];
 export declare const extractFailedTestIds: typeof extractTestIds;

package/dist/tools/rca-agent-utils/get-failed-test-id.js

@@ -5,9 +5,9 @@ import { TestStatus, } from "./types.js";
 const ERROR_SUMMARY_MAX = 200;
 // Safety bound on pagination; hitting it is logged, never silent.
 const MAX_PAGES = 100;
-export async function getTestIds(buildId, authString, status, includeFailureDetail = false) {
+export async function getTestIds(buildId, authString, status, includeFailureDetail = false, host = getAutomationBaseUrl()) {
     // No `status` → returns ALL tests; a `status` narrows the query.
-    const baseUrl = `${getAutomationBaseUrl()}/ext/v1/builds/${buildId}/testRuns`;
+    const baseUrl = `${host}/ext/v1/builds/${buildId}/testRuns`;
     let url = status ? `${baseUrl}?test_statuses=${status}` : baseUrl;
     let allTests = [];
     let requestNumber = 0;

package/dist/tools/rca-agent-utils/list-build-id.js

@@ -1,11 +1,13 @@
 import { apiClient } from "../../lib/apiClient.js";
+import { getRegionalHost } from "../../lib/regional-host.js";
 /**
  * Returns the latest build for a project + build name across all users (not just the caller's).
  */
 export async function listBuildId(projectName, buildName, username, accessKey) {
     const authHeader = "Basic " + Buffer.from(`${username}:${accessKey}`).toString("base64");
+    const host = getRegionalHost("automationApi");
     const response = await apiClient.get({
-        url: "https://api-automation.browserstack.com/ext/v1/builds/latest",
+        url: `${host}/ext/v1/builds/latest`,
         headers: {
             Authorization: authHeader,
             "Content-Type": "application/json",

package/dist/tools/rca-agent-utils/rca-data.d.ts

@@ -5,5 +5,5 @@ interface ScanProgressContext {
         progressToken?: string | number;
     };
 }
-export declare function getRCAData(testIds: number[], authString: string, context?: ScanProgressContext): Promise<RCAResponse>;
+export declare function getRCAData(testIds: number[], authString: string, context?: ScanProgressContext, host?: string): Promise<RCAResponse>;
 export {};

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

@@ -177,11 +177,11 @@ async function pollRCAResults(testCases, headers, baseUrl, context, pollInterval
     }
     return { testCases };
 }
-export async function getRCAData(testIds, authString, context) {
+export async function getRCAData(testIds, authString, context, host = "https://api-observability.browserstack.com") {
     const pollInterval = 5000;
     const timeout = 40000;
     const initialDelay = 20000;
-    const baseUrl = "https://api-observability.browserstack.com/ext/v1/testRun/{testId}/testRca";
+    const baseUrl = `${host}/ext/v1/testRun/{testId}/testRca`;
     const headers = {
         Authorization: `Basic ${Buffer.from(authString).toString("base64")}`,
         "Content-Type": "application/json",

package/dist/tools/rca-agent.js

@@ -9,6 +9,7 @@ import { handleMCPError } from "../lib/utils.js";
 import { trackMCP } from "../index.js";
 import { NEEDS_BUILD_ID, NEEDS_TEST_IDS } from "./tool-handoff.js";
 import { FETCH_RCA_PARAMS, GET_BUILD_ID_PARAMS, LIST_TEST_IDS_PARAMS, } from "./rca-agent-utils/constants.js";
+import { getRegionalHost } from "../lib/regional-host.js";
 // Tool function to fetch build ID
 export async function getBuildIdTool(args, config) {
     try {
@@ -75,7 +76,7 @@ export async function fetchRCADataTool(args, config) {
         const authString = getBrowserStackAuth(config);
         // Limit to first 3 test IDs for performance
         const testIds = args.testId;
-        const rcaData = await getRCAData(testIds, authString);
+        const rcaData = await getRCAData(testIds, authString, undefined, getRegionalHost("observabilityApi"));
         const formattedData = formatRCAData(rcaData);
         return {
             content: [
@@ -105,7 +106,7 @@ export async function listTestIdsTool(args, config) {
         const { buildId, status, includeFailureDetail } = args;
         const authString = getBrowserStackAuth(config);
         // Get test IDs
-        const testIds = await getTestIds(buildId, authString, status, includeFailureDetail);
+        const testIds = await getTestIds(buildId, authString, status, includeFailureDetail, getRegionalHost("automationApi"));
         return {
             content: [
                 {

package/dist/tools/selfheal-utils/fetch-test-code.js

@@ -1,7 +1,7 @@
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { apiClient } from "../../lib/apiClient.js";
 import logger from "../../logger.js";
-const OBSERVABILITY_API_BASE = "https://api-automation.browserstack.com/ext/v1";
+import { getRegionalHost } from "../../lib/regional-host.js";
 /**
  * Normalizes the testCode response. The Observability API used to return a
  * bare array of TestCodeEntry, but now wraps it as
@@ -43,7 +43,7 @@ export async function fetchTestCodeBySession(sessionId, config) {
     }
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
-    const url = `${OBSERVABILITY_API_BASE}/sessions/${encodeURIComponent(sessionId)}/testCode`;
+    const url = `${getRegionalHost("automationApi")}/ext/v1/sessions/${encodeURIComponent(sessionId)}/testCode`;
     try {
         const response = await apiClient.get({
             url,

package/dist/tools/selfheal-utils/selfheal.js

@@ -1,7 +1,7 @@
 import { assertOkResponse } from "../../lib/utils.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
 import { apiClient } from "../../lib/apiClient.js";
-const SELF_HEAL_REPORT_BASE = "https://api-automation.browserstack.com/ext/v1/builds";
+import { getRegionalHost } from "../../lib/regional-host.js";
 /**
  * Fetches the self-healing report for a build via the build-scoped API.
  *
@@ -19,7 +19,7 @@ export async function fetchSelfHealingReportByBuild(buildUuid, config) {
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const presignedResp = await apiClient.get({
-        url: `${SELF_HEAL_REPORT_BASE}/${encodeURIComponent(buildUuid)}/selfHealingReport`,
+        url: `${getRegionalHost("automationApi")}/ext/v1/builds/${encodeURIComponent(buildUuid)}/selfHealingReport`,
         headers: {
             "Content-Type": "application/json",
             Authorization: `Basic ${auth}`,
@@ -67,7 +67,8 @@ export async function getSelfHealSelectors(sessionId, config, sessionType = "aut
     const authString = getBrowserStackAuth(config);
     const auth = Buffer.from(authString).toString("base64");
     const productPath = sessionType === "app-automate" ? "app-automate" : "automate";
-    const url = `https://api.browserstack.com/${productPath}/sessions/${sessionId}/logs`;
+    const host = getRegionalHost(sessionType === "app-automate" ? "appAutomateApi" : "automateApi");
+    const url = `${host}/${productPath}/sessions/${sessionId}/logs`;
     const response = await apiClient.get({
         url,
         headers: {

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

@@ -1,6 +1,6 @@
 import { apiClient } from "../../lib/apiClient.js";
 import { z } from "zod";
-import { formatAxiosError } from "../../lib/error.js";
+import { errorText } from "../../lib/error.js";
 import { fetchFormFields, normalizeDefaultFields as normalizeDefaultFieldsFromForm, projectIdentifierToId, } from "./TCG-utils/api.js";
 import { getTMBaseURL } from "../../lib/tm-base-url.js";
 import { getBrowserStackAuth } from "../../lib/get-auth.js";
@@ -218,12 +218,14 @@ Error details: ${JSON.stringify(err.response?.data || err.message)}`,
                 isError: true,
             };
         }
-        const errorMessage = formatAxiosError(err, "Failed to update test case");
+        const status = err.response?.status;
+        const detail = errorText(err, "unknown error");
+        const hint = status === 401 ? " Check the BrowserStack credentials in use." : "";
         return {
             content: [
                 {
                     type: "text",
-                    text: `Failed to update test case: ${errorMessage}. Please verify your credentials and try again.`,
+                    text: `Failed to update test case${status ? ` (HTTP ${status})` : ""}: ${detail}.${hint}`,
                 },
             ],
             isError: true,

package/package.json

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