Merge pull request #252 from ruturaj-browserstack/feat/accessbility-advance-rules

feat: add advanced rules option to accessibility scan

Author: gaurav-singh-9227

package-lock.json

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

package.json

@@ -11,7 +11,7 @@
     {
       "registryType": "npm",
       "identifier": "@browserstack/mcp-server",
-      "version": "1.2.12",
+      "version": "1.2.13",
       "transport": {
         "type": "stdio"
       },

server.json

@@ -195,7 +195,12 @@ async function fetchAccessibilityIssues(
 }
 
 async function executeAccessibilityScan(
-  args: { name: string; pageURL: string; authConfigId?: number },
+  args: {
+    name: string;
+    pageURL: string;
+    authConfigId?: number;
+    advancedRules?: boolean;
+  },
   context: ScanProgressContext,
   server: McpServer,
   config: BrowserStackConfig,
@@ -213,6 +218,7 @@ async function executeAccessibilityScan(
       context,
       config,
       args.authConfigId,
+      args.advancedRules,
     );
   } catch (error) {
     return handleMCPError("startAccessibilityScan", server, config, error);
@@ -368,10 +374,16 @@ async function runAccessibilityScan(
   context: ScanProgressContext,
   config: BrowserStackConfig,
   authConfigId?: number,
+  advancedRules?: boolean,
 ): Promise<CallToolResult> {
   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;
 
@@ -431,6 +443,10 @@ export default function addAccessibilityTools(
         .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);

src/tools/accessibility.ts

@@ -31,6 +31,7 @@ export class AccessibilityScanner {
     name: string,
     urlList: string[],
     authConfigId?: number,
+    advancedRules?: boolean,
   ): Promise<AccessibilityScanResponse> {
     if (!this.auth?.username || !this.auth?.password) {
       throw new Error(
@@ -84,6 +85,9 @@ export class AccessibilityScanner {
       urlList: transformedUrlList,
       recurring: false,
       ...(authConfigId && { authConfigId }),
+      ...(advancedRules !== undefined && {
+        scanSettings: { advancedRules },
+      }),
     };
 
     let requestBody = baseRequestBody;