@browserstack/mcp-server 1.1.8 → 1.2.0

package/README.md

@@ -12,7 +12,7 @@
 
 </div>
 
-<p align="center">One Platform For All Your Testing Needs</p>
+<p align="center">Comprehensive Test Platform</p>
 
 <div align="center">
 <a href="https://glama.ai/mcp/servers/@browserstack/mcp-server">
@@ -21,26 +21,23 @@
 </div>
 
 <div>
-    <a href="https://www.youtube.com/watch?v=sLA7K9v7qZc">
+    <a href="https://www.youtube.com/watch?v=sLA7K9v7qZc&list=PL1vH6dHT3H7oy8w9CY6L_nxGxCc89VXMX&index=5">
       <img src="assets/thumbnail.webp">
     </a>
   </div>
   
-Enable every developer and tester in your team, whether they are testing manually, starting their automation journey, or scaling test automation.
-BrowserStack MCP Server allows you to use our cutting-edge [Test Platform](https://www.browserstack.com/test-platform) directly from your favourite AI tools.
-
-### Why BrowserStack ?
-
-<p align="center">
-  <img src="assets/overview.png" alt="overview">
-</p>
+Manage test cases, execute manual or automated tests, debug issues, and even fix code—directly within tools like Cursor, Claude, or any MCP-enabled client, using plain English.
+#### Test from anywhere:
+Easily connect the BrowserStack Test Platform to your favourite AI tools, such as IDEs, LLMs, or agentic workflows.
+#### Reduced context switching:
+Stay in flow—keep all project context in one place and trigger actions directly from your IDE or LLM.
 
 ## 💡 Usage Examples
 
 ### 📱 Manual App Testing
 
-Use the following prompts to use your **mobile apps** on BrowserStack's extensive cloud of real devices. Stop using emulators!
-
+Test mobile apps on real devices across the latest OS versions. Reproduce bugs and debug crashes without setup hassles.
+Below are some sample prompts to use your mobile apps on BrowserStack's extensive cloud of real devices
 ```bash
 # Open app on specific device
 "open my app on a iPhone 15 Pro Max"
@@ -49,7 +46,6 @@ Use the following prompts to use your **mobile apps** on BrowserStack's extensiv
 "My app crashed on Android 14 device, can you help me debug?"
 ```
 
-
 - Unlike emulators, test your app's real-world performance on actual devices. With advanced [App-Profiling features](https://www.browserstack.com/docs/app-live/app-performance-testing), you can debug crashes and performance issues in real-time.
 - Access all major devices and OS versions from our [device grid](https://www.browserstack.com/list-of-browsers-and-platforms/app_live), We have strict SLAs to provision our global datacenters with newly released devices on [launch day](https://www.browserstack.com/blog/browserstack-launches-iphone-15-on-day-0-behind-the-scenes/).
 
@@ -58,8 +54,9 @@ Use the following prompts to use your **mobile apps** on BrowserStack's extensiv
 Similar to the app testing, you can use the following prompts to test your **websites** on BrowserStack's extensive cloud of real browsers and devices. Don't have Edge browser installed on your machine ? We've got you covered!
 
 ```bash
-# Test your local websites
+# Test your websites
 "open my website hosted on localhost:3001 on Edge"
+"open browserstack.com on latest version of Chrome"
 ```
 
 - Test websites across different browsers and devices. We support [every major browser](https://www.browserstack.com/list-of-browsers-and-platforms/live) across every major OS.
@@ -67,27 +64,39 @@ Similar to the app testing, you can use the following prompts to test your **web
 
 ### 🧪 Automated Testing (Playwright, Selenium, A11y and more..)
 
-Use the following prompts to run/debug/fix your **automated tests** on BrowserStack's [Test Platform](https://www.browserstack.com/test-platform).
+Auto-analyze, diagnose, and even fix broken test scripts right in your IDE or LLM. Instantly fetch logs, identify root causes, and apply context-aware fixes. No more debugging loops.
+Below are few example prompts to run/debug/fix your automated tests on BrowserStack's [Test Platform](https://www.browserstack.com/test-platform).
 
 ```bash
-# Port test suite to BrowserStack
-"run my test suite on BrowserStack infra"
+#Port test suite to BrowserStack
+"Setup test suite to run on BrowserStack infra"
 
-# Debug test failures
-"My test suite failed, can you help me fix the new failures?"
+#Run tests on BrowserStack
+“Run my tests on BrowserStack”
 
-# Accessibility testing
-"check for accessibility issues on my www.mywebsite.com"
-```
+#AI powered debugging of test failures
+"My App Automate tests have failed, can you help me fix the new failures?"
 
+```
 - Fix test failures reported by your CI/CD pipeline by utilising our industry leading [Test Observability](https://www.browserstack.com/docs/test-observability) features. Find more info [here](https://www.browserstack.com/docs/test-observability/features/smart-tags).
 - Run tests written in Jest, Playwright, Selenium, and more on BrowserStack's [Test Platform](https://www.browserstack.com/test-platform)
-- **Accessibility Testing**: Ensure WCAG and ADA compliance with our [Accessibility Testing](https://www.browserstack.com/accessibility-testing) tool
 
+### 🌐 Accessibility
+
+Catch accessibility issues early with automated, local a11y scans. Get one-click, AI-suggested fixes. No docs hunting, no CI surprises. Ensure WCAG and ADA compliance with our Accessibility Testing tool
+
+```bash
+#Scan accessibility issues while development
+"Scan & help fix accessibility issues for my website running locally on localhost:3000"
+
+#Scan accessibility issues on production site
+“Run accessibility scan & identify issues on my website - www.bstackdemo.com”
+
+```
 
 ### 📋 Test Management 
 
-Use the following prompts to utilise capabilities of BrowserStack's [Test Management](https://www.browserstack.com/test-management) with MCP server.
+Create and manage test cases, create test plans and trigger test runs using natural language. Below are a few example prompts to utilise capabilities of BrowserStack's [Test Management](https://www.browserstack.com/test-management) with MCP server.
 
 ```bash
 # Create project & folder structure
@@ -106,6 +115,24 @@ Use the following prompts to utilise capabilities of BrowserStack's [Test Manage
 "update test results as passed for Login tests test run from My Demo Project"
 ```
 
+### 🧪 Access BrowserStack AI agnets 
+
+Generate test cases from PRDs, convert manual tests to low-code automation, and auto-heal flaky scripts powered by BrowserStack’s AI agents, seamlessly integrated into your workflow.  Below are few example prompts to access Browserstack AI agents
+
+```bash
+#Test case generator agent
+"With Browserstack AI, create relevant test cases for my PRD located at /usr/file/location"
+
+
+#Low code authoring agent
+“With Browserstack AI, automate my manual test case X, added in Test Management”
+
+
+#Self healing agent
+“Help fix flaky tests in my test script with Browserstack AI self healing”
+```
+
+
 ## 🛠️ Installation
 
 1. **Create a BrowserStack Account**
@@ -113,9 +140,7 @@ Use the following prompts to utilise capabilities of BrowserStack's [Test Manage
    - Sign up for [BrowserStack](https://www.browserstack.com/users/sign_up) if you don't have an account already.
 
    - ℹ️ If you have an open-source project, we'll be able to provide you with a [free plan](https://www.browserstack.com/open-source).
-   <div align="center">
-   <img src="assets/open-source-plan.png" alt="Open Source Plan">
-   </div>
+   
 
    - Once you have an account (and purchased appropriate plan), note down your `username` and `access_key` from [Account Settings](https://www.browserstack.com/accounts/profile/details).
 
@@ -175,6 +200,25 @@ Use the following prompts to utilise capabilities of BrowserStack's [Test Manage
      }
    }
    ```
+   - Cline
+     
+Click the “MCP Servers” icon in the navigation bar
+Select the “Installed” tab. Click the “Configure MCP Servers” button at the bottom of the pane.
+
+   ```json
+   {
+     "mcpServers": {
+       "browserstack": {
+         "command": "npx",
+         "args": ["-y", "@browserstack/mcp-server@latest"],
+         "env": {
+           "BROWSERSTACK_USERNAME": "<username>",
+           "BROWSERSTACK_ACCESS_KEY": "<access_key>"
+         }
+       }
+     }
+   }
+   ```
 
 ### Installing via Smithery
 
@@ -203,17 +247,9 @@ We welcome contributions! Please open an issue to discuss any changes you'd like
 
 For support, please:
 
-- Check our [documentation](https://www.browserstack.com/docs)
 - Open an issue in our [GitHub repository](https://github.com/browserstack/mcp-server) if you face any issues related to the MCP Server.
 - Contact our [support team](https://www.browserstack.com/contact) for any other queries.
 
 ## 🚀 More Features Coming Soon
 
 Stay tuned for exciting updates! Have any suggestions? Please open an issue to discuss.
-
-## 🔗 Resources
-
-- [BrowserStack Test Platform](https://www.browserstack.com/test-platform)
-- [MCP Protocol Documentation](https://modelcontextprotocol.io)
-- [Device Grid](https://www.browserstack.com/list-of-browsers-and-platforms/app_live)
-- [Accessibility Testing](https://www.browserstack.com/accessibility-testing)

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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.
+ */
+export declare class Config {
+    readonly DEV_MODE: boolean;
+    readonly browserstackLocalOptions: Record<string, any>;
+    readonly USE_OWN_LOCAL_BINARY_PROCESS: boolean;
+    readonly REMOTE_MCP: boolean;
+    constructor(DEV_MODE: boolean, browserstackLocalOptions: Record<string, any>, USE_OWN_LOCAL_BINARY_PROCESS: boolean, REMOTE_MCP: boolean);
+}
+declare const config: Config;
+export default config;

package/dist/config.js

@@ -28,17 +28,21 @@ for (const key of BROWSERSTACK_LOCAL_OPTION_KEYS) {
         browserstackLocalOptions[key] = envVar;
     }
 }
+/**
+ * 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.
+ */
 export class Config {
-    browserstackUsername;
-    browserstackAccessKey;
     DEV_MODE;
     browserstackLocalOptions;
-    constructor(browserstackUsername, browserstackAccessKey, DEV_MODE, browserstackLocalOptions) {
-        this.browserstackUsername = browserstackUsername;
-        this.browserstackAccessKey = browserstackAccessKey;
+    USE_OWN_LOCAL_BINARY_PROCESS;
+    REMOTE_MCP;
+    constructor(DEV_MODE, browserstackLocalOptions, USE_OWN_LOCAL_BINARY_PROCESS, REMOTE_MCP) {
         this.DEV_MODE = DEV_MODE;
         this.browserstackLocalOptions = browserstackLocalOptions;
+        this.USE_OWN_LOCAL_BINARY_PROCESS = USE_OWN_LOCAL_BINARY_PROCESS;
+        this.REMOTE_MCP = REMOTE_MCP;
     }
 }
-const config = new Config(process.env.BROWSERSTACK_USERNAME, process.env.BROWSERSTACK_ACCESS_KEY, process.env.DEV_MODE === "true", browserstackLocalOptions);
+const config = new Config(process.env.DEV_MODE === "true", browserstackLocalOptions, process.env.USE_OWN_LOCAL_BINARY_PROCESS === "true", process.env.REMOTE_MCP === "true");
 export default config;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import "dotenv/config";
+export { createMcpServer } from "./server-factory.js";
+export { setLogger } from "./logger.js";

package/dist/index.js

@@ -1,43 +1,31 @@
 #!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createRequire } from "module";
 const require = createRequire(import.meta.url);
 const packageJson = require("../package.json");
 import "dotenv/config";
 import logger from "./logger.js";
-import addSDKTools from "./tools/bstack-sdk.js";
-import addAppLiveTools from "./tools/applive.js";
-import addBrowserLiveTools from "./tools/live.js";
-import addAccessibilityTools from "./tools/accessibility.js";
-import addTestManagementTools from "./tools/testmanagement.js";
-import addAppAutomationTools from "./tools/appautomate.js";
-import addFailureLogsTools from "./tools/getFailureLogs.js";
-import addAutomateTools from "./tools/automate.js";
-import addSelfHealTools from "./tools/selfheal.js";
-import { setupOnInitialized } from "./oninitialized.js";
-function registerTools(server) {
-    addAccessibilityTools(server);
-    addSDKTools(server);
-    addAppLiveTools(server);
-    addBrowserLiveTools(server);
-    addTestManagementTools(server);
-    addAppAutomationTools(server);
-    addFailureLogsTools(server);
-    addAutomateTools(server);
-    addSelfHealTools(server);
-}
-// Create an MCP server
-const server = new McpServer({
-    name: "BrowserStack MCP Server",
-    version: packageJson.version,
-});
-setupOnInitialized(server);
-registerTools(server);
+import { createMcpServer } from "./server-factory.js";
 async function main() {
     logger.info("Launching BrowserStack MCP server, version %s", packageJson.version);
-    // Start receiving messages on stdin and sending messages on stdout
+    const remoteMCP = process.env.REMOTE_MCP === "true";
+    if (remoteMCP) {
+        logger.info("Running in remote MCP mode");
+        return;
+    }
+    const username = process.env.BROWSERSTACK_USERNAME;
+    const accessKey = process.env.BROWSERSTACK_ACCESS_KEY;
+    if (!username) {
+        throw new Error("BROWSERSTACK_USERNAME environment variable is required");
+    }
+    if (!accessKey) {
+        throw new Error("BROWSERSTACK_ACCESS_KEY environment variable is required");
+    }
     const transport = new StdioServerTransport();
+    const server = createMcpServer({
+        "browserstack-username": username,
+        "browserstack-access-key": accessKey,
+    });
     await server.connect(transport);
 }
 main().catch(console.error);
@@ -45,3 +33,5 @@ main().catch(console.error);
 process.on("exit", () => {
     logger.flush();
 });
+export { createMcpServer } from "./server-factory.js";
+export { setLogger } from "./logger.js";

package/dist/lib/api.d.ts

@@ -0,0 +1,2 @@
+import { BrowserStackConfig } from "../lib/types.js";
+export declare function getLatestO11YBuildInfo(buildName: string, projectName: string, config: BrowserStackConfig): Promise<import("./apiClient.js").ApiResponse<any>>;

package/dist/lib/api.js

@@ -1,10 +1,15 @@
-import config from "../config.js";
-export async function getLatestO11YBuildInfo(buildName, projectName) {
+import { getBrowserStackAuth } from "./get-auth.js";
+import { apiClient } from "./apiClient.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 buildsResponse = await fetch(buildsUrl, {
+    const authString = getBrowserStackAuth(config);
+    const auth = Buffer.from(authString).toString("base64");
+    const buildsResponse = await apiClient.get({
+        url: buildsUrl,
         headers: {
-            Authorization: `Basic ${Buffer.from(`${config.browserstackUsername}:${config.browserstackAccessKey}`).toString("base64")}`,
+            Authorization: `Basic ${auth}`,
         },
+        raise_error: false,
     });
     if (!buildsResponse.ok) {
         if (buildsResponse.statusText === "Unauthorized") {
@@ -12,5 +17,5 @@ export async function getLatestO11YBuildInfo(buildName, projectName) {
         }
         throw new Error(`Failed to fetch builds: ${buildsResponse.statusText}`);
     }
-    return buildsResponse.json();
+    return buildsResponse;
 }

package/dist/lib/apiClient.d.ts

@@ -0,0 +1,31 @@
+import { AxiosRequestConfig, AxiosResponse } from "axios";
+type RequestOptions = {
+    url: string;
+    headers?: Record<string, string>;
+    params?: Record<string, string | number>;
+    body?: any;
+    raise_error?: boolean;
+};
+declare class ApiResponse<T = any> {
+    private _response;
+    constructor(response: AxiosResponse<T>);
+    get data(): T;
+    get status(): number;
+    get statusText(): string;
+    get headers(): Record<string, string>;
+    get config(): AxiosRequestConfig;
+    get url(): string | undefined;
+    get ok(): boolean;
+}
+declare class ApiClient {
+    private instance;
+    private get axiosAgent();
+    private requestWrapper;
+    get<T = any>({ url, headers, params, raise_error, }: RequestOptions): Promise<ApiResponse<T>>;
+    post<T = any>({ url, headers, body, raise_error, }: RequestOptions): Promise<ApiResponse<T>>;
+    put<T = any>({ url, headers, body, raise_error, }: RequestOptions): Promise<ApiResponse<T>>;
+    patch<T = any>({ url, headers, body, raise_error, }: RequestOptions): Promise<ApiResponse<T>>;
+    delete<T = any>({ url, headers, params, raise_error, }: RequestOptions): Promise<ApiResponse<T>>;
+}
+export declare const apiClient: ApiClient;
+export type { ApiResponse, RequestOptions };

package/dist/lib/apiClient.js

@@ -0,0 +1,108 @@
+import axios from "axios";
+import httpsProxyAgentPkg from "https-proxy-agent";
+const { HttpsProxyAgent } = httpsProxyAgentPkg;
+import * as https from "https";
+import * as fs from "fs";
+import config from "../config.js";
+class ApiResponse {
+    _response;
+    constructor(response) {
+        this._response = response;
+    }
+    get data() {
+        return this._response.data;
+    }
+    get status() {
+        return this._response.status;
+    }
+    get statusText() {
+        return this._response.statusText;
+    }
+    get headers() {
+        const raw = this._response.headers;
+        const sanitized = {};
+        for (const key in raw) {
+            const value = raw[key];
+            if (typeof value === "string") {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    get config() {
+        return this._response.config;
+    }
+    get url() {
+        return this._response.config.url;
+    }
+    get ok() {
+        return this._response.status >= 200 && this._response.status < 300;
+    }
+}
+// Utility to create HTTPS agent if needed (proxy/CA)
+function getAxiosAgent() {
+    const proxyHost = config.browserstackLocalOptions.proxyHost;
+    const proxyPort = config.browserstackLocalOptions.proxyPort;
+    const caCertPath = config.browserstackLocalOptions.useCaCertificate;
+    // If both proxy host and port are defined
+    if (proxyHost && proxyPort) {
+        const proxyUrl = `http://${proxyHost}:${proxyPort}`;
+        if (caCertPath && fs.existsSync(caCertPath)) {
+            // Proxy + CA cert
+            const ca = fs.readFileSync(caCertPath);
+            return new HttpsProxyAgent({
+                host: proxyHost,
+                port: Number(proxyPort),
+                ca,
+                rejectUnauthorized: false, // Set to true if you want strict SSL
+            });
+        }
+        else {
+            // Proxy only
+            return new HttpsProxyAgent(proxyUrl);
+        }
+    }
+    else if (caCertPath && fs.existsSync(caCertPath)) {
+        // CA only
+        return new https.Agent({
+            ca: fs.readFileSync(caCertPath),
+            rejectUnauthorized: false, // Set to true for strict SSL
+        });
+    }
+    // Default agent (no proxy, no CA)
+    return undefined;
+}
+class ApiClient {
+    instance = axios.create();
+    get axiosAgent() {
+        return getAxiosAgent();
+    }
+    async requestWrapper(fn, raise_error = true) {
+        try {
+            const res = await fn(this.axiosAgent);
+            return new ApiResponse(res);
+        }
+        catch (error) {
+            if (error.response && !raise_error) {
+                return new ApiResponse(error.response);
+            }
+            throw error;
+        }
+    }
+    async get({ url, headers, params, raise_error = true, }) {
+        return this.requestWrapper((agent) => this.instance.get(url, { headers, params, httpsAgent: agent }), raise_error);
+    }
+    async post({ url, headers, body, raise_error = true, }) {
+        return this.requestWrapper((agent) => this.instance.post(url, body, { headers, httpsAgent: agent }), raise_error);
+    }
+    async put({ url, headers, body, raise_error = true, }) {
+        return this.requestWrapper((agent) => this.instance.put(url, body, { headers, httpsAgent: agent }), raise_error);
+    }
+    async patch({ url, headers, body, raise_error = true, }) {
+        return this.requestWrapper((agent) => this.instance.patch(url, body, { headers, httpsAgent: agent }), raise_error);
+    }
+    async delete({ url, headers, params, raise_error = true, }) {
+        return this.requestWrapper((agent) => this.instance.delete(url, { headers, params, httpsAgent: agent }), raise_error);
+    }
+}
+export const apiClient = new ApiClient();

package/dist/lib/constants.d.ts

@@ -0,0 +1,17 @@
+export declare const SessionType: {
+    readonly Automate: "automate";
+    readonly AppAutomate: "app-automate";
+};
+export declare const AutomateLogType: {
+    readonly NetworkLogs: "networkLogs";
+    readonly SessionLogs: "sessionLogs";
+    readonly ConsoleLogs: "consoleLogs";
+};
+export declare const AppAutomateLogType: {
+    readonly DeviceLogs: "deviceLogs";
+    readonly AppiumLogs: "appiumLogs";
+    readonly CrashLogs: "crashLogs";
+};
+export type SessionType = (typeof SessionType)[keyof typeof SessionType];
+export type AutomateLogType = (typeof AutomateLogType)[keyof typeof AutomateLogType];
+export type AppAutomateLogType = (typeof AppAutomateLogType)[keyof typeof AppAutomateLogType];

package/dist/lib/device-cache.d.ts

@@ -0,0 +1,9 @@
+export declare enum BrowserStackProducts {
+    LIVE = "live",
+    APP_LIVE = "app_live",
+    APP_AUTOMATE = "app_automate"
+}
+/**
+ * Fetches and caches BrowserStack datasets (live + app_live + app_automate) with a shared TTL.
+ */
+export declare function getDevicesAndBrowsers(type: BrowserStackProducts): Promise<any>;

package/dist/lib/device-cache.js

@@ -1,6 +1,7 @@
 import fs from "fs";
 import os from "os";
 import path from "path";
+import { apiClient } from "./apiClient.js";
 const CACHE_DIR = path.join(os.homedir(), ".browserstack", "combined_cache");
 const CACHE_FILE = path.join(CACHE_DIR, "data.json");
 const TTL_MS = 24 * 60 * 60 * 1000; // 1 day
@@ -38,13 +39,12 @@ export async function getDevicesAndBrowsers(type) {
             }
         }
     }
-    const liveRes = await fetch(URLS[type]);
+    const liveRes = await apiClient.get({ url: URLS[type], raise_error: false });
     if (!liveRes.ok) {
         throw new Error(`Failed to fetch configuration from BrowserStack : ${type}=${liveRes.statusText}`);
     }
-    const data = await liveRes.json();
     cache = {
-        [type]: data,
+        [type]: liveRes.data,
     };
     fs.writeFileSync(CACHE_FILE, JSON.stringify(cache), "utf8");
     return cache[type];

package/dist/lib/error.d.ts

@@ -0,0 +1,7 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Formats an AxiosError into a CallToolResult with an appropriate message.
+ * @param err - The error object to format
+ * @param defaultText - The fallback error message
+ */
+export declare function formatAxiosError(err: unknown, defaultText: string): CallToolResult;

package/dist/lib/fuzzy.d.ts

@@ -0,0 +1 @@
+export declare function customFuzzySearch<T>(list: T[], keys: Array<keyof T | string>, query: string, limit?: number, maxDistance?: number): T[];

package/dist/lib/get-auth.d.ts

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

package/dist/lib/get-auth.js

@@ -0,0 +1,8 @@
+export function getBrowserStackAuth(config) {
+    const username = config["browserstack-username"];
+    const accessKey = config["browserstack-access-key"];
+    if (!username || !accessKey) {
+        throw new Error("BrowserStack credentials not set on server.authHeaders");
+    }
+    return `${username}:${accessKey}`;
+}

package/dist/lib/inmemory-store.d.ts

@@ -0,0 +1 @@
+export declare const signedUrlMap: Map<string, object>;

package/dist/lib/instrumentation.d.ts

@@ -0,0 +1,4 @@
+export declare function trackMCP(toolName: string, clientInfo: {
+    name?: string;
+    version?: string;
+}, error?: unknown, config?: any): void;

package/dist/lib/instrumentation.js

@@ -1,14 +1,10 @@
 import logger from "../logger.js";
-import config from "../config.js";
+import { getBrowserStackAuth } from "./get-auth.js";
 import { createRequire } from "module";
 const require = createRequire(import.meta.url);
 const packageJson = require("../../package.json");
 import axios from "axios";
-export function trackMCP(toolName, clientInfo, error) {
-    if (config.DEV_MODE) {
-        logger.info("Tracking MCP is disabled in dev mode");
-        return;
-    }
+export function trackMCP(toolName, clientInfo, error, config) {
     const instrumentationEndpoint = "https://api.browserstack.com/sdk/v1/event";
     const isSuccess = !error;
     const mcpClient = clientInfo?.name || "unknown";
@@ -35,11 +31,16 @@ export function trackMCP(toolName, clientInfo, error) {
         event.event_properties.error_type =
             error instanceof Error ? error.constructor.name : "Unknown";
     }
+    let authHeader = undefined;
+    if (config) {
+        const authString = getBrowserStackAuth(config);
+        authHeader = `Basic ${Buffer.from(authString).toString("base64")}`;
+    }
     axios
         .post(instrumentationEndpoint, event, {
         headers: {
             "Content-Type": "application/json",
-            Authorization: `Basic ${Buffer.from(`${config.browserstackUsername}:${config.browserstackAccessKey}`).toString("base64")}`,
+            ...(authHeader ? { Authorization: authHeader } : {}),
         },
         timeout: 2000,
     })

package/dist/lib/local.d.ts

@@ -0,0 +1,3 @@
+export declare function killExistingBrowserStackLocalProcesses(): Promise<void>;
+export declare function ensureLocalBinarySetup(username: string, password: string, localIdentifier?: string): Promise<void>;
+export declare function isLocalURL(url: string): boolean;

package/dist/lib/local.js

@@ -65,15 +65,24 @@ export async function killExistingBrowserStackLocalProcesses() {
         // Continue execution as there may not be any processes running
     }
 }
-export async function ensureLocalBinarySetup(localIdentifier) {
+export async function ensureLocalBinarySetup(username, password, localIdentifier) {
     logger.info("Ensuring local binary setup as it is required for private URLs...");
+    if (config.USE_OWN_LOCAL_BINARY_PROCESS) {
+        logger.info("Using user's own BrowserStack Local binary process, checking if it's running...");
+        const isRunning = await isBrowserStackLocalRunning();
+        if (!isRunning) {
+            throw new Error("USE_OWN_LOCAL_BINARY_PROCESS is enabled but BrowserStack Local process is not running. Please start your BrowserStack Local binary process first.");
+        }
+        logger.info("BrowserStack Local process is running, proceeding with user's own process.");
+        return;
+    }
     const localBinary = new Local();
     await killExistingBrowserStackLocalProcesses();
     // Use a single options object from config and extend with required fields
     const bsLocalArgs = {
         ...(config.browserstackLocalOptions || {}),
-        key: config.browserstackAccessKey,
-        username: config.browserstackUsername,
+        key: password,
+        username,
     };
     if (localIdentifier) {
         bsLocalArgs.localIdentifier = localIdentifier;

package/dist/lib/types.d.ts

@@ -0,0 +1,4 @@
+export type BrowserStackConfig = {
+    "browserstack-username": string;
+    "browserstack-access-key": string;
+};

package/dist/lib/types.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/utils.d.ts

@@ -0,0 +1,4 @@
+import type { ApiResponse } from "./apiClient.js";
+export declare function sanitizeUrlParam(param: string): string;
+export declare function maybeCompressBase64(base64: string): Promise<string>;
+export declare function assertOkResponse(response: Response | ApiResponse, action: string): Promise<void>;