@browserstack/mcp-server 1.0.11 → 1.0.12

package/dist/config.js

@@ -8,11 +8,13 @@ if (!process.env.BROWSERSTACK_ACCESS_KEY ||
 class Config {
     browserstackUsername;
     browserstackAccessKey;
-    constructor(browserstackUsername, browserstackAccessKey) {
+    DEV_MODE;
+    constructor(browserstackUsername, browserstackAccessKey, DEV_MODE) {
         this.browserstackUsername = browserstackUsername;
         this.browserstackAccessKey = browserstackAccessKey;
+        this.DEV_MODE = DEV_MODE;
     }
 }
 exports.Config = Config;
-const config = new Config(process.env.BROWSERSTACK_USERNAME, process.env.BROWSERSTACK_ACCESS_KEY);
+const config = new Config(process.env.BROWSERSTACK_USERNAME, process.env.BROWSERSTACK_ACCESS_KEY, process.env.DEV_MODE === "true");
 exports.default = config;

package/dist/lib/instrumentation.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackMCP = trackMCP;
+const logger_1 = __importDefault(require("../logger"));
+const config_1 = __importDefault(require("../config"));
+const package_json_1 = __importDefault(require("../../package.json"));
+const axios_1 = __importDefault(require("axios"));
+function trackMCP(toolName, clientInfo, error) {
+    if (config_1.default.DEV_MODE) {
+        logger_1.default.info("Tracking MCP is disabled in dev mode");
+        return;
+    }
+    const instrumentationEndpoint = "https://api.browserstack.com/sdk/v1/event";
+    const isSuccess = !error;
+    const mcpClient = clientInfo?.name || "unknown";
+    // Log client information
+    if (clientInfo?.name) {
+        logger_1.default.info(`Client connected: ${clientInfo.name} (version: ${clientInfo.version})`);
+    }
+    else {
+        logger_1.default.info("Client connected: unknown client");
+    }
+    const event = {
+        event_type: "MCPInstrumentation",
+        event_properties: {
+            mcp_version: package_json_1.default.version,
+            tool_name: toolName,
+            mcp_client: mcpClient,
+            success: isSuccess,
+        },
+    };
+    // Add error details if applicable
+    if (error) {
+        event.event_properties.error_message =
+            error instanceof Error ? error.message : String(error);
+        event.event_properties.error_type =
+            error instanceof Error ? error.constructor.name : "Unknown";
+    }
+    axios_1.default
+        .post(instrumentationEndpoint, event, {
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Basic ${Buffer.from(`${config_1.default.browserstackUsername}:${config_1.default.browserstackAccessKey}`).toString("base64")}`,
+        },
+        timeout: 2000,
+    })
+        .catch(() => { });
+}

package/dist/tools/accessibility.js

@@ -3,41 +3,44 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = addAccessibilityTools;
 const zod_1 = require("zod");
 const accessibility_1 = require("./accessiblity-utils/accessibility");
+const instrumentation_1 = require("../lib/instrumentation");
 async function runAccessibilityScan(name, pageURL) {
-    try {
-        const response = await (0, accessibility_1.startAccessibilityScan)(name, [pageURL]);
-        const scanId = response.data?.id;
-        const scanRunId = response.data?.scanRunId;
-        if (!scanId || !scanRunId) {
-            throw new Error("Unable to start a accessibility scan, please try again later or open an issue on GitHub if the problem persists");
-        }
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Successfully queued accessibility scan, you will get a report via email within 5 minutes.`,
-                },
-            ],
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to start accessibility scan: ${error instanceof Error ? error.message : "Unknown error"}. Please open an issue on GitHub if the problem persists`,
-                    isError: true,
-                },
-            ],
-            isError: true,
-        };
+    const response = await (0, accessibility_1.startAccessibilityScan)(name, [pageURL]);
+    const scanId = response.data?.id;
+    const scanRunId = response.data?.scanRunId;
+    if (!scanId || !scanRunId) {
+        throw new Error("Unable to start a accessibility scan, please try again later or open an issue on GitHub if the problem persists");
     }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Successfully queued accessibility scan, you will get a report via email within 5 minutes.`,
+            },
+        ],
+    };
 }
 function addAccessibilityTools(server) {
     server.tool("startAccessibilityScan", "Use this tool to start an accessibility scan for a list of URLs on BrowserStack.", {
         name: zod_1.z.string().describe("Name of the accessibility scan"),
         pageURL: zod_1.z.string().describe("The URL to scan for accessibility issues"),
     }, async (args) => {
-        return runAccessibilityScan(args.name, args.pageURL);
+        try {
+            (0, instrumentation_1.trackMCP)("startAccessibilityScan", server.server.getClientVersion());
+            return await runAccessibilityScan(args.name, args.pageURL);
+        }
+        catch (error) {
+            (0, instrumentation_1.trackMCP)("startAccessibilityScan", server.server.getClientVersion(), error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to start accessibility scan: ${error instanceof Error ? error.message : "Unknown error"}. Please open an issue on GitHub if the problem persists`,
+                        isError: true,
+                    },
+                ],
+                isError: true,
+            };
+        }
     });
 }

package/dist/tools/applive.js

@@ -9,6 +9,7 @@ const zod_1 = require("zod");
 const fs_1 = __importDefault(require("fs"));
 const start_session_1 = require("./applive-utils/start-session");
 const logger_1 = __importDefault(require("../logger"));
+const instrumentation_1 = require("../lib/instrumentation");
 /**
  * Launches an App Live Session on BrowserStack.
  */
@@ -70,14 +71,17 @@ function addAppLiveTools(server) {
             .describe("The path to the .ipa or .apk file to install on the device. Always ask the user for the app path, do not assume it."),
     }, async (args) => {
         try {
-            return startAppLiveSession(args);
+            (0, instrumentation_1.trackMCP)("runAppLiveSession", server.server.getClientVersion());
+            return await startAppLiveSession(args);
         }
         catch (error) {
+            logger_1.default.error("App live session failed: %s", error);
+            (0, instrumentation_1.trackMCP)("runAppLiveSession", server.server.getClientVersion(), error);
             return {
                 content: [
                     {
                         type: "text",
-                        text: `Failed to start an app live session. Error: ${error}. Please open an issue on GitHub if the problem persists`,
+                        text: `Failed to start app live session: ${error instanceof Error ? error.message : String(error)}`,
                         isError: true,
                     },
                 ],

package/dist/tools/automate.js

@@ -8,6 +8,7 @@ exports.default = addAutomateTools;
 const zod_1 = require("zod");
 const logger_1 = __importDefault(require("../logger"));
 const api_1 = require("../lib/api");
+const instrumentation_1 = require("../lib/instrumentation");
 /**
  * Fetches failed network requests from a BrowserStack Automate session.
  * Returns network requests that resulted in errors or failed to complete.
@@ -31,22 +32,32 @@ async function getNetworkFailures(args) {
         };
     }
     catch (error) {
-        const errorMessage = error instanceof Error ? error.message : "An unknown error occurred";
-        logger_1.default.error("Failed to fetch network logs: %s", errorMessage);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to fetch network logs: ${errorMessage}`,
-                    isError: true,
-                },
-            ],
-            isError: true,
-        };
+        logger_1.default.error("Failed to fetch network logs: %s", error);
+        throw new Error(error instanceof Error ? error.message : String(error));
     }
 }
 function addAutomateTools(server) {
     server.tool("getNetworkFailures", "Use this tool to fetch failed network requests from a BrowserStack Automate session.", {
         sessionId: zod_1.z.string().describe("The Automate session ID."),
-    }, getNetworkFailures);
+    }, async (args) => {
+        try {
+            (0, instrumentation_1.trackMCP)("getNetworkFailures", server.server.getClientVersion());
+            return await getNetworkFailures(args);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger_1.default.error("Failed to fetch network logs: %s", errorMessage);
+            (0, instrumentation_1.trackMCP)("getNetworkFailures", server.server.getClientVersion(), error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to fetch network logs: ${errorMessage}`,
+                        isError: true,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
 }

package/dist/tools/bstack-sdk.js

@@ -4,6 +4,7 @@ exports.bootstrapProjectWithSDK = bootstrapProjectWithSDK;
 exports.default = addSDKTools;
 const zod_1 = require("zod");
 const instructions_1 = require("./sdk-utils/instructions");
+const instrumentation_1 = require("../lib/instrumentation");
 /**
  * BrowserStack SDK hooks into your test framework to seamlessly run tests on BrowserStack.
  * This tool gives instructions to setup a browserstack.yml file in the project root and installs the necessary dependencies.
@@ -36,19 +37,17 @@ function addSDKTools(server) {
             .array(zod_1.z.enum(["windows", "macos", "android", "ios"]))
             .describe("The platforms the user wants to test on. Always ask this to the user, do not try to infer this."),
     }, async (args) => {
-        const detectedBrowserAutomationFramework = args.detectedBrowserAutomationFramework;
-        const detectedTestingFramework = args.detectedTestingFramework;
-        const detectedLanguage = args.detectedLanguage;
-        const desiredPlatforms = args.desiredPlatforms;
         try {
-            return bootstrapProjectWithSDK({
-                detectedBrowserAutomationFramework,
-                detectedTestingFramework,
-                detectedLanguage,
-                desiredPlatforms,
+            (0, instrumentation_1.trackMCP)("runTestsOnBrowserStack", server.server.getClientVersion());
+            return await bootstrapProjectWithSDK({
+                detectedBrowserAutomationFramework: args.detectedBrowserAutomationFramework,
+                detectedTestingFramework: args.detectedTestingFramework,
+                detectedLanguage: args.detectedLanguage,
+                desiredPlatforms: args.desiredPlatforms,
             });
         }
         catch (error) {
+            (0, instrumentation_1.trackMCP)("runTestsOnBrowserStack", server.server.getClientVersion(), error);
             return {
                 content: [
                     {

package/dist/tools/live.js

@@ -8,6 +8,7 @@ const zod_1 = require("zod");
 const logger_1 = __importDefault(require("../logger"));
 const start_session_1 = require("./live-utils/start-session");
 const types_1 = require("./live-utils/types");
+const instrumentation_1 = require("../lib/instrumentation");
 // Define the schema shape
 const LiveArgsShape = {
     platformType: zod_1.z
@@ -68,41 +69,28 @@ async function launchMobileSession(args) {
 async function runBrowserSession(rawArgs) {
     // Validate and narrow
     const args = LiveArgsSchema.parse(rawArgs);
-    try {
-        // Branch desktop vs mobile and delegate
-        const launchUrl = args.platformType === types_1.PlatformType.DESKTOP
-            ? await launchDesktopSession(args)
-            : await launchMobileSession(args);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `✅ Session started. If it didn't open automatically, visit:\n${launchUrl}`,
-                },
-            ],
-        };
-    }
-    catch (err) {
-        logger_1.default.error("Live session failed: %s", err);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ Failed to start session: ${err.message || err}`,
-                    isError: true,
-                },
-            ],
-            isError: true,
-        };
-    }
+    // Branch desktop vs mobile and delegate
+    const launchUrl = args.platformType === types_1.PlatformType.DESKTOP
+        ? await launchDesktopSession(args)
+        : await launchMobileSession(args);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `✅ Session started. If it didn't open automatically, visit:\n${launchUrl}`,
+            },
+        ],
+    };
 }
 function addBrowserLiveTools(server) {
     server.tool("runBrowserLiveSession", "Launch a BrowserStack Live session (desktop or mobile).", LiveArgsShape, async (args) => {
         try {
-            const result = await runBrowserSession(args);
-            return result;
+            (0, instrumentation_1.trackMCP)("runBrowserLiveSession", server.server.getClientVersion());
+            return await runBrowserSession(args);
         }
         catch (error) {
+            logger_1.default.error("Live session failed: %s", error);
+            (0, instrumentation_1.trackMCP)("runBrowserLiveSession", server.server.getClientVersion(), error);
             return {
                 content: [
                     {

package/dist/tools/observability.js

@@ -1,9 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFailuresInLastRun = getFailuresInLastRun;
 exports.default = addObservabilityTools;
 const zod_1 = require("zod");
 const api_1 = require("../lib/api");
+const instrumentation_1 = require("../lib/instrumentation");
+const logger_1 = __importDefault(require("../logger"));
 async function getFailuresInLastRun(buildName, projectName) {
     const buildsData = await (0, api_1.getLatestO11YBuildInfo)(buildName, projectName);
     const observabilityUrl = buildsData.observability_url;
@@ -40,9 +45,12 @@ function addObservabilityTools(server) {
             .describe("Name of the project to get failures for. This is the 'projectName' key in the browserstack.yml file. If not sure, ask the user for the project name."),
     }, async (args) => {
         try {
-            return getFailuresInLastRun(args.buildName, args.projectName);
+            (0, instrumentation_1.trackMCP)("getFailuresInLastRun", server.server.getClientVersion());
+            return await getFailuresInLastRun(args.buildName, args.projectName);
         }
         catch (error) {
+            logger_1.default.error("Failed to get failures in the last run: %s", error);
+            (0, instrumentation_1.trackMCP)("getFailuresInLastRun", server.server.getClientVersion(), error);
             return {
                 content: [
                     {

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

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateTestRunSchema = void 0;
+exports.createTestRun = createTestRun;
+const axios_1 = __importDefault(require("axios"));
+const config_1 = __importDefault(require("../../config"));
+const zod_1 = require("zod");
+const error_1 = require("../../lib/error");
+/**
+ * Schema for creating a test run.
+ */
+exports.CreateTestRunSchema = zod_1.z.object({
+    project_identifier: zod_1.z
+        .string()
+        .describe("Identifier of the project in which to create the test run."),
+    test_run: zod_1.z.object({
+        name: zod_1.z.string().describe("Name of the test run"),
+        description: zod_1.z
+            .string()
+            .optional()
+            .describe("Brief information about the test run"),
+        run_state: zod_1.z
+            .enum([
+            "new_run",
+            "in_progress",
+            "under_review",
+            "rejected",
+            "done",
+            "closed",
+        ])
+            .optional()
+            .describe("State of the test run. One of new_run, in_progress, under_review, rejected, done, closed"),
+        issues: zod_1.z.array(zod_1.z.string()).optional().describe("Linked issue IDs"),
+        issue_tracker: zod_1.z
+            .object({ name: zod_1.z.string(), host: zod_1.z.string().url() })
+            .optional()
+            .describe("Issue tracker configuration"),
+        test_cases: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe("List of test case IDs"),
+        folder_ids: zod_1.z
+            .array(zod_1.z.number())
+            .optional()
+            .describe("Folder IDs to include"),
+    }),
+});
+/**
+ * Creates a test run via BrowserStack Test Management API.
+ */
+async function createTestRun(rawArgs) {
+    try {
+        const inputArgs = {
+            ...rawArgs,
+            test_run: {
+                ...rawArgs.test_run,
+                include_all: false,
+            },
+        };
+        const args = exports.CreateTestRunSchema.parse(inputArgs);
+        const url = `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs`;
+        const response = await axios_1.default.post(url, { test_run: args.test_run }, {
+            auth: {
+                username: config_1.default.browserstackUsername,
+                password: config_1.default.browserstackAccessKey,
+            },
+            headers: { "Content-Type": "application/json" },
+        });
+        const data = response.data;
+        if (!data.success) {
+            throw new Error(`API returned unsuccessful response: ${JSON.stringify(data)}`);
+        }
+        // Assume data.test_run contains created run info
+        const created = data.test_run || data;
+        const runId = created.identifier || created.id || created.name;
+        const summary = `Successfully created test run ${runId}`;
+        return {
+            content: [
+                { type: "text", text: summary },
+                { type: "text", text: JSON.stringify(created, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        return (0, error_1.formatAxiosError)(err, "Failed to create test run");
+    }
+}

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

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListTestCasesSchema = void 0;
+exports.listTestCases = listTestCases;
+const axios_1 = __importDefault(require("axios"));
+const config_1 = __importDefault(require("../../config"));
+const zod_1 = require("zod");
+const error_1 = require("../../lib/error");
+/**
+ * Schema for listing test cases with optional filters.
+ */
+exports.ListTestCasesSchema = zod_1.z.object({
+    project_identifier: zod_1.z
+        .string()
+        .describe("Identifier of the project to fetch test cases from.  Example: PR-12345"),
+    folder_id: zod_1.z
+        .string()
+        .optional()
+        .describe("If provided, only return cases in this folder."),
+    case_type: zod_1.z
+        .string()
+        .optional()
+        .describe("Comma-separated list of case types (e.g. functional,regression)."),
+    priority: zod_1.z
+        .string()
+        .optional()
+        .describe("Comma-separated list of priorities (e.g. critical,medium,low)."),
+    p: zod_1.z.number().optional().describe("Page number."),
+});
+/**
+ * Calls BrowserStack Test Management to list test cases with filters.
+ */
+async function listTestCases(args) {
+    try {
+        // Build query string
+        const params = new URLSearchParams();
+        if (args.folder_id)
+            params.append("folder_id", args.folder_id);
+        if (args.case_type)
+            params.append("case_type", args.case_type);
+        if (args.priority)
+            params.append("priority", args.priority);
+        if (args.p !== undefined)
+            params.append("p", args.p.toString());
+        const url = `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-cases?${params.toString()}`;
+        const resp = await axios_1.default.get(url, {
+            auth: {
+                username: config_1.default.browserstackUsername,
+                password: config_1.default.browserstackAccessKey,
+            },
+        });
+        const resp_data = resp.data;
+        if (!resp_data.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to list test cases: ${JSON.stringify(resp_data)}`,
+                        isError: true,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { test_cases, info } = resp_data;
+        const count = info?.count ?? test_cases.length;
+        // Summary for more focused output
+        const summary = test_cases
+            .map((tc) => `• ${tc.identifier}: ${tc.title} [${tc.case_type} | ${tc.priority}]`)
+            .join("\n");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Found ${count} test case(s):\n\n${summary}`,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify(test_cases, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return (0, error_1.formatAxiosError)(err, "Failed to list test cases");
+    }
+}

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

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListTestRunsSchema = void 0;
+exports.listTestRuns = listTestRuns;
+const axios_1 = __importDefault(require("axios"));
+const config_1 = __importDefault(require("../../config"));
+const zod_1 = require("zod");
+const error_1 = require("../../lib/error");
+/**
+ * Schema for listing test runs with optional filters.
+ */
+exports.ListTestRunsSchema = zod_1.z.object({
+    project_identifier: zod_1.z
+        .string()
+        .describe("Identifier of the project to fetch test runs from (e.g., PR-12345)"),
+    run_state: zod_1.z
+        .string()
+        .optional()
+        .describe("Return all test runs with this state (comma-separated)"),
+});
+/**
+ * Fetches and formats the list of test runs for a project.
+ */
+async function listTestRuns(args) {
+    try {
+        const params = new URLSearchParams();
+        if (args.run_state) {
+            params.set("run_state", args.run_state);
+        }
+        const url = `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs?` + params.toString();
+        const resp = await axios_1.default.get(url, {
+            auth: {
+                username: config_1.default.browserstackUsername,
+                password: config_1.default.browserstackAccessKey,
+            },
+        });
+        const data = resp.data;
+        if (!data.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to list test runs: ${JSON.stringify(data)}`,
+                        isError: true,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const runs = data.test_runs;
+        const count = runs.length;
+        const summary = runs
+            .map((tr) => `• ${tr.identifier}: ${tr.name} [${tr.run_state}]`)
+            .join("\n");
+        return {
+            content: [
+                { type: "text", text: `Found ${count} test run(s):\n\n${summary}` },
+                { type: "text", text: JSON.stringify(runs, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        return (0, error_1.formatAxiosError)(err, "Failed to list test runs");
+    }
+}

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

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateTestRunSchema = void 0;
+exports.updateTestRun = updateTestRun;
+const axios_1 = __importDefault(require("axios"));
+const config_1 = __importDefault(require("../../config"));
+const zod_1 = require("zod");
+const error_1 = require("../../lib/error");
+/**
+ * Schema for updating a test run with partial fields.
+ */
+exports.UpdateTestRunSchema = zod_1.z.object({
+    project_identifier: zod_1.z
+        .string()
+        .describe("Project identifier (e.g., PR-12345)"),
+    test_run_id: zod_1.z.string().describe("Test run identifier (e.g., TR-678)"),
+    test_run: zod_1.z.object({
+        name: zod_1.z.string().optional().describe("New name of the test run"),
+        run_state: zod_1.z
+            .enum([
+            "new_run",
+            "in_progress",
+            "under_review",
+            "rejected",
+            "done",
+            "closed",
+        ])
+            .optional()
+            .describe("Updated state of the test run"),
+    }),
+});
+/**
+ * Partially updates an existing test run.
+ */
+async function updateTestRun(args) {
+    try {
+        const body = { test_run: args.test_run };
+        const url = `https://test-management.browserstack.com/api/v2/projects/${encodeURIComponent(args.project_identifier)}/test-runs/${encodeURIComponent(args.test_run_id)}/update`;
+        const resp = await axios_1.default.patch(url, body, {
+            auth: {
+                username: config_1.default.browserstackUsername,
+                password: config_1.default.browserstackAccessKey,
+            },
+        });
+        const data = resp.data;
+        if (!data.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to update test run: ${JSON.stringify(data)}`,
+                        isError: true,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully updated test run ${args.test_run_id}`,
+                },
+                { type: "text", text: JSON.stringify(data.testrun || data, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        return (0, error_1.formatAxiosError)(err, "Failed to update test run");
+    }
+}

package/dist/tools/testmanagement.js

@@ -1,18 +1,36 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createProjectOrFolderTool = createProjectOrFolderTool;
 exports.createTestCaseTool = createTestCaseTool;
+exports.listTestCasesTool = listTestCasesTool;
+exports.createTestRunTool = createTestRunTool;
+exports.listTestRunsTool = listTestRunsTool;
+exports.updateTestRunTool = updateTestRunTool;
 exports.default = addTestManagementTools;
+const instrumentation_1 = require("../lib/instrumentation");
+const logger_1 = __importDefault(require("../logger"));
 const create_project_folder_1 = require("./testmanagement-utils/create-project-folder");
 const create_testcase_1 = require("./testmanagement-utils/create-testcase");
+let serverInstance;
+const list_testcases_1 = require("./testmanagement-utils/list-testcases");
+const create_testrun_1 = require("./testmanagement-utils/create-testrun");
+const list_testruns_1 = require("./testmanagement-utils/list-testruns");
+const update_testrun_1 = require("./testmanagement-utils/update-testrun");
+//TODO: Moving the traceMCP and catch block to the parent(server) function
 /**
  * Wrapper to call createProjectOrFolder util.
  */
 async function createProjectOrFolderTool(args) {
     try {
+        (0, instrumentation_1.trackMCP)("createProjectOrFolder", serverInstance.server.getClientVersion());
         return await (0, create_project_folder_1.createProjectOrFolder)(args);
     }
     catch (err) {
+        logger_1.default.error("Failed to create project/folder: %s", err);
+        (0, instrumentation_1.trackMCP)("createProjectOrFolder", serverInstance.server.getClientVersion(), err);
         return {
             content: [
                 {
@@ -32,9 +50,12 @@ async function createTestCaseTool(args) {
     // Sanitize input arguments
     const cleanedArgs = (0, create_testcase_1.sanitizeArgs)(args);
     try {
+        (0, instrumentation_1.trackMCP)("createTestCase", serverInstance.server.getClientVersion());
         return await (0, create_testcase_1.createTestCase)(cleanedArgs);
     }
     catch (err) {
+        logger_1.default.error("Failed to create test case: %s", err);
+        (0, instrumentation_1.trackMCP)("createTestCase", serverInstance.server.getClientVersion(), err);
         return {
             content: [
                 {
@@ -47,10 +68,97 @@ async function createTestCaseTool(args) {
         };
     }
 }
+/**
+ * Lists test cases in a project with optional filters (status, priority, custom fields, etc.)
+ */
+async function listTestCasesTool(args) {
+    try {
+        return await (0, list_testcases_1.listTestCases)(args);
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to list test cases: ${err instanceof Error ? err.message : "Unknown error"}. Please open an issue on GitHub if the problem persists`,
+                    isError: true,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Creates a test run in BrowserStack Test Management.
+ */
+async function createTestRunTool(args) {
+    try {
+        return await (0, create_testrun_1.createTestRun)(args);
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to create test run: ${err instanceof Error ? err.message : "Unknown error"}. Please open an issue on GitHub if the problem persists`,
+                    isError: true,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Lists test runs in a project with optional filters (date ranges, assignee, state, etc.)
+ */
+async function listTestRunsTool(args) {
+    try {
+        return await (0, list_testruns_1.listTestRuns)(args);
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to list test runs: ${err instanceof Error ? err.message : "Unknown error"}. Please open an issue on GitHub if the problem persists`,
+                    isError: true,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Updates a test run in BrowserStack Test Management.
+ * This function allows for partial updates to an existing test run.
+ * It takes the project identifier and test run ID as parameters.
+ */
+async function updateTestRunTool(args) {
+    try {
+        return await (0, update_testrun_1.updateTestRun)(args);
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to update test run: ${err instanceof Error ? err.message : "Unknown error"}. Please open an issue on GitHub if the problem persists`,
+                    isError: true,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
 /**
  * Registers both project/folder and test-case tools.
  */
 function addTestManagementTools(server) {
+    serverInstance = server;
     server.tool("createProjectOrFolder", "Create a project and/or folder in BrowserStack Test Management.", create_project_folder_1.CreateProjFoldSchema.shape, createProjectOrFolderTool);
     server.tool("createTestCase", "Use this tool to create a test case in BrowserStack Test Management.", create_testcase_1.CreateTestCaseSchema.shape, createTestCaseTool);
+    server.tool("listTestCases", "List test cases in a project with optional filters (status, priority, custom fields, etc.)", list_testcases_1.ListTestCasesSchema.shape, listTestCasesTool);
+    server.tool("createTestRun", "Create a test run in BrowserStack Test Management.", create_testrun_1.CreateTestRunSchema.shape, createTestRunTool);
+    server.tool("listTestRuns", "List test runs in a project with optional filters (date ranges, assignee, state, etc.)", list_testruns_1.ListTestRunsSchema.shape, listTestRunsTool);
+    server.tool("updateTestRun", "Update a test run in BrowserStack Test Management.", update_testrun_1.UpdateTestRunSchema.shape, updateTestRunTool);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserstack/mcp-server",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "BrowserStack's Official MCP Server",
   "main": "dist/index.js",
   "repository": {