Ask the Community
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 use App Automate tools on the MCP server, you need an App Automate license. Contact BrowserStack support to enable a license for your account.
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:
1. 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
2. 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.
For a complete list of supported browsers & mobile devices, refer to the BrowserStack App Automate supported devices & browsers page.
| Example Prompt | Description | Input Parameters | Invoked Tool |
|---|---|---|---|
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’ |
Runs automated mobile tests (Espresso/XCUITest, etc.) on real devices. | • App path (required) • Test suite path (required) • Device name(s) (required) • Platform version (required) • Project (optional) |
runAppTestsOnBrowserStack |
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
|
Launches the app on a specified device and captures a screenshot to verify it has launched successfully. | • App path (required) • Device name (required) • Platform name (required) • Platform version (required) |
takeAppScreenshot |
| List failed test IDs for build auto_bld_6641. | Lists test IDs from a BrowserStack Automate build. You can filter by status (e.g., failed). | • Build ID (required) • Status filter (optional) |
listTestIds |
| Set up App Automate SDK for Java + Appium; run on Pixel 7 (Android 14) and iPhone 15 (iOS 17). | Sets up App Automate SDK integration for Appium tests (multiple languages). Not for Espresso/XCUITest bundles. | • Language (required) • Framework (required) • Device name(s) (required) • Platform version(s) (required) |
setupBrowserStackAppAutomateTests |
| Run Espresso tests from /tests/checkout.zip on Galaxy S21 and Pixel 6 (Android 12). App: /apps/beta-release.apk under project Checkout Flow. | Runs pre‑built native suites—Espresso (Android) or XCUITest (iOS)—by uploading app + tests. Not for Appium/SDK setups. | • App path (required) • Test suite path (required) • Device name(s) (required) • Platform version (required) • Project (optional) |
runAppTestsOnBrowserStack |
Need help?
- FAQs for common questions.
- Troubleshoot for common issues.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!