@browserstack/mcp-server 1.2.27 → 1.2.29-beta.1

package/README.md

@@ -292,7 +292,9 @@ Select the “Installed” tab. Click the “Configure MCP Servers” button at
 
 ### 💡 List of BrowserStack MCP Tools
 
-As of now we support 20 tools.
+As of now we support 44 tools.
+
+> **Remote MCP note:** Tools marked _(not available in Remote MCP)_ rely on local file/process state and are disabled in the multi-tenant [Remote MCP Server](#-remote-mcp-server). They are available in the local (npx) setup.
 
 ---
 
@@ -313,60 +315,109 @@ As of now we support 20 tools.
   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).
+ 3. `updateTestCase` — Update an existing test case. Any subset of fields may be changed (name, priority, status, steps, tags, etc.); only supplied fields are modified.
+  **Prompt example**
+
+  ```text
+  Update test case TC-482 in the 'Shopping App' project and set its priority to high
+  ```
+
+ 4. `listTestCases` — List test cases for a project, optionally scoped to a folder (supports filters like case_type, priority, and pagination).
   **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.
+ 5. `listFolders` — List folders in a Test Management project (returns each folder's id, name, case counts, and sub-folder counts). Pass a parent_id to list sub-folders.
+  **Prompt example**
+
+  ```text
+  List all folders in the 'Shopping App' project with project_identifier: PR-59457
+  ```
+
+ 6. `listTestCaseTemplates` — List test-case templates with their numeric template_id, for use with `createTestCase` to apply a custom template.
+  **Prompt example**
+
+  ```text
+  List the available test case templates in the 'Shopping App' project
+  ```
+
+ 7. `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).
+ 8. `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` — Update a test run's name/state and/or add test cases to it.
+ 9. `updateTestRun` — Update a test run's name/state and/or add test cases to it.
   **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.
+ 10. `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).
+ 11. `createTestCasesFromFile` — Generate test cases in bulk from an uploaded file using the Test Case Generator AI Agent. _(not available in Remote MCP)_
   **Prompt example**
 
   ```text
   Upload test cases from '/Users/xyz/testcases.pdf' to the 'Shopping App' project in Test Management
   ```
 
+ 12. `listTestPlans` — List test plans (TP-*) in a project, with name, status, dates, and active/closed run counts. Supports pagination.
+  **Prompt example**
+
+  ```text
+  List all test plans in the 'Shopping App' project with project_identifier: PR-59457
+  ```
+
+ 13. `getTestPlan` — Fetch a test plan by identifier (TP-*) with its metadata, linked test runs, total test-case count, and status summary.
+  **Prompt example**
+
+  ```text
+  Get the details of test plan TP-120 in the 'Shopping App' project
+  ```
+
+ 14. `listSubTestPlans` — List sub-test-plans (STP-*) under a parent test plan (TP-*). Supports pagination.
+  **Prompt example**
+
+  ```text
+  List sub-test-plans under test plan TP-120 in the 'Shopping App' project
+  ```
+
+ 15. `getSubTestPlan` — Fetch a sub-test-plan (STP-*) under a parent plan, with its metadata and linked test runs.
+  **Prompt example**
+
+  ```text
+  Get sub-test-plan STP-45 under test plan TP-120 in the 'Shopping App' project
+  ```
+
 ---
 
 ## ⚙️ BrowserStack SDK Setup / Automate Test
 
- 9. `setupBrowserStackAutomateTests` — Integrate BrowserStack SDK and run web tests on BrowserStack (optionally enable Percy).
+ 16. `setupBrowserStackAutomateTests` — Integrate BrowserStack SDK and run web tests on BrowserStack. For visual testing/Percy, use the dedicated Percy tools.
   **Prompt example**
 
   ```text
-  Run my Selenium-JUnit5 tests written in Java on Chrome and Firefox. Enable Percy for visual testing.
+  Run my Selenium-JUnit5 tests written in Java on Chrome and Firefox.
   ```
 
