Run automated app tests in BrowserStack App Automate with the MCP server

Use natural language prompts in your AI assistant to instantly run automated app tests or take quick verification screenshots in BrowserStack App Automate on real devices.

Use the BrowserStack MCP server to run automated app tests and take quick verification screenshots in App Automate directly from your coding assistant (such as GitHub Copilot, Claude, or Cursor). Skip the dashboard and start testing your app on any real device with simple prompts.

To get started with BrowserStack MCP server, see the get started with BrowserStack MCP documentation.

Streamline app automation testing from your IDE

Use the following tools to set up the BrowserStack SDK, run app automation tests, and fetch screenshots from BrowserStack App Automate sessions, all through natural language prompts:

Run automated app tests (runAppTestsOnBrowserStack)

Use the runAppTestsOnBrowserStack tool to run your automated mobile tests (Espresso, XCUITest, etc.) on real devices in the cloud. This is the primary tool for executing your test suites.

Example: Using MCP server with App Automate using Github Copilot agent on VS Code

Take app screenshot (takeAppScreenshot)

Use the takeAppScreenshot tool to quickly verify your app has launched successfully on a device. This tool launches the app on a specified device and captures a screenshot.

Example: Using MCP server with App Automate using Github Copilot agent on VS Code

Tool reference

Use the takeAppScreenshot tool to quickly verify your app launch, and the runAppTestsOnBrowserStack tool to run automated mobile tests (Espresso, XCUITest, etc.) on real devices in the cloud.

Common workflows

The following workflows are supported on the BrowserStack MCP server to accomplish complex testing scenarios. Each workflow shows the sequence of tools and automated actions that streamline common development tasks:

Rapid SDK setup and integration

Run your automated app testing project on BrowserStack platform by seamlessly integrating BrowserStack SDK, configuring devices, and enabling visual testing (Percy) in one go. Enabling Percy tests is optional.
Tools invoked: setupBrowserStackAppAutomateTests, runAppTestsOnBrowserStack

Example prompts:

• Set up App Automate SDK for my Appium (Python) project, configure it to run on Pixel 7 and iPhone 15, and enable Percy for visual testing.

• Set up BrowserStack SDK for my Appium project, run these automated tests on BrowserStack using MCP server.
  Project: [Insert GitHub URL]
  Framework: Appium
  Language: Java
  Target Devices: Samsung Galaxy S23, iPhone 14 Pro
  Enable Percy: true (optional)
  

Automated actions (What the MCP server does):

1. Detects your project’s framework and language (e.g., Appium + Java).

2. Installs the necessary BrowserStack SDK and dependencies into your project.

3. Configures the browserstack.yml file with your requested devices (e.g., Pixel 7, iPhone 15).

4. Enables Percy for visual testing if requested.

Run tests and debug failures

Automate the complete execution and debugging loop by running tests, identifying failures, and using AI to determine the Root Cause Analysis (RCA).
Tools invoked: runAppTestsOnBrowserStack, getBuildId, listTestIds, fetchRCA

Example prompts:

• “Run my Espresso tests on BrowserStack. Once finished, list any failed test IDs.”

• “List failed test IDs for build . Fetch the RCA for each failure and suggest code fixes to resolve them."

Automated actions (What the MCP server does):

1. Executes your test suite on the BrowserStack App Automate cloud.

2. Retrieves the specific Build ID and filters the list for status=failed.

3. Fetches RCA logs to diagnose if the failure is due to a script error, app crash, or device issue.

4. Provides AI-generated code fix suggestions based on the RCA logs.

Need help?

• FAQs for common questions.
• Troubleshoot for common issues.