@browserstack/mcp-server 2.2.3-beta.1 → 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/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/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.js

@@ -3,6 +3,7 @@ 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
@@ -10,7 +11,9 @@ export const MAX_SCREENSHOT_BYTES = globalConfig.REMOTE_MCP
 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,

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/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/package.json

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