- 10. `fetchAutomationScreenshots` — Fetch screenshots captured during a given Automate/App Automate session.
+ 17. `fetchAutomationScreenshots` — Fetch screenshots captured during a given Automate/App Automate session.
   **Prompt example**
 
   ```text
@@ -377,18 +428,25 @@ As of now we support 20 tools.
 
 ## 🔍 Observability
 
- 11. `getFailureLogs` — Retrieve error logs for Automate/App Automate sessions (optionally by Build ID for App Automate).
+ 18. `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
   ```
 
+ 19. `fetchBuildInsights` — Fetch insights about a BrowserStack build by combining build details and quality-gate results.
+  **Prompt example**
+
+  ```text
+  Get the build insights for build UUID <your-build-uuid> on BrowserStack
+  ```
+
 ---
 
 ## 📱 App Live
 
- 12. `runAppLiveSession` — Start a manual app testing session on a real device in the cloud.
+ 20. `runAppLiveSession` — Start a manual app testing session on a real device in the cloud.
   **Prompt example**
 
   ```text
@@ -399,7 +457,7 @@ As of now we support 20 tools.
 
 ## 💻 Live
 
- 13. `runBrowserLiveSession` — Start a Live session for website testing on desktop or mobile browsers.
+ 21. `runBrowserLiveSession` — Start a Live session for website testing on desktop or mobile browsers.
   **Prompt example**
 
   ```text
@@ -410,62 +468,179 @@ As of now we support 20 tools.
 
 ## 📲 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.
+ 22. `takeAppScreenshot` — Launch the app on a specified device and capture a quick verification screenshot to confirm your app has launched.
   **Prompt example**
 
   ```text
   Take a screenshot of my app on Google Pixel 6 with Android 12 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.
+ 23. `runAppTestsOnBrowserStack` — Run pre-built native mobile test suites (Espresso/XCUITest) by direct upload of compiled .apk/.ipa test files.
   **Prompt example**
 
   ```text
   Run Espresso tests from /tests/checkout.zip on Galaxy S21 and Pixel 6 with Android 12. App path is /apps/beta-release.apk under project 'Checkout Flow'
   ```
 
+ 24. `setupBrowserStackAppAutomateTests` — Set up BrowserStack App Automate SDK integration for Appium-based mobile app testing.
+  **Prompt example**
+
+  ```text
+  Set up my Appium test suite to run on BrowserStack App Automate
+  ```
+
 ---
 
 ## ♿ Accessibility
 
- 16. `accessibilityExpert` — Ask A11y Expert (WCAG 2.0/2.1/2.2, mobile/web usability, best practices).
+ 25. `accessibilityExpert` — Ask the 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.
+ 26. `startAccessibilityScan` — Start a web accessibility scan and retrieve a local CSV report path.
   **Prompt example**
 
   ```text
   Run accessibility scan for "www.example.com"
   ```
 
+ 27. `createAccessibilityAuthConfig` — Create an authentication configuration (form-based or basic) for accessibility scans behind a login.
+  **Prompt example**
+
+  ```text
+  Create a basic-auth accessibility config named 'site-login' for https://www.example.com with username testuser and password <password>
+  ```
+
+ 28. `getAccessibilityAuthConfig` — Retrieve an existing accessibility authentication configuration by ID.
+  **Prompt example**
+
+  ```text
+  Get accessibility auth config with ID <config-id>
+  ```
+
+ 29. `fetchAccessibilityIssues` — Fetch accessibility issues from a completed scan, with pagination support.
+  **Prompt example**
+
+  ```text
+  Fetch the accessibility issues for scan ID <scan-id> and scan run ID <scan-run-id>
+  ```
+
+---
+
+## 🎨 Percy Visual Testing
+
+ 30. `percyVisualTestIntegrationAgent` — Integrate Percy visual testing into a new project and demonstrate visual change detection with a step-by-step simulation.
+  **Prompt example**
+
+  ```text
+  Integrate Percy for this project
+  ```
+
+ 31. `expandPercyVisualTesting` — Set up or expand Percy visual testing coverage for existing projects (Percy Web Standalone and Percy Automate).
+  **Prompt example**
+
+  ```text
+  Expand Percy coverage for this project
+  ```
+
+ 32. `addPercySnapshotCommands` — Add Percy snapshot commands to the specified test files. _(not available in Remote MCP)_
+  **Prompt example**
+
+  ```text
+  Add Percy snapshot commands to my Cypress test files
+  ```
+
+ 33. `listTestFiles` — List all test files for a given set of directories. _(not available in Remote MCP)_
+  **Prompt example**
+
+  ```text
+  List the test files under my ./tests directory
+  ```
+
+ 34. `runPercyScan` — Run a Percy visual test scan. _(not available in Remote MCP)_
+  **Prompt example**
+
+  ```text
+  Run this Percy build
+  ```
+
+ 35. `fetchPercyChanges` — Retrieve and summarize visual changes detected by Percy AI between the latest and previous builds.
+  **Prompt example**
+
+  ```text
+  Summarize the visual changes Percy detected in my latest build
+  ```
+
+ 36. `managePercyBuildApproval` — Approve or reject a Percy build.
+  **Prompt example**
+
+  ```text
+  Approve the latest Percy build
+  ```
+
 ---
 
 ## 🤖 BrowserStack AI Agents
 
