@browserstack/mcp-server 1.2.2 → 1.2.3-beta.1

package/README.md

@@ -35,6 +35,10 @@ Manage, execute, debug tests, and even fix code using plain English prompts.
 #### Reduced context switching:
 Stay in flow—keep all project context in one place and trigger actions directly from your IDE or LLM.
 
+## ⚡️ One Click MCP Setup
+
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](http://mcp.browserstack.com/one-click-setup?client=vscode)   [![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Server-24bfa5?style=flat-square&color=000000&logo=visualstudiocode&logoColor=white)](http://mcp.browserstack.com/one-click-setup?client=cursor)
+
 ## 💡 Usage Examples
 
 ### 📱 Manual App Testing
@@ -138,8 +142,13 @@ Generate test cases from PRDs, convert manual tests to low-code automation, and
 
 ## 🛠️ Installation
 
+### **One Click MCP Setup**
+
 [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](http://mcp.browserstack.com/one-click-setup?client=vscode)   [![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Server-24bfa5?style=flat-square&color=000000&logo=visualstudiocode&logoColor=white)](http://mcp.browserstack.com/one-click-setup?client=cursor)
 
+
+### **Alternate ways to Setup MCP server**
+
 1. **Create a BrowserStack Account**
 
    - Sign up for [BrowserStack](https://www.browserstack.com/users/sign_up) if you don't have an account already.
@@ -150,9 +159,21 @@ Generate test cases from PRDs, convert manual tests to low-code automation, and
    - 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).
 
 2. Ensure you are using Node version >= `18.0`. Check your node version using `node --version`. Recommended version: `v22.15.0` (LTS)
+
 3. **Install the MCP Server**
 
    - VSCode (Copilot - Agent Mode): `.vscode/mcp.json`:
+    
+      - Locate or Create the Configuration File: 
+        In the root directory of your project, look for a folder named .vscode. This folder is usually hidden so you will need to find it as mentioned in the expand.
+    
+      - If this folder doesn't exist, create it.
+    
+      - Inside the .vscode folder, create a new file named mcp.json
+      
+      - Add the Configuration: Open the mcp.json file and then add the  following JSON content. 
+      
+      - Replace the username and <access_key> with your BrowserStack   credentials.
 
    ```json
    {
@@ -172,6 +193,30 @@ Generate test cases from PRDs, convert manual tests to low-code automation, and
    - In VSCode, make sure to click on `Start` button in the MCP Server to start the server.
      ![Start MCP Server](assets/vscode_install.png)
 
+   
+   #### ** Alternate way to setup MCP on VSCode Copilot
+
+   1.Click on the gear icon to Select Tools
+    <div align="center">
+      <img src="assets/select_tools.png" alt="Select Tools" height="100"> 
+    </div>
+   2. A tool menu would appear at the top-centre, scroll down on the     menu at the top and then Click on Add MCP Server
+    <div align="center">
+      <img src="assets/add_mcp_server.png" alt="Add MCP Server" height="100"> 
+    </div>
+   3. Select NPM package option (Install fron an NPM package) - 3rd in the list
+    <div align="center">
+      <img src="assets/select_npm_package.png" alt="Select NPM Package" height="100"> 
+    </div>
+   4. Enter NPM Package Name (@browserstack/mcp-server)
+    <div align="center">
+      <img src="assets/enter_npm_package.png" alt="Enter NPM Package" height="100"> 
+    </div>
+   5. Enter browserstack user name and access key
+   
+   
+   
+   
    * For Cursor: `.cursor/mcp.json`:
 
    ```json
@@ -233,6 +278,186 @@ To install BrowserStack Test Platform Server for Claude Desktop automatically vi
 npx -y @smithery/cli install @browserstack/mcp-server --client claude
 ```
 
+
+### 💡 List of BrowserStack MCP Tools
+
+As of now we support 20 tools.
+
+
+---
+
+## 🧾 Test Management
+
+ 1. `createProjectOrFolder` — Create a Test Management project and/or folders to organize test cases. Returns with Folder ID, Project ID and Test Management Link to access the TM Project Dashboard.
+  **Prompt example**
+
+  ```text
+  Create a new Test Management project named 'Shopping App' with two folders - Login and Checkout
+  ```
+
+
+ 2. `createTestCase` — Add a manual test case under a specific project/folder (uses project identifier like PR-xxxxx and a folder ID).
+  **Prompt example**
+
+  ```text
+  Add a test case named 'Invalid Login Scenario' to the Login folder in the 'Shopping App' project with PR-53617, Folder ID: 117869
+  ```
+
+ 3. `listTestCases` — List test cases for a project (supports filters like priority, status, tags).
+  **Prompt example**
+
+  ```text
+  List all high-priority test cases in the 'Shopping App' project with project_identifier: PR-59457
+  ```
+
+ 4. `createTestRun` — Create a test run (suite) for selected test cases in a project.
+  **Prompt example**
+
+  ```text
+  Create a test run for the Login folder in the 'Shopping App' project and name it 'Release v1.0 Login Flow'
+  ```
+
+ 5. `listTestRuns` — List test runs for a project (filter by dates, assignee, state).
+  **Prompt example**
+
+  ```text
+  List all test runs from the 'Shopping App' project that were executed last week and are currently marked in-progress
+  ```
+
+ 6. `updateTestRun` — Partially update a test run (status, tags, notes, associated test cases).
+  **Prompt example**
+
+  ```text
+  Update test run ID 1043 in the 'Shopping App' project and mark it as complete with the note 'Regression cycle done'
+  ```
+
+ 7. `addTestResult` — Add a manual execution result (passed/failed/blocked/skipped) for a test case within a run.
+  **Prompt example**
+
+  ```text
+  Mark the test case 'Invalid Login Scenario' as passed in test run ID 1043 of the 'Shopping App' project
+  ```
+
+ 8. `createTestCasesFromFile` — Bulk-create test cases from an uploaded file (e.g., PDF).
+  **Prompt example**
+
+  ```text
+  Upload test cases from '/Users/xyz/testcases.pdf' to the 'Shopping App' project in Test Management
+  ```
+
+---
+
+## ⚙️ BrowserStack SDK Setup / Automate Test
+
+ 9. `setupBrowserStackAutomateTests` — Integrate BrowserStack SDK and run web tests on BrowserStack (optionally enable Percy).
+  **Prompt example**
+
+  ```text
+  Run my Selenium-JUnit5 tests written in Java on Chrome and Firefox. Enable Percy for visual testing.
+  ```
+
+ 10. `fetchAutomationScreenshots` — Fetch screenshots captured during a given Automate/App Automate session.
+  **Prompt example**
+
+  ```text
+  Get screenshots from Automate session ID abc123xyz for my desktop test run
+  ```
+
+---
+
+## 🔍 Observability
+
+ 11. `getFailureLogs` — Retrieve error logs for Automate/App Automate sessions (optionally by Build ID for App Automate).
+  **Prompt example**
+
+  ```text
+  Get the error logs from the session ID: 21a864032a7459f1e7634222249b316759d6827f, Build ID: dt7ung4wmjittzff8kksrjadjax9gzvbscoyf9qn of App Automate test session
+  ```
+
+---
+
+## 📱 App Live
+
+ 12. `runAppLiveSession` — Start a manual app testing session on a real device in the cloud.
+  **Prompt example**
+
+  ```text
+  Open my app on iPhone 15 Pro Max with iOS 17. App path is /Users/xyz/app.ipa
+  ```
+
+---
+
+## 💻 Live
+
+ 13. `runBrowserLiveSession` — Start a Live session for website testing on desktop or mobile browsers.
+  **Prompt example**
+
+  ```text
+  Open www.google.com on the latest version of Microsoft Edge on Windows 11
+  ```
+
+---
+
+## 📲 App Automate
+
+ 14. `takeAppScreenshot` — Launch the app on a specified device and captures a quick verification screenshot. This tool is just to verify whether your app has been launched.
+  **Prompt example**
+
+  ```text
+  Take a screenshot of my app on Google Pixel 6 with Android 14 while testing on App Automate. App file path: /Users/xyz/app-debug.apk
+  ```
+
+ 15. `runAppTestsOnBrowserStack` — Run automated mobile tests (Espresso/XCUITest, etc.) on real devices.
+  **Prompt example**
+
+  ```text
+  Run Espresso tests from /tests/checkout.zip on Galaxy S21 and Pixel 6 with Android 14. App path is /apps/beta-release.apk under project 'Checkout Flow'
+  ```
+
+---
+
+## ♿ Accessibility
+
+ 16. `accessibilityExpert` — Ask A11y Expert (WCAG 2.0/2.1/2.2, mobile/web usability, best practices).
+  **Prompt example**
+
+  ```text
+  What WCAG guidelines apply to form field error messages on mobile web?
+  ```
+
+ 17. `startAccessibilityScan` — Start a web accessibility scan and return the result link.
+  **Prompt example**
+
+  ```text
+  Run accessibility scan for "www.example.com"
+  ```
+
+---
+
+## 🤖 BrowserStack AI Agents
+
+ 18. `fetchSelfHealedSelectors` — Retrieve AI self-healed selectors to fix flaky tests due to DOM changes.
+  **Prompt example**
+
+  ```text
+  Fetch and fix flaky test selectors in Automate session ID session_9482 using MCP
+  ```
+
+ 19. `createLCASteps` — Generate Low Code Automation steps from a manual test case in Test Management.
+  **Prompt example**
+
+  ```text
+  Convert the manual test case 'Add to Cart' in the 'Shopping App' project into LCA steps
+  ```
+
+ 20. `uploadProductRequirementFile` — Upload a PRD/screenshot/PDF and get a file mapping ID (used with `createTestCasesFromFile`).
+  **Prompt example**
+
+  ```text
+  Upload PRD from /Users/xyz/Desktop/login-flow.pdf and use BrowserStack AI to generate test cases
+  ```
+
+
 ## 🤝 Recommended MCP Clients
 
 - We recommend using **Github Copilot or Cursor** for automated testing + debugging use cases.

package/dist/lib/instrumentation.js

@@ -4,6 +4,7 @@ import { createRequire } from "module";
 const require = createRequire(import.meta.url);
 const packageJson = require("../../package.json");
 import axios from "axios";
+import globalConfig from "../config.js";
 export function trackMCP(toolName, clientInfo, error, config) {
     const instrumentationEndpoint = "https://api.browserstack.com/sdk/v1/event";
     const isSuccess = !error;
@@ -22,6 +23,7 @@ export function trackMCP(toolName, clientInfo, error, config) {
             tool_name: toolName,
             mcp_client: mcpClient,
             success: isSuccess,
+            is_remote: globalConfig.REMOTE_MCP,
         },
     };
     // Add error details if applicable

package/dist/server-factory.js

@@ -8,7 +8,7 @@ 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 addFailureLogsTools from "./tools/get-failure-logs.js";
 import addAutomateTools from "./tools/automate.js";
 import addSelfHealTools from "./tools/selfheal.js";
 import addAppLiveTools from "./tools/applive.js";

package/dist/tools/accessibility.js

@@ -1,66 +1,211 @@
 import { z } from "zod";
 import { AccessibilityScanner } from "./accessiblity-utils/scanner.js";
 import { AccessibilityReportFetcher } from "./accessiblity-utils/report-fetcher.js";
+import { AccessibilityAuthConfig } from "./accessiblity-utils/auth-config.js";
 import { trackMCP } from "../lib/instrumentation.js";
 import { parseAccessibilityReportFromCSV } from "./accessiblity-utils/report-parser.js";
 import { queryAccessibilityRAG } from "./accessiblity-utils/accessibility-rag.js";
 import { getBrowserStackAuth } from "../lib/get-auth.js";
-async function runAccessibilityScan(name, pageURL, context, config) {
-    // Create scanner and set auth on the go
-    const scanner = new AccessibilityScanner();
+import logger from "../logger.js";
+function setupAuth(config) {
     const authString = getBrowserStackAuth(config);
     const [username, password] = authString.split(":");
-    scanner.setAuth({ username, password });
-    // Start scan
-    const startResp = await scanner.startScan(name, [pageURL]);
-    const scanId = startResp.data.id;
-    const scanRunId = startResp.data.scanRunId;
-    // Notify scan start
+    return { username, password };
+}
+function createErrorResponse(message, isError = true) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: message,
+                isError,
+            },
+        ],
+        isError,
+    };
+}
+function createSuccessResponse(messages) {
+    return {
+        content: messages.map((text) => ({
+            type: "text",
+            text,
+        })),
+    };
+}
+function handleMCPError(toolName, server, config, error) {
+    trackMCP(toolName, server.server.getClientVersion(), error, config);
+    const errorMessage = error instanceof Error ? error.message : "Unknown error";
+    return createErrorResponse(`Failed to ${toolName.replace(/([A-Z])/g, " $1").toLowerCase()}: ${errorMessage}. Please open an issue on GitHub if the problem persists`);
+}
+async function notifyScanProgress(context, message, progress = 0) {
     await context.sendNotification({
         method: "notifications/progress",
         params: {
-            progressToken: context._meta?.progressToken ?? "NOT_FOUND",
-            message: `Accessibility scan "${name}" started`,
-            progress: 0,
+            progressToken: context._meta?.progressToken?.toString() ?? "NOT_FOUND",
+            message,
+            progress,
             total: 100,
         },
     });
-    // Wait until scan completes
+}
+async function initializeScanner(config) {
+    const scanner = new AccessibilityScanner();
+    const auth = setupAuth(config);
+    scanner.setAuth(auth);
+    return scanner;
+}
+async function initializeReportFetcher(config) {
+    const reportFetcher = new AccessibilityReportFetcher();
+    const auth = setupAuth(config);
+    reportFetcher.setAuth(auth);
+    return reportFetcher;
+}
+async function executeAccessibilityRAG(args, server, config) {
+    try {
+        trackMCP("accessibilityExpert", server.server.getClientVersion(), undefined, config);
+        return await queryAccessibilityRAG(args.query, config);
+    }
+    catch (error) {
+        return handleMCPError("accessibilityExpert", server, config, error);
+    }
+}
+async function executeFetchAccessibilityIssues(args, server, config) {
+    try {
+        trackMCP("fetchAccessibilityIssues", server.server.getClientVersion(), undefined, config);
+        return await fetchAccessibilityIssues(args.scanId, args.scanRunId, config, args.cursor);
+    }
+    catch (error) {
+        return handleMCPError("fetchAccessibilityIssues", server, config, error);
+    }
+}
+async function fetchAccessibilityIssues(scanId, scanRunId, config, cursor = 0) {
+    const reportFetcher = await initializeReportFetcher(config);
+    const reportLink = await reportFetcher.getReportLink(scanId, scanRunId);
+    const { records, page_length, total_issues, next_page } = await parseAccessibilityReportFromCSV(reportLink, { nextPage: cursor });
+    const currentlyShown = cursor === 0
+        ? page_length
+        : Math.floor(cursor / JSON.stringify(records[0] || {}).length) +
+            page_length;
+    const remainingIssues = total_issues - currentlyShown;
+    const messages = [
+        `Retrieved ${page_length} accessibility issues (Total: ${total_issues})`,
+        `Issues: ${JSON.stringify(records, null, 2)}`,
+    ];
+    if (next_page !== null) {
+        messages.push(`${remainingIssues} more issues available. Use fetchAccessibilityIssues with cursor: ${next_page} to get the next batch.`);
+    }
+    else {
+        messages.push(`✅ All issues retrieved.`);
+    }
+    return createSuccessResponse(messages);
+}
+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);
+    }
+    catch (error) {
+        return handleMCPError("startAccessibilityScan", server, config, error);
+    }
+}
+function validateFormAuthArgs(args) {
+    return (args.type === "form" &&
+        "usernameSelector" in args &&
+        "passwordSelector" in args &&
+        "submitSelector" in args &&
+        !!args.usernameSelector &&
+        !!args.passwordSelector &&
+        !!args.submitSelector);
+}
+async function createAuthConfig(args, config) {
+    const authConfig = new AccessibilityAuthConfig();
+    const auth = setupAuth(config);
+    authConfig.setAuth(auth);
+    if (args.type === "form") {
+        if (!validateFormAuthArgs(args)) {
+            throw new Error("Form authentication requires usernameSelector, passwordSelector, and submitSelector");
+        }
+        return await authConfig.createFormAuthConfig(args.name, {
+            username: args.username,
+            usernameSelector: args.usernameSelector,
+            password: args.password,
+            passwordSelector: args.passwordSelector,
+            submitSelector: args.submitSelector,
+            url: args.url,
+        });
+    }
+    else {
+        return await authConfig.createBasicAuthConfig(args.name, {
+            url: args.url,
+            username: args.username,
+            password: args.password,
+        });
+    }
+}
+async function executeCreateAuthConfig(args, server, config) {
+    try {
+        trackMCP("createAccessibilityAuthConfig", server.server.getClientVersion(), undefined, config);
+        logger.info(`Creating auth config: ${JSON.stringify(args)}`);
+        const result = await createAuthConfig(args, config);
+        return createSuccessResponse([
+            `✅ Auth config "${args.name}" created successfully with ID: ${result.data?.id}`,
+            `Auth config details: ${JSON.stringify(result.data, null, 2)}`,
+        ]);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            error.message.includes("Form authentication requires")) {
+            return createErrorResponse(error.message);
+        }
+        return handleMCPError("createAccessibilityAuthConfig", server, config, error);
+    }
+}
+async function executeGetAuthConfig(args, server, config) {
+    try {
+        trackMCP("getAccessibilityAuthConfig", server.server.getClientVersion(), undefined, config);
+        const authConfig = new AccessibilityAuthConfig();
+        const auth = setupAuth(config);
+        authConfig.setAuth(auth);
+        const result = await authConfig.getAuthConfig(args.configId);
+        return createSuccessResponse([
+            `✅ Auth config retrieved successfully`,
+            `Auth config details: ${JSON.stringify(result.data, null, 2)}`,
+        ]);
+    }
+    catch (error) {
+        return handleMCPError("getAccessibilityAuthConfig", server, config, error);
+    }
+}
+function createScanFailureResponse(name, status) {
+    return createErrorResponse(`❌ Accessibility scan "${name}" failed with status: ${status} , check the BrowserStack dashboard for more details [https://scanner.browserstack.com/site-scanner/scan-details/${name}].`);
+}
+function createScanSuccessResponse(name, totalIssues, pageLength, records, scanId, scanRunId, reportUrl, cursor) {
+    const messages = [
+        `Accessibility scan "${name}" completed. check the BrowserStack dashboard for more details [https://scanner.browserstack.com/site-scanner/scan-details/${name}].`,
+        `Scan ID: ${scanId} and Scan Run ID: ${scanRunId}`,
+        `You can also download the full report from the following link: ${reportUrl}`,
+        `We found ${totalIssues} issues. Below are the details of the ${pageLength} most critical issues.`,
+        `Scan results: ${JSON.stringify(records, null, 2)}`,
+    ];
+    if (cursor !== null) {
+        messages.push(`More issues available. Use fetchAccessibilityIssues tool with scanId: "${scanId}", scanRunId: "${scanRunId}", and cursor: ${cursor} to get the next batch.`);
+    }
+    return createSuccessResponse(messages);
+}
+async function runAccessibilityScan(name, pageURL, context, config, authConfigId) {
+    const scanner = await initializeScanner(config);
+    const startResp = await scanner.startScan(name, [pageURL], authConfigId);
+    const scanId = startResp.data.id;
+    const scanRunId = startResp.data.scanRunId;
+    await notifyScanProgress(context, `Accessibility scan "${name}" started`, 0);
     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,
-        };
-    }
-    // Create report fetcher and set auth on the go
-    const reportFetcher = new AccessibilityReportFetcher();
-    reportFetcher.setAuth({ username, password });
-    // Fetch CSV report link
+        return createScanFailureResponse(name, status);
+    }
+    const reportFetcher = await initializeReportFetcher(config);
     const reportLink = await reportFetcher.getReportLink(scanId, scanRunId);
-    const { records, page_length, total_issues } = await parseAccessibilityReportFromCSV(reportLink);
-    return {
-        content: [
-            {
-                type: "text",
-                text: `✅ Accessibility scan "${name}" completed. check the BrowserStack dashboard for more details [https://scanner.browserstack.com/site-scanner/scan-details/${name}].`,
-            },
-            {
-                type: "text",
-                text: `We found ${total_issues} issues. Below are the details of the ${page_length} most critical issues.`,
-            },
-            {
-                type: "text",
-                text: `Scan results: ${JSON.stringify(records, null, 2)}`,
-            },
-        ],
-    };
+    const { records, page_length, total_issues, next_page } = await parseAccessibilityReportFromCSV(reportLink);
+    return createScanSuccessResponse(name, total_issues, page_length, records, scanId, scanRunId, reportLink, next_page);
 }
 export default function addAccessibilityTools(server, config) {
     const tools = {};
@@ -69,44 +214,59 @@ export default function addAccessibilityTools(server, config) {
             .string()
             .describe("Any accessibility, a11y, WCAG, or web accessibility question"),
     }, async (args) => {
-        try {
-            trackMCP("accessibilityExpert", server.server.getClientVersion(), undefined, config);
-            return await queryAccessibilityRAG(args.query, config);
-        }
-        catch (error) {
-            trackMCP("accessibilityExpert", server.server.getClientVersion(), error, config);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Failed to query accessibility RAG: ${error instanceof Error ? error.message : "Unknown error"}. Please open an issue on GitHub if the problem persists`,
-                    },
-                ],
-                isError: true,
-            };
-        }
+        return await executeAccessibilityRAG(args, server, config);
     });
     tools.startAccessibilityScan = server.tool("startAccessibilityScan", "Start an accessibility scan via BrowserStack and retrieve a local CSV report path.", {
         name: z.string().describe("Name of the accessibility scan"),
         pageURL: z.string().describe("The URL to scan for accessibility issues"),
+        authConfigId: z
+            .number()
+            .optional()
+            .describe("Optional auth config ID for authenticated scans"),
     }, async (args, context) => {
-        try {
-            trackMCP("startAccessibilityScan", server.server.getClientVersion(), undefined, config);
-            return await runAccessibilityScan(args.name, args.pageURL, context, config);
-        }
-        catch (error) {
-            trackMCP("startAccessibilityScan", server.server.getClientVersion(), error, config);
-            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,
-            };
-        }
+        return await executeAccessibilityScan(args, context, server, config);
+    });
+    tools.createAccessibilityAuthConfig = server.tool("createAccessibilityAuthConfig", "Create an authentication configuration for accessibility scans. Supports both form-based and basic authentication.", {
+        name: z.string().describe("Name for the auth configuration"),
+        type: z
+            .enum(["form", "basic"])
+            .describe("Authentication type: 'form' for form-based auth, 'basic' for HTTP basic auth"),
+        url: z.string().describe("URL of the authentication page"),
+        username: z.string().describe("Username for authentication"),
+        password: z.string().describe("Password for authentication"),
+        usernameSelector: z
+            .string()
+            .optional()
+            .describe("CSS selector for username field (required for form auth)"),
+        passwordSelector: z
+            .string()
+            .optional()
+            .describe("CSS selector for password field (required for form auth)"),
+        submitSelector: z
+            .string()
+            .optional()
+            .describe("CSS selector for submit button (required for form auth)"),
+    }, async (args) => {
+        return await executeCreateAuthConfig(args, server, config);
+    });
+    tools.getAccessibilityAuthConfig = server.tool("getAccessibilityAuthConfig", "Retrieve an existing authentication configuration by ID.", {
+        configId: z.number().describe("ID of the auth configuration to retrieve"),
+    }, async (args) => {
+        return await executeGetAuthConfig(args, server, config);
+    });
+    tools.fetchAccessibilityIssues = server.tool("fetchAccessibilityIssues", "Fetch accessibility issues from a completed scan with pagination support. Use cursor parameter to get subsequent pages of results.", {
+        scanId: z
+            .string()
+            .describe("The scan ID from a completed accessibility scan"),
+        scanRunId: z
+            .string()
+            .describe("The scan run ID from a completed accessibility scan"),
+        cursor: z
+            .number()
+            .optional()
+            .describe("Character offset for pagination (default: 0)"),
+    }, async (args) => {
+        return await executeFetchAccessibilityIssues(args, server, config);
     });
     return tools;
 }

package/dist/tools/accessiblity-utils/auth-config.d.ts

@@ -0,0 +1,39 @@
+export interface AuthConfigResponse {
+    success: boolean;
+    data?: {
+        id: number;
+        name: string;
+        type: string;
+        username?: string;
+        password?: string;
+        url?: string;
+        usernameSelector?: string;
+        passwordSelector?: string;
+        submitSelector?: string;
+    };
+    errors?: string[];
+}
+export interface FormAuthData {
+    username: string;
+    usernameSelector: string;
+    password: string;
+    passwordSelector: string;
+    submitSelector: string;
+    url: string;
+}
+export interface BasicAuthData {
+    url: string;
+    username: string;
+    password: string;
+}
+export declare class AccessibilityAuthConfig {
+    private auth;
+    setAuth(auth: {
+        username: string;
+        password: string;
+    }): void;
+    private transformLocalUrl;
+    createFormAuthConfig(name: string, authData: FormAuthData): Promise<AuthConfigResponse>;
+    createBasicAuthConfig(name: string, authData: BasicAuthData): Promise<AuthConfigResponse>;
+    getAuthConfig(configId: number): Promise<AuthConfigResponse>;
+}