home / mcp / browserstack mcp server

BrowserStack MCP Server

BrowserStack's Official MCP Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "browserstack-mcp-server": {
      "url": "https://mcp.browserstack.com/mcp",
      "headers": {
        "BROWSERSTACK_USERNAME": "user_1234",
        "BROWSERSTACK_ACCESS_KEY": "abc123xyz"
      }
    }
  }
}

You run a BrowserStack MCP Server to connect clients like IDEs and AI tools with BrowserStack’s testing platform. It lets you manage test cases, execute manual or automated tests, debug issues, and even fix code directly from MCP-enabled clients using natural language prompts and in-context project data.

How to use

You interact with the MCP Server through an MCP client. Use natural language prompts to create, list, run, and update tests, manage test plans, and retrieve logs and screenshots. Start a local MCP server during development to run tests on BrowserStack infrastructure or connect to a remote MCP endpoint when you prefer not to host locally.

How to install

Prerequisites you need before installation:

Node.js version 18 or higher is required. Check your version with node --version and aim for a 22.x LTS release.
If you need to upgrade, use your platform’s package manager or Node version manager (for example, Homebrew on macOS, nvm on Unix-like systems, or nvm-windows on Windows).

One-click MCP setup is available in compatible IDEs. If you’re setting up manually, you can configure a local MCP server as shown below, using your BrowserStack credentials.

Alternatively, set up a remote MCP server to route MCP requests to BrowserStack’s hosted MCP endpoint.

Configuration and setup details

Local MCP server configuration (stdio) That runs from your development environment uses npx to start the BrowserStack MCP server and requires your BrowserStack credentials.

{
  "servers": {
    "browserstack": {
      "command": "npx",
      "args": ["-y", "@browserstack/mcp-server@latest"],
      "env": {
        "BROWSERSTACK_USERNAME": "<username>",
        "BROWSERSTACK_ACCESS_KEY": "<access_key>"
      }
    }
  }
}

Remote MCP server configuration

If you want to use a remote MCP server instead of a local one, you can point your MCP client at BrowserStack’s hosted MCP endpoint.

{
  "type": "http",
  "name": "browserstack_remote",
  "url": "https://mcp.browserstack.com/mcp",
  "args": []
}

Available tools

fetchSelfHealedSelectors

Retrieve AI self-healed selectors to fix flaky tests due to DOM changes.

createLCASteps

Generate Low Code Automation steps from a manual test case in Test Management.

uploadProductRequirementFile

Upload a PRD/screenshot/PDF and get a file mapping ID (used with createTestCasesFromFile).

setupBrowserStackAutomateTests

Integrate BrowserStack SDK and run web tests on BrowserStack (optionally enable Percy).

fetchAutomationScreenshots

Fetch screenshots captured during an Automate session.

getFailureLogs

Retrieve error logs for Automate/App Automate sessions (optionally by Build ID).

runAppLiveSession

Start a manual app testing session on a real device in the cloud.

runBrowserLiveSession

Start a Live session for website testing on desktop or mobile browsers.

takeAppScreenshot

Launch the app on a device and capture a quick verification screenshot.

runAppTestsOnBrowserStack

Run automated mobile tests on real devices.

accessibilityExpert

Ask an accessibility expert about WCAG compliance and best practices.

startAccessibilityScan

Start a web accessibility scan and obtain a result link.

getAutomationReports

Retrieve automated test reports and results.

listTestManagement

Manage test management projects, tests, and runs.

createTestCase

Create a new manual test case within a Test Management project.

createTestRun

Create a test run for selected test cases in a project.

listTestRuns

List test runs for a project with filters.

updateTestRun

Update a test run with status, notes, and associated test cases.

fetchLogs

Fetch logs for a specific Automate session.

convertToLCASteps

Convert an existing manual test case into Low Code Automation steps.