- 18. `fetchSelfHealedSelectors` — Retrieve AI self-healed selectors to fix flaky tests due to DOM changes.
+ 37. `uploadProductRequirementFile` — Upload a PRD/screenshot/PDF and get a file mapping ID (used with `createTestCasesFromFile`). _(not available in Remote MCP)_
   **Prompt example**
 
   ```text
-  Fetch and fix flaky test selectors in Automate session ID session_9482 using MCP
+  Upload PRD from /Users/xyz/Desktop/login-flow.pdf and use BrowserStack AI to generate test cases
   ```
 
- 19. `createLCASteps` — Generate Low Code Automation steps from a manual test case in Test Management.
+ 38. `createLCASteps` — Generate Low Code Automation (LCA) 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`).
+ 39. `fetchSelfHealedSelectors` — Retrieve AI self-healed selectors (plus test source) to fix flaky tests caused by DOM changes.
   **Prompt example**
 
   ```text
-  Upload PRD from /Users/xyz/Desktop/login-flow.pdf and use BrowserStack AI to generate test cases
+  Fetch and fix flaky test selectors in Automate session ID session_9482 using MCP
+  ```
+
+ 40. `prepareSelfHealingPlan` — Build a self-healing edit plan that bundles locator pairs with test source for your LLM to apply. Does NOT modify files itself.
+  **Prompt example**
+
+  ```text
+  Prepare a self-healing plan from the self-healed selectors for my build
+  ```
+
+ 41. `fetchRCA` — Fetch AI Root Cause Analysis for your failed Automate/App-Automate tests (by numeric test ID). Suggests fixes only; never auto-applies.
+  **Prompt example**
+
+  ```text
+  Fetch the root cause analysis for failed test IDs 101 and 102 on BrowserStack
   ```
+
+ 42. `getBuildId` — Get the BrowserStack build ID for a given project and build name, scoped to your builds.
+  **Prompt example**
+
+  ```text
+  Get the build ID for build 'nightly-regression' in project 'Checkout Flow'
+  ```
+
+ 43. `listBuildId` — Get the latest build ID for a project and build name, across all users (no user filter).
+  **Prompt example**
+
+  ```text
+  Get the latest build ID for build 'nightly-regression' in project 'Checkout Flow'
+  ```
+
+ 44. `listTestIds` — List test IDs from a BrowserStack Automate build, filtered by status (passed/failed/pending/skipped).
+  **Prompt example**
+
+  ```text
+  List the failed test IDs from build UUID <your-build-uuid> on BrowserStack
+  ```
+
 ##  🚀 Remote MCP Server
 
 Remote MCP comes with all the functionalities of an MCP server without the hassles of complex setup or local installation.

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

@@ -1,15 +1,25 @@
 import { apiClient } from "../../lib/apiClient.js";
 import { parse } from "csv-parse/sync";
+import logger from "../../logger.js";
 export async function parseAccessibilityReportFromCSV(reportLink, { maxCharacterLength = 5000, nextPage = 0 } = {}) {
     // 1) Download & parse
     const res = await apiClient.get({ url: reportLink });
     if (!res.ok)
         throw new Error(`Failed to download report: ${res.statusText}`);
     const text = typeof res.data === "string" ? res.data : JSON.stringify(res.data);
-    const all = parse(text, {
-        columns: true,
-        skip_empty_lines: true,
-    }).map((row) => ({
+    let parsed;
+    try {
+        parsed = parse(text, {
+            columns: true,
+            skip_empty_lines: true,
+            relax_column_count_less: true,
+        });
+    }
+    catch (err) {
+        logger.error(`[AccessibilityReport] CSV parse failed (${text.length} chars): ${err instanceof Error ? err.message : String(err)}`);
+        throw err;
+    }
+    const all = parsed.map((row) => ({
         issue_type: row["Issue type"],
         component: row["Component"],
         issue_description: row["Issue description"],

package/dist/tools/appautomate-utils/appium-sdk/languages/nodejs.js

@@ -30,11 +30,11 @@ export function getNodejsAppInstructions(testingFramework) {
             npx nightwatch <path to tests> --env browserstack.ios
           \`\`\``);
         case AppSDKSupportedTestingFrameworkEnum.jest:
