Best for
- QA teams using BrowserStack
- Developers who want to integrate testing into AI workflows
- Teams needing accessibility compliance
- Automated test maintenance
B
BrowserStack MCP Server
Official
BrowserStack's official MCP server for natural language control of the test platform.
GitHub source repository ↗
40FMRS · D
The BrowserStack MCP server is an official server that offers a comprehensive set of tools for integrating the testing platform into MCP clients. It supports manual and automated testing, accessibility and visual testing, and AI-driven debugging. Installation requires BrowserStack credentials, and some tools are not available in Remote MCP. Overall, it is a powerful integration for teams using BrowserStack.
The BrowserStack MCP server is the official server from BrowserStack that brings the vast ecosystem of real device cloud and test platform into MCP clients such as Cursor, Claude, or GitHub Copilot. It enables managing test cases, executing manual or automated tests, debugging issues, and even fixing code using plain English commands. With 44 tools, it supports test management, automation test setup (Selenium, Appium, Playwright), observability troubleshooting, live device/browser testing, accessibility scanning, Percy visual testing, and BrowserStack AI agents.
Tools
createProjectOrFolder
Create a Test Management project and/or folders, returns project/folder ID and link.
createTestCase
Add a manual test case under a specific project/folder.
updateTestCase
Update an existing test case with any subset of fields.
listTestCases
List test cases in a project, optionally scoped to a folder.
listFolders
List folders in a Test Management project with IDs, names, and case counts.
listTestCaseTemplates
List available test case templates for use with createTestCase.
createTestRun
Create a test run (suite) for selected test cases.
listTestRuns
List test runs for a project, filter by dates, assignee, or state.
updateTestRun
Update a test run's name/state and/or add test cases.
addTestResult
Add a manual execution result (passed/failed/blocked/skipped) for a test case.
createTestCasesFromFile
Generate test cases in bulk from an uploaded file using AI (not available in Remote MCP).
listTestPlans
List test plans in a project.
getTestPlan
Get details of a test plan, including linked runs and status.
listSubTestPlans
List sub-test-plans under a parent test plan.
getSubTestPlan
Get details of a sub-test-plan under a parent plan.
setupBrowserStackAutomateTests
Set up BrowserStack SDK to run web tests.
fetchAutomationScreenshots
Fetch screenshots captured during an automation session.
getFailureLogs
Retrieve error logs for automation sessions.
fetchBuildInsights
Get build insights and quality-gate results.
runAppLiveSession
Start a manual app testing session on a real device.
runBrowserLiveSession
Start a Live session for website testing.
takeAppScreenshot
Launch an app and capture a screenshot to verify launch.
runAppTestsOnBrowserStack
Run existing native mobile test suites (Espresso/XCUITest).
setupBrowserStackAppAutomateTests
Set up BrowserStack App Automate SDK for Appium mobile testing.
accessibilityExpert
Ask the A11y Expert about WCAG and usability best practices.
startAccessibilityScan
Start a web accessibility scan and get a report path.
createAccessibilityAuthConfig
Create an authentication config for accessibility scans.
getAccessibilityAuthConfig
Get an existing accessibility auth config by ID.
fetchAccessibilityIssues
Fetch accessibility issues from a completed scan.
percyVisualTestIntegrationAgent
Integrate Percy visual testing into a new project.
expandPercyVisualTesting
Set up or expand Percy visual testing for existing projects.
addPercySnapshotCommands
Add Percy snapshot commands to test files (not available in Remote MCP).
listTestFiles
List all test files in given directories (not available in Remote MCP).
runPercyScan
Run a Percy visual test scan (not available in Remote MCP).
fetchPercyChanges
Get a summary of visual changes detected by Percy AI.
managePercyBuildApproval
Approve or reject a Percy build.
uploadProductRequirementFile
Upload a PRD/screenshot/PDF to get a file mapping ID (not available in Remote MCP).
createLCASteps
Generate Low Code Automation steps from a manual test case.
fetchSelfHealedSelectors
Retrieve AI self-healed selectors to fix flaky tests.
prepareSelfHealingPlan
Build a self-healing edit plan without modifying files.
fetchRCA
Fetch AI Root Cause Analysis for failed tests (suggests fixes only).
getBuildId
Get the BrowserStack build ID for a project and build name.
listBuildId
Get the latest build ID across all users.
listTestIds
List test IDs from a build, filtered by status.
Setup
- Ensure Node.js >= 18.0 (v22.15.0 LTS recommended). 2. Sign up for a BrowserStack account and get your username and access key. 3. Add the JSON configuration to your client's config file, or use one-click setup for VS Code/Cursor. 4. Start the server and authorize.
claude_desktop_config.json
{
"mcpServers": {
"browserstack": {
"command": "npx",
"args": ["-y", "@browserstack/mcp-server@latest"],
"env": {
"BROWSERSTACK_USERNAME": "<username>",
"BROWSERSTACK_ACCESS_KEY": "<access_key>"
}
}
}
}
Fit and risk
Not for
- Teams not using BrowserStack
- Users needing local testing support (Remote MCP cannot access localhost)
- Users expecting fully automated file modifications (tools only suggest fixes)
Required permissions
- Requires BrowserStack username and access key
- Can create and modify Test Management projects, test cases, and runs
- Can start live sessions and run automated tests
- Can access test reports and logs
- Some tools require access to local file system (e.g., uploading files)
Risks and side effects
- Credentials may be logged by tools; handle them securely
- AI might produce unexpected actions; test in a safe environment
- Some tools are unavailable in Remote MCP, behavior may differ
- Test execution may incur costs
- Dependency on network and BrowserStack service availability
Troubleshooting
- Check Node version is >= 18.0
- Verify BrowserStack username and access key are correct
- Ensure you have an appropriate plan
- Check network connectivity and firewall settings
- For local testing, use local MCP server instead of Remote
- Open issues on GitHub or contact BrowserStack support
Use cases
Manage test cases and runs using natural language.
Run manual tests on real browsers and devices.
Set up and run automated tests (Selenium, Appium, Playwright).
Debug test failures and get AI-powered root cause analysis.
Scan and fix web accessibility issues.
Integrate Percy visual testing and review changes.
Supported clients
Claude DesktopFull support
GitHub CopilotFull support
CursorFull support
ClineFull support