@browserstack/mcp-server 1.2.11 → 1.2.12-beta.1

package/dist/tools/accessibility.js

@@ -101,7 +101,7 @@ async function fetchAccessibilityIssues(scanId, scanRunId, config, cursor = 0) {
 async function executeAccessibilityScan(args, context, server, config) {
     try {
         trackMCP("startAccessibilityScan", server.server.getClientVersion(), undefined, config);
-        return await runAccessibilityScan(args.name, args.pageURL, context, config, args.authConfigId);
+        return await runAccessibilityScan(args.name, args.pageURL, context, config, args.authConfigId, args.advancedRules);
     }
     catch (error) {
         return handleMCPError("startAccessibilityScan", server, config, error);
@@ -191,9 +191,9 @@ function createScanSuccessResponse(name, totalIssues, pageLength, records, scanI
     }
     return createSuccessResponse(messages);
 }
-async function runAccessibilityScan(name, pageURL, context, config, authConfigId) {
+async function runAccessibilityScan(name, pageURL, context, config, authConfigId, advancedRules) {
     const scanner = await initializeScanner(config);
-    const startResp = await scanner.startScan(name, [pageURL], authConfigId);
+    const startResp = await scanner.startScan(name, [pageURL], authConfigId, advancedRules);
     const scanId = startResp.data.id;
     const scanRunId = startResp.data.scanRunId;
     await notifyScanProgress(context, `Accessibility scan "${name}" started`, 0);
@@ -222,6 +222,10 @@ export default function addAccessibilityTools(server, config) {
             .number()
             .optional()
             .describe("Optional auth config ID for authenticated scans"),
+        advancedRules: z
+            .boolean()
+            .optional()
+            .describe("Enable advanced accessibility rules in the scan settings"),
     }, async (args, context) => {
         return await executeAccessibilityScan(args, context, server, config);
     });

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

@@ -22,17 +22,27 @@ export class AccessibilityReportFetcher {
             throw new Error(`Failed to initiate report: ${initData.error || initData.data.message}`);
         }
         const taskId = initData.data.task_id;
-        // Fetch the generated CSV link
+        // Poll for the generated CSV link (task is async, may take a few seconds)
         const reportUrl = `https://api-accessibility.browserstack.com/api/website-scanner/v1/scans/${scanId}/scan_runs/issues?task_id=${encodeURIComponent(taskId)}`;
-        // Use apiClient for the report link request as well
-        const reportResp = await apiClient.get({
-            url: reportUrl,
-            headers: basicAuthHeader ? { Authorization: basicAuthHeader } : undefined,
-        });
-        const reportData = reportResp.data;
-        if (!reportData.success) {
-            throw new Error(`Failed to fetch report: ${reportData.error}`);
+        const maxAttempts = 3;
+        const pollIntervalMs = 2000;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            const reportResp = await apiClient.get({
+                url: reportUrl,
+                headers: basicAuthHeader
+                    ? { Authorization: basicAuthHeader }
+                    : undefined,
+            });
+            const reportData = reportResp.data;
+            if (!reportData.success) {
+                throw new Error(`Failed to fetch report: ${reportData.error}`);
+            }
+            const link = reportData.data?.reportLink;
+            if (link) {
+                return link;
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
         }
-        return reportData.data.reportLink;
+        throw new Error(`Report link was not available after ${maxAttempts} attempts. The CSV generation may still be in progress.`);
     }
 }

package/dist/tools/accessiblity-utils/scanner.d.ts

@@ -19,7 +19,7 @@ export declare class AccessibilityScanner {
         username: string;
         password: string;
     }): void;
-    startScan(name: string, urlList: string[], authConfigId?: number): Promise<AccessibilityScanResponse>;
+    startScan(name: string, urlList: string[], authConfigId?: number, advancedRules?: boolean): Promise<AccessibilityScanResponse>;
     pollStatus(scanId: string, scanRunId: string): Promise<AccessibilityScanStatus>;
     waitUntilComplete(scanId: string, scanRunId: string, context: any): Promise<string>;
 }

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

@@ -8,7 +8,7 @@ export class AccessibilityScanner {
     setAuth(auth) {
         this.auth = auth;
     }
-    async startScan(name, urlList, authConfigId) {
+    async startScan(name, urlList, authConfigId, advancedRules) {
         if (!this.auth?.username || !this.auth?.password) {
             throw new Error("BrowserStack credentials are not set for AccessibilityScanner.");
         }
@@ -48,6 +48,9 @@ export class AccessibilityScanner {
             urlList: transformedUrlList,
             recurring: false,
             ...(authConfigId && { authConfigId }),
+            ...(advancedRules !== undefined && {
+                scanSettings: { advancedRules },
+            }),
         };
         let requestBody = baseRequestBody;
         if (hasLocal) {

package/package.json

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