-            return createStep("Run your Jest test suite with BrowserStack SDK:", `Use the npm script defined in your package.json. For example:\n\n\`\`\`bash\nnpx run browserstack-node-sdk jest specs/single_test.js\n\`\`\``);
+            return createStep("Run your Jest test suite with BrowserStack SDK:", `Use the npm script defined in your package.json. For example:\n\n\`\`\`bash\nnpx browserstack-node-sdk jest specs/single_test.js\n\`\`\``);
         case AppSDKSupportedTestingFrameworkEnum.mocha:
-            return createStep("Run your Mocha test suite with BrowserStack SDK:", `Use the npm script defined in your package.json. For example:\n\n\`\`\`bash\nnpx run browserstack-node-sdk mocha specs/single_test.js\n\`\`\``);
+            return createStep("Run your Mocha test suite with BrowserStack SDK:", `Use the npm script defined in your package.json. For example:\n\n\`\`\`bash\nnpx browserstack-node-sdk mocha specs/single_test.js\n\`\`\``);
         case AppSDKSupportedTestingFrameworkEnum.cucumberJs:
-            return createStep("Run your Cucumber JS test suite with BrowserStack SDK:", `Use the npm script defined in your package.json. For example:\n\n\`\`\`bash\nnpx run browserstack-node-sdk cucumber-js specs/single_test.js\n\`\`\``);
+            return createStep("Run your Cucumber JS test suite with BrowserStack SDK:", `Use the npm script defined in your package.json. For example:\n\n\`\`\`bash\nnpx browserstack-node-sdk cucumber-js specs/single_test.js\n\`\`\``);
         default:
             return "";
     }

package/dist/tools/sdk-utils/bstack/commands.js

@@ -18,7 +18,7 @@ npm i -D browserstack-node-sdk@latest
 ---STEP---
 Run the following command to setup browserstack sdk:
 \`\`\`bash
-npx setup --username ${username} --key ${accessKey}
+npx browserstack-node-sdk setup --username ${username} --key ${accessKey}
 \`\`\``;
 // Template for Gradle setup instructions (platform-independent)
 const GRADLE_SETUP_INSTRUCTIONS = `

package/dist/tools/sdk-utils/percy-automate/constants.d.ts

@@ -4,7 +4,7 @@ export declare const pythonPytestPlaywrightInstructions = "\nInstall Percy Autom
 export declare const jsCypressPercyAutomateInstructions = "\nInstall Percy Automate dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Cypress SDK:\n    npm install --save-dev @percy/cypress\n\n---STEP---\nUpdate your Cypress test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n  - Import and initialize Percy in your cypress/support/index.js:\n    import '@percy/cypress';\n  - In your test, take snapshots at key points:\n    cy.percySnapshot('Your snapshot name');\n\nExample:\n```javascript\ndescribe('Percy Automate Cypress Example', () => {\n  it('should take Percy snapshots', () => {\n    cy.visit('http://localhost:8000');\n    cy.percySnapshot('Home page');\n    // ... more test steps ...\n    cy.percySnapshot('After login');\n  });\n});\n```  \n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- cypress run').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const mochaPercyAutomateInstructions = "\nInstall Percy Automate dependencies\n  - Install Percy CLI:\n    npm install --save @percy/cli\n  - Install Percy Selenium SDK:\n    npm install @percy/selenium-webdriver@2.0.1\n\n---STEP---\nUpdate your Mocha Automate test script\n  - Import the Percy screenshot helper:\n    const { percyScreenshot } = require('@percy/selenium-webdriver');\n  - Use the Percy screenshot command to take required screenshots in your Automate session:\n    await percyScreenshot(driver, 'Screenshot 1');\n    options = { percyCSS: 'h1{color:red;}' };\n    await percyScreenshot(driver, 'Screenshot 2', options);\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- mocha').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const mochaPercyPlaywrightInstructions = "\nInstall Percy Automate dependencies\n  - Install the latest Percy CLI:\n    npm install --save @percy/cli\n  - Install the Percy Playwright SDK:\n    npm install @percy/playwright\n\n---STEP---\nUpdate your Mocha Playwright test script\n  - Import the Percy screenshot helper:\n    const { percyScreenshot } = require(\"@percy/playwright\");\n  - Use the Percy screenshot command to take required screenshots in your Automate session.\n\nExample:\n```javascript\nconst { percyScreenshot } = require(\"@percy/playwright\");\nawait percyScreenshot(page, \"Screenshot 1\");\n// With options\nawait percyScreenshot(page, \"Screenshot 2\", { percyCSS: \"h1{color:green;}\" });\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- <command to run the tests>').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const jestPercyAutomateInstructions = "\nInstall or upgrade the BrowserStack SDK:\n  - Install the SDK:\n    npm i -D browserstack-node-sdk@latest\n  - Run the setup:\n    npx setup --username \"YOUR_USERNAME\" --key \"YOUR_ACCESS_KEY\"\n\n---STEP---\nManually capture screenshots:\n  1. Import the BrowserStack Percy SDK in your test script:\n     const { percy } = require('browserstack-node-sdk');\n  2. Use `percy.screenshot(driver, name)` at desired points in your test.\n\nExample:\n```javascript\nconst { percy } = require('browserstack-node-sdk');\ndescribe(\"JestJS test\", () => {\n  let driver;\n  const caps = require(\"../\" + conf_file).capabilities;\n\n  beforeAll(() => {\n    driver = new Builder()\n      .usingServer(\"http://example-servername/hub\")\n      .withCapabilities(caps)\n      .build();\n  });\n\n  test(\"my test\", async () => {\n    // ...\n    await percy.screenshot(driver, \"My Screenshot\");\n    // ...\n  });\n});\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npm run [your-test-script-name]-browserstack').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const jestPercyAutomateInstructions = "\nInstall or upgrade the BrowserStack SDK:\n  - Install the SDK:\n    npm i -D browserstack-node-sdk@latest\n  - Run the setup:\n    npx browserstack-node-sdk setup --username \"YOUR_USERNAME\" --key \"YOUR_ACCESS_KEY\"\n\n---STEP---\nManually capture screenshots:\n  1. Import the BrowserStack Percy SDK in your test script:\n     const { percy } = require('browserstack-node-sdk');\n  2. Use `percy.screenshot(driver, name)` at desired points in your test.\n\nExample:\n```javascript\nconst { percy } = require('browserstack-node-sdk');\ndescribe(\"JestJS test\", () => {\n  let driver;\n  const caps = require(\"../\" + conf_file).capabilities;\n\n  beforeAll(() => {\n    driver = new Builder()\n      .usingServer(\"http://example-servername/hub\")\n      .withCapabilities(caps)\n      .build();\n  });\n\n  test(\"my test\", async () => {\n    // ...\n    await percy.screenshot(driver, \"My Screenshot\");\n    // ...\n  });\n});\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npm run [your-test-script-name]-browserstack').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const webdriverioPercyAutomateInstructions = "\nInstall or upgrade BrowserStack SDK\n  - Install the BrowserStack SDK:\n    npm i -D @wdio/browserstack-service\n\n---STEP---\nUpdate your WebdriverIO config file\n  1. Set `percy: true`\n  2. Set a `projectName`\n  3. Set `percyCaptureMode: auto` (or another mode as needed)\n\nExample WebdriverIO config:\n```js\nexports.config = {\n  user: process.env.BROWSERSTACK_USERNAME || 'YOUR_USERNAME',\n  key: process.env.BROWSERSTACK_ACCESS_KEY || 'YOUR_ACCESS_KEY',\n  hostname: 'hub.browserstack.com',\n  services: [\n    [\n      'browserstack',\n      { browserstackLocal: true, opts: { forcelocal: false }, percy: true, percyCaptureMode: 'auto' }\n    ],\n  ],\n  // add path to the test file\n}\n```\n\n---STEP---\n(Optional) Manually capture screenshots\n  1. Import the BrowserStack Percy SDK in your test script:\n    const { percy } = require('browserstack-node-sdk');\n  2. Add the `await percy.screenshot(driver, name)` method at required points in your test script.\n\nExample:\n```javascript\n    const { percy } = require('browserstack-node-sdk');\n  2. Add the `await percy.screenshot(driver, name)` method at required points in your test script.\n\nExample:\n```javascript\nconst { percy } = require('browserstack-node-sdk');\ndescribe(\"WebdriverIO Test\", () => {\n  it(\"my test\", async () => {\n    // ....\n    await percy.screenshot(driver, \"My Screenshot\")\n    // ....\n  });\n});\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command as defined in your package.json file.\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const testcafePercyAutomateInstructions = "\nInstall Percy dependencies\n  - Install the required dependencies:\n    npm install --save-dev @percy/cli @percy/testcafe\n\n---STEP---\nUpdate your test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n  - Import the Percy library and use the percySnapshot function to take screenshots.\n\nExample:\n```javascript\nimport percySnapshot from '@percy/testcafe';\nfixture('MyFixture')\n  .page('https://devexpress.github.io/testcafe/example/');\ntest('Test1', async t => {\n  await t.typeText('#developer-name', 'John Doe');\n  await percySnapshot(t, 'TestCafe Example');\n});\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- testcafe chrome:headless tests').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const javaPlaywrightJunitInstructions = "\nInstall Percy Automate dependencies\n  - Install the latest Percy CLI:\n    npm install --save @percy/cli\n  - Add the Percy Playwright Java SDK to your pom.xml:\n```xml\n<dependency>\n  <groupId>io.percy</groupId>\n  <artifactId>percy-playwright-java</artifactId>\n  <version>1.0.0</version>\n</dependency>\n```\n\n---STEP---\nUpdate your Automate test script\n  - Import the Percy library:\n    import io.percy.playwright.Percy;\n  - Use the Percy screenshot command to take required screenshots in your Automate session.\n\nExample:\n```java\nPercy percy = new Percy(page);\npercy.screenshot(\"screenshot_1\");\n// With options\npercy.screenshot(\"screenshot_2\", options);\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- <command to run the automate script file>').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";

package/dist/tools/sdk-utils/percy-automate/constants.js

@@ -161,7 +161,7 @@ Install or upgrade the BrowserStack SDK:
   - Install the SDK:
     npm i -D browserstack-node-sdk@latest
   - Run the setup:
-    npx setup --username "YOUR_USERNAME" --key "YOUR_ACCESS_KEY"
+    npx browserstack-node-sdk setup --username "YOUR_USERNAME" --key "YOUR_ACCESS_KEY"
 
 ---STEP---
 Manually capture screenshots:

package/package.json

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