@browserstack/mcp-server 1.0.14 → 1.1.0

package/dist/config.js

@@ -1,8 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = void 0;
 if (!process.env.BROWSERSTACK_ACCESS_KEY ||
     !process.env.BROWSERSTACK_USERNAME) {
     throw new Error("Unable to start MCP server. Please set the BROWSERSTACK_ACCESS_KEY and BROWSERSTACK_USERNAME environment variables. Go to https://www.browserstack.com/accounts/profile/details to access them");
 }
-export class Config {
+class Config {
     browserstackUsername;
     browserstackAccessKey;
     DEV_MODE;
@@ -12,5 +15,6 @@ export class Config {
         this.DEV_MODE = DEV_MODE;
     }
 }
+exports.Config = Config;
 const config = new Config(process.env.BROWSERSTACK_USERNAME, process.env.BROWSERSTACK_ACCESS_KEY, process.env.DEV_MODE === "true");
-export default config;
+exports.default = config;

package/dist/index.js

@@ -1,46 +1,49 @@
 #!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import packageJson from "../package.json" with { type: "json" };
-import "dotenv/config";
-import logger from "./logger.js";
-import addSDKTools from "./tools/bstack-sdk.js";
-import addAppLiveTools from "./tools/applive.js";
-import addObservabilityTools from "./tools/observability.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 { trackMCP } from "./lib/instrumentation.js";
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const package_json_1 = __importDefault(require("../package.json"));
+require("dotenv/config");
+const logger_js_1 = __importDefault(require("./logger.js"));
+const bstack_sdk_js_1 = __importDefault(require("./tools/bstack-sdk.js"));
+const applive_js_1 = __importDefault(require("./tools/applive.js"));
+const live_js_1 = __importDefault(require("./tools/live.js"));
+const accessibility_js_1 = __importDefault(require("./tools/accessibility.js"));
+const testmanagement_js_1 = __importDefault(require("./tools/testmanagement.js"));
+const appautomate_js_1 = __importDefault(require("./tools/appautomate.js"));
+const getFailureLogs_js_1 = __importDefault(require("./tools/getFailureLogs.js"));
+const automate_js_1 = __importDefault(require("./tools/automate.js"));
+const instrumentation_js_1 = require("./lib/instrumentation.js");
 function registerTools(server) {
-    addSDKTools(server);
-    addAppLiveTools(server);
-    addBrowserLiveTools(server);
-    addObservabilityTools(server);
-    addAccessibilityTools(server);
-    addTestManagementTools(server);
-    addAppAutomationTools(server);
-    addFailureLogsTools(server);
-    addAutomateTools(server);
+    (0, bstack_sdk_js_1.default)(server);
+    (0, applive_js_1.default)(server);
+    (0, live_js_1.default)(server);
+    (0, accessibility_js_1.default)(server);
+    (0, testmanagement_js_1.default)(server);
+    (0, appautomate_js_1.default)(server);
+    (0, getFailureLogs_js_1.default)(server);
+    (0, automate_js_1.default)(server);
 }
 // Create an MCP server
-const server = new McpServer({
+const server = new mcp_js_1.McpServer({
     name: "BrowserStack MCP Server",
-    version: packageJson.version,
+    version: package_json_1.default.version,
 });
 registerTools(server);
 async function main() {
-    logger.info("Launching BrowserStack MCP server, version %s", packageJson.version);
+    logger_js_1.default.info("Launching BrowserStack MCP server, version %s", package_json_1.default.version);
     // Start receiving messages on stdin and sending messages on stdout
-    const transport = new StdioServerTransport();
+    const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);
-    logger.info("MCP server started successfully");
-    trackMCP("started", server.server.getClientVersion());
+    logger_js_1.default.info("MCP server started successfully");
+    (0, instrumentation_js_1.trackMCP)("started", server.server.getClientVersion());
 }
 main().catch(console.error);
 // Ensure logs are flushed before exit
 process.on("exit", () => {
-    logger.flush();
+    logger_js_1.default.flush();
 });

package/dist/lib/api.js

@@ -1,9 +1,15 @@
-import config from "../config.js";
-export async function getLatestO11YBuildInfo(buildName, projectName) {
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLatestO11YBuildInfo = getLatestO11YBuildInfo;
+const config_js_1 = __importDefault(require("../config.js"));
+async function getLatestO11YBuildInfo(buildName, projectName) {
     const buildsUrl = `https://api-observability.browserstack.com/ext/v1/builds/latest?build_name=${encodeURIComponent(buildName)}&project_name=${encodeURIComponent(projectName)}`;
     const buildsResponse = await fetch(buildsUrl, {
         headers: {
-            Authorization: `Basic ${Buffer.from(`${config.browserstackUsername}:${config.browserstackAccessKey}`).toString("base64")}`,
+            Authorization: `Basic ${Buffer.from(`${config_js_1.default.browserstackUsername}:${config_js_1.default.browserstackAccessKey}`).toString("base64")}`,
         },
     });
     if (!buildsResponse.ok) {

package/dist/lib/constants.js

@@ -1,13 +1,16 @@
-export const SessionType = {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppAutomateLogType = exports.AutomateLogType = exports.SessionType = void 0;
+exports.SessionType = {
     Automate: "automate",
     AppAutomate: "app-automate",
 };
-export const AutomateLogType = {
+exports.AutomateLogType = {
     NetworkLogs: "networkLogs",
     SessionLogs: "sessionLogs",
     ConsoleLogs: "consoleLogs",
 };
-export const AppAutomateLogType = {
+exports.AppAutomateLogType = {
     DeviceLogs: "deviceLogs",
     AppiumLogs: "appiumLogs",
     CrashLogs: "crashLogs",

package/dist/lib/device-cache.js

@@ -1,15 +1,22 @@
-import fs from "fs";
-import os from "os";
-import path from "path";
-const CACHE_DIR = path.join(os.homedir(), ".browserstack", "combined_cache");
-const CACHE_FILE = path.join(CACHE_DIR, "data.json");
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserStackProducts = void 0;
+exports.getDevicesAndBrowsers = getDevicesAndBrowsers;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const CACHE_DIR = path_1.default.join(os_1.default.homedir(), ".browserstack", "combined_cache");
+const CACHE_FILE = path_1.default.join(CACHE_DIR, "data.json");
 const TTL_MS = 24 * 60 * 60 * 1000; // 1 day
-export var BrowserStackProducts;
+var BrowserStackProducts;
 (function (BrowserStackProducts) {
     BrowserStackProducts["LIVE"] = "live";
     BrowserStackProducts["APP_LIVE"] = "app_live";
     BrowserStackProducts["APP_AUTOMATE"] = "app_automate";
-})(BrowserStackProducts || (BrowserStackProducts = {}));
+})(BrowserStackProducts || (exports.BrowserStackProducts = BrowserStackProducts = {}));
 const URLS = {
     [BrowserStackProducts.LIVE]: "https://www.browserstack.com/list-of-browsers-and-platforms/live.json",
     [BrowserStackProducts.APP_LIVE]: "https://www.browserstack.com/list-of-browsers-and-platforms/app_live.json",
@@ -18,16 +25,16 @@ const URLS = {
 /**
  * Fetches and caches BrowserStack datasets (live + app_live + app_automate) with a shared TTL.
  */
-export async function getDevicesAndBrowsers(type) {
-    if (!fs.existsSync(CACHE_DIR)) {
-        fs.mkdirSync(CACHE_DIR, { recursive: true });
+async function getDevicesAndBrowsers(type) {
+    if (!fs_1.default.existsSync(CACHE_DIR)) {
+        fs_1.default.mkdirSync(CACHE_DIR, { recursive: true });
     }
     let cache = {};
-    if (fs.existsSync(CACHE_FILE)) {
-        const stats = fs.statSync(CACHE_FILE);
+    if (fs_1.default.existsSync(CACHE_FILE)) {
+        const stats = fs_1.default.statSync(CACHE_FILE);
         if (Date.now() - stats.mtimeMs < TTL_MS) {
             try {
-                cache = JSON.parse(fs.readFileSync(CACHE_FILE, "utf8"));
+                cache = JSON.parse(fs_1.default.readFileSync(CACHE_FILE, "utf8"));
                 if (cache[type]) {
                     return cache[type];
                 }
@@ -46,6 +53,6 @@ export async function getDevicesAndBrowsers(type) {
     cache = {
         [type]: data,
     };
-    fs.writeFileSync(CACHE_FILE, JSON.stringify(cache), "utf8");
+    fs_1.default.writeFileSync(CACHE_FILE, JSON.stringify(cache), "utf8");
     return cache[type];
 }

package/dist/lib/error.js

@@ -1,12 +1,15 @@
-import { AxiosError } from "axios";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAxiosError = formatAxiosError;
+const axios_1 = require("axios");
 /**
  * Formats an AxiosError into a CallToolResult with an appropriate message.
  * @param err - The error object to format
  * @param defaultText - The fallback error message
  */
-export function formatAxiosError(err, defaultText) {
+function formatAxiosError(err, defaultText) {
     let text = defaultText;
-    if (err instanceof AxiosError && err.response?.data) {
+    if (err instanceof axios_1.AxiosError && err.response?.data) {
         const message = err.response.data.message ||
             err.response.data.error ||
             err.message ||

package/dist/lib/fuzzy.js

@@ -1,3 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.customFuzzySearch = customFuzzySearch;
 // 1. Compute Levenshtein distance between two strings
 function levenshtein(a, b) {
     const dp = Array(a.length + 1)
@@ -36,7 +39,7 @@ function scoreItem(item, keys, queryTokens) {
     return best;
 }
 // 3. The search entrypoint
-export function customFuzzySearch(list, keys, query, limit = 5, maxDistance = 0.6) {
+function customFuzzySearch(list, keys, query, limit = 5, maxDistance = 0.6) {
     const q = query.toLowerCase().trim();
     const queryTokens = q.split(/\s+/);
     return list

package/dist/lib/inmemory-store.js

@@ -1 +1,4 @@
-export const signedUrlMap = new Map();
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signedUrlMap = void 0;
+exports.signedUrlMap = new Map();

package/dist/lib/instrumentation.js

@@ -1,10 +1,16 @@
-import logger from "../logger.js";
-import config from "../config.js";
-import packageJson from "../../package.json" with { type: "json" };
-import axios from "axios";
-export function trackMCP(toolName, clientInfo, error) {
-    if (config.DEV_MODE) {
-        logger.info("Tracking MCP is disabled in dev mode");
+"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_js_1 = __importDefault(require("../logger.js"));
+const config_js_1 = __importDefault(require("../config.js"));
+const package_json_1 = __importDefault(require("../../package.json"));
+const axios_1 = __importDefault(require("axios"));
+function trackMCP(toolName, clientInfo, error) {
+    if (config_js_1.default.DEV_MODE) {
+        logger_js_1.default.info("Tracking MCP is disabled in dev mode");
         return;
     }
     const instrumentationEndpoint = "https://api.browserstack.com/sdk/v1/event";
@@ -12,15 +18,15 @@ export function trackMCP(toolName, clientInfo, error) {
     const mcpClient = clientInfo?.name || "unknown";
     // Log client information
     if (clientInfo?.name) {
-        logger.info(`Client connected: ${clientInfo.name} (version: ${clientInfo.version})`);
+        logger_js_1.default.info(`Client connected: ${clientInfo.name} (version: ${clientInfo.version})`);
     }
     else {
-        logger.info("Client connected: unknown client");
+        logger_js_1.default.info("Client connected: unknown client");
     }
     const event = {
         event_type: "MCPInstrumentation",
         event_properties: {
-            mcp_version: packageJson.version,
+            mcp_version: package_json_1.default.version,
             tool_name: toolName,
             mcp_client: mcpClient,
             success: isSuccess,
@@ -33,11 +39,11 @@ export function trackMCP(toolName, clientInfo, error) {
         event.event_properties.error_type =
             error instanceof Error ? error.constructor.name : "Unknown";
     }
-    axios
+    axios_1.default
         .post(instrumentationEndpoint, event, {
         headers: {
             "Content-Type": "application/json",
-            Authorization: `Basic ${Buffer.from(`${config.browserstackUsername}:${config.browserstackAccessKey}`).toString("base64")}`,
+            Authorization: `Basic ${Buffer.from(`${config_js_1.default.browserstackUsername}:${config_js_1.default.browserstackAccessKey}`).toString("base64")}`,
         },
         timeout: 2000,
     })

package/dist/lib/local.js

@@ -1,39 +1,47 @@
-import logger from "../logger.js";
-import { execSync } from "child_process";
-import { Local } from "browserstack-local";
-import config from "../config.js";
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.killExistingBrowserStackLocalProcesses = killExistingBrowserStackLocalProcesses;
+exports.ensureLocalBinarySetup = ensureLocalBinarySetup;
+exports.isLocalURL = isLocalURL;
+const logger_js_1 = __importDefault(require("../logger.js"));
+const child_process_1 = require("child_process");
+const browserstack_local_1 = require("browserstack-local");
+const config_js_1 = __importDefault(require("../config.js"));
 async function isBrowserStackLocalRunning() {
     // Check if BrowserStackLocal binary is already running
     try {
         if (process.platform === "win32") {
-            const result = execSync('tasklist /FI "IMAGENAME eq BrowserStackLocal.exe"', {
+            const result = (0, child_process_1.execSync)('tasklist /FI "IMAGENAME eq BrowserStackLocal.exe"', {
                 encoding: "utf8",
             });
             if (result.includes("BrowserStackLocal.exe")) {
-                logger.info("BrowserStackLocal binary is already running");
+                logger_js_1.default.info("BrowserStackLocal binary is already running");
                 return true;
             }
         }
         else {
-            const result = execSync("pgrep -f BrowserStackLocal", {
+            const result = (0, child_process_1.execSync)("pgrep -f BrowserStackLocal", {
                 encoding: "utf8",
                 stdio: "pipe",
             }).toString();
             if (result) {
-                logger.info("BrowserStackLocal binary is already running");
+                logger_js_1.default.info("BrowserStackLocal binary is already running");
                 return true;
             }
         }
-        logger.info("BrowserStackLocal binary is not running");
+        logger_js_1.default.info("BrowserStackLocal binary is not running");
         return false;
     }
     catch (error) {
-        logger.info("Error checking BrowserStackLocal status, assuming not running ... " +
+        logger_js_1.default.info("Error checking BrowserStackLocal status, assuming not running ... " +
             error);
         return false;
     }
 }
-export async function killExistingBrowserStackLocalProcesses() {
+async function killExistingBrowserStackLocalProcesses() {
     const isRunning = await isBrowserStackLocalRunning();
     if (!isRunning) {
         return;
@@ -42,50 +50,50 @@ export async function killExistingBrowserStackLocalProcesses() {
     try {
         if (process.platform === "win32") {
             // Check if process exists on Windows
-            const checkResult = execSync('tasklist /FI "IMAGENAME eq BrowserStackLocal.exe"', { encoding: "utf8" });
+            const checkResult = (0, child_process_1.execSync)('tasklist /FI "IMAGENAME eq BrowserStackLocal.exe"', { encoding: "utf8" });
             if (checkResult.includes("BrowserStackLocal.exe")) {
-                execSync("taskkill /F /IM BrowserStackLocal.exe", { stdio: "ignore" });
-                logger.info("Successfully killed existing BrowserStackLocal processes");
+                (0, child_process_1.execSync)("taskkill /F /IM BrowserStackLocal.exe", { stdio: "ignore" });
+                logger_js_1.default.info("Successfully killed existing BrowserStackLocal processes");
             }
         }
         else {
             // Check if process exists on Unix-like systems
-            const checkResult = execSync("pgrep -f BrowserStackLocal", {
+            const checkResult = (0, child_process_1.execSync)("pgrep -f BrowserStackLocal", {
                 encoding: "utf8",
                 stdio: "pipe",
             }).toString();
             if (checkResult) {
-                execSync("pkill -f BrowserStackLocal", { stdio: "ignore" });
-                logger.info("Successfully killed existing BrowserStackLocal processes");
+                (0, child_process_1.execSync)("pkill -f BrowserStackLocal", { stdio: "ignore" });
+                logger_js_1.default.info("Successfully killed existing BrowserStackLocal processes");
             }
         }
     }
     catch (error) {
-        logger.info(`Error checking/killing BrowserStackLocal processes: ${error}`);
+        logger_js_1.default.info(`Error checking/killing BrowserStackLocal processes: ${error}`);
         // Continue execution as there may not be any processes running
     }
 }
-export async function ensureLocalBinarySetup() {
-    logger.info("Ensuring local binary setup as it is required for private URLs...");
-    const localBinary = new Local();
+async function ensureLocalBinarySetup() {
+    logger_js_1.default.info("Ensuring local binary setup as it is required for private URLs...");
+    const localBinary = new browserstack_local_1.Local();
     await killExistingBrowserStackLocalProcesses();
     return await new Promise((resolve, reject) => {
         localBinary.start({
-            key: config.browserstackAccessKey,
-            username: config.browserstackUsername,
+            key: config_js_1.default.browserstackAccessKey,
+            username: config_js_1.default.browserstackUsername,
         }, (error) => {
             if (error) {
-                logger.error(`Unable to start BrowserStack Local... please check your credentials and try again. Error: ${error}`);
+                logger_js_1.default.error(`Unable to start BrowserStack Local... please check your credentials and try again. Error: ${error}`);
                 reject(new Error(`Unable to configure local tunnel binary, please check your credentials and try again. Error: ${error}`));
             }
             else {
-                logger.info("Successfully started BrowserStack Local");
+                logger_js_1.default.info("Successfully started BrowserStack Local");
                 resolve();
             }
         });
     });
 }
-export function isLocalURL(url) {
+function isLocalURL(url) {
     try {
         const urlObj = new URL(url);
         const hostname = urlObj.hostname.toLowerCase();
@@ -95,7 +103,7 @@ export function isLocalURL(url) {
             hostname.endsWith(".localhost"));
     }
     catch (error) {
-        logger.error(`Error checking if URL is local: ${error}`);
+        logger_js_1.default.error(`Error checking if URL is local: ${error}`);
         return false;
     }
 }

package/dist/lib/utils.js

@@ -1,11 +1,20 @@
-import sharp from "sharp";
-export function sanitizeUrlParam(param) {
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeUrlParam = sanitizeUrlParam;
+exports.maybeCompressBase64 = maybeCompressBase64;
+exports.assertOkResponse = assertOkResponse;
+exports.filterLinesByKeywords = filterLinesByKeywords;
+const sharp_1 = __importDefault(require("sharp"));
+function sanitizeUrlParam(param) {
     // Remove any characters that could be used for command injection
     return param.replace(/[;&|`$(){}[\]<>]/g, "");
 }
 const ONE_MB = 1048576;
 //Compresses a base64 image intelligently to keep it under 1 MB if needed.
-export async function maybeCompressBase64(base64) {
+async function maybeCompressBase64(base64) {
     const buffer = Buffer.from(base64, "base64");
     if (buffer.length <= ONE_MB) {
         return base64;
@@ -13,10 +22,10 @@ export async function maybeCompressBase64(base64) {
     const sizeRatio = 1048576 / buffer.length;
     const estimatedQuality = Math.floor(sizeRatio * 100);
     const quality = Math.min(95, Math.max(30, estimatedQuality));
-    const compressedBuffer = await sharp(buffer).png({ quality }).toBuffer();
+    const compressedBuffer = await (0, sharp_1.default)(buffer).png({ quality }).toBuffer();
     return compressedBuffer.toString("base64");
 }
-export async function assertOkResponse(response, action) {
+async function assertOkResponse(response, action) {
     if (!response.ok) {
         if (response.status === 404) {
             throw new Error(`Invalid session ID for ${action}`);
@@ -24,7 +33,7 @@ export async function assertOkResponse(response, action) {
         throw new Error(`Failed to fetch logs for ${action}: ${response.statusText}`);
     }
 }
-export function filterLinesByKeywords(logText, keywords) {
+function filterLinesByKeywords(logText, keywords) {
     return logText
         .split(/\r?\n/)
         .map((line) => line.trim())

package/dist/logger.js

@@ -1,7 +1,9 @@
-import { pino } from "pino";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const pino_1 = require("pino");
 let logger;
 if (process.env.NODE_ENV === "development") {
-    logger = pino({
+    logger = (0, pino_1.pino)({
         level: "debug",
         transport: {
             targets: [
@@ -22,7 +24,7 @@ if (process.env.NODE_ENV === "development") {
 }
 else {
     // NULL logger
-    logger = pino({
+    logger = (0, pino_1.pino)({
         level: "info",
         transport: {
             target: "pino/file",
@@ -32,4 +34,4 @@ else {
         },
     });
 }
-export default logger;
+exports.default = logger;

package/dist/tools/accessibility.js

@@ -1,33 +1,69 @@
-import { z } from "zod";
-import { startAccessibilityScan, } from "./accessiblity-utils/accessibility.js";
-import { trackMCP } from "../lib/instrumentation.js";
-async function runAccessibilityScan(name, pageURL) {
-    const response = await 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");
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = addAccessibilityTools;
+const zod_1 = require("zod");
+const scanner_js_1 = require("./accessiblity-utils/scanner.js");
+const report_fetcher_js_1 = require("./accessiblity-utils/report-fetcher.js");
+const instrumentation_js_1 = require("../lib/instrumentation.js");
+const report_parser_js_1 = require("./accessiblity-utils/report-parser.js");
+const scanner = new scanner_js_1.AccessibilityScanner();
+const reportFetcher = new report_fetcher_js_1.AccessibilityReportFetcher();
+async function runAccessibilityScan(name, pageURL, context) {
+    // Start scan
+    const startResp = await scanner.startScan(name, [pageURL]);
+    const scanId = startResp.data.id;
+    const scanRunId = startResp.data.scanRunId;
+    // Notify scan start
+    await context.sendNotification({
+        method: "notifications/progress",
+        params: {
+            progressToken: context._meta?.progressToken ?? "NOT_FOUND",
+            message: `Accessibility scan "${name}" started`,
+            progress: 0,
+            total: 100,
+        },
+    });
+    // Wait until scan completes
+    const status = await scanner.waitUntilComplete(scanId, scanRunId, context);
+    if (status !== "completed") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ Accessibility scan "${name}" failed with status: ${status} , check the BrowserStack dashboard for more details [https://scanner.browserstack.com/site-scanner/scan-details/${name}].`,
+                    isError: true,
+                },
+            ],
+            isError: true,
+        };
     }
+    // Fetch CSV report link
+    const reportLink = await reportFetcher.getReportLink(scanId, scanRunId);
+    const { records } = await (0, report_parser_js_1.parseAccessibilityReportFromCSV)(reportLink);
     return {
         content: [
             {
                 type: "text",
-                text: `Successfully queued accessibility scan, you will get a report via email within 5 minutes.`,
+                text: `✅ Accessibility scan "${name}" completed. check the BrowserStack dashboard for more details [https://scanner.browserstack.com/site-scanner/scan-details/${name}].`,
+            },
+            {
+                type: "text",
+                text: `Scan results: ${JSON.stringify(records, null, 2)}`,
             },
         ],
     };
 }
-export default function addAccessibilityTools(server) {
-    server.tool("startAccessibilityScan", "Use this tool to start an accessibility scan for a list of URLs on BrowserStack.", {
-        name: z.string().describe("Name of the accessibility scan"),
-        pageURL: z.string().describe("The URL to scan for accessibility issues"),
-    }, async (args) => {
+function addAccessibilityTools(server) {
+    server.tool("startAccessibilityScan", "Start an accessibility scan via BrowserStack and retrieve a local CSV report path.", {
+        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, context) => {
         try {
-            trackMCP("startAccessibilityScan", server.server.getClientVersion());
-            return await runAccessibilityScan(args.name, args.pageURL);
+            (0, instrumentation_js_1.trackMCP)("startAccessibilityScan", server.server.getClientVersion());
+            return await runAccessibilityScan(args.name, args.pageURL, context);
         }
         catch (error) {
-            trackMCP("startAccessibilityScan", server.server.getClientVersion(), error);
+            (0, instrumentation_js_1.trackMCP)("startAccessibilityScan", server.server.getClientVersion(), error);
             return {
                 content: [
                     {

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

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessibilityReportFetcher = void 0;
+const axios_1 = __importDefault(require("axios"));
+const config_js_1 = __importDefault(require("../../config.js"));
+class AccessibilityReportFetcher {
+    auth = {
+        username: config_js_1.default.browserstackUsername,
+        password: config_js_1.default.browserstackAccessKey,
+    };
+    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 initResp = await axios_1.default.get(initUrl, {
+            auth: this.auth,
+        });
+        if (!initResp.data.success) {
+            throw new Error(`Failed to initiate report: ${initResp.data.error || initResp.data.data.message}`);
+        }
+        const taskId = initResp.data.data.task_id;
+        // Fetch the generated CSV link
+        const reportUrl = `https://api-accessibility.browserstack.com/api/website-scanner/v1/scans/${scanId}/scan_runs/issues?task_id=${encodeURIComponent(taskId)}`;
+        const reportResp = await axios_1.default.get(reportUrl, {
+            auth: this.auth,
+        });
+        if (!reportResp.data.success) {
+            throw new Error(`Failed to fetch report: ${reportResp.data.error}`);
+        }
+        return reportResp.data.data.reportLink;
+    }
+}
+exports.AccessibilityReportFetcher = AccessibilityReportFetcher;