Submit Log in

BrowserStack

by BrowserStack

v1.2.33

ISC

Repository Docs npm

Developer Tools

testingmobilebrowser-testingautomationqa

Summary

Official BrowserStack MCP server: run manual and automated tests on real browsers and devices, then debug and fix failing tests from your IDE in plain English.

Features

Manual app testing on real iOS and Android devices
Cross-browser web testing, including sites served from localhost
Automated Playwright, Selenium and accessibility test runs
Fetches logs, diagnoses failures and proposes code fixes in your IDE
Test-management tools for projects, folders and test cases
44 tools; hosted Remote MCP option alongside the local npx server

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "BrowserStack" tools will be available.

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

Claude Code

Add the server with a single CLI command.

claude mcp add browserstack-mcp -e BROWSERSTACK_USERNAME=<username> -e BROWSERSTACK_ACCESS_KEY=<access_key> -- npx -y @browserstack/mcp-server@latest

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

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

Cursor

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

VS Code

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

Description

The BrowserStack MCP server puts the BrowserStack Test Platform behind an MCP interface, so an agent can open your app on a real iPhone 15 Pro Max, reproduce a crash on Android 14, or run a website against a browser you do not have installed — all from a natural-language prompt in Claude Code, Cursor, VS Code or any MCP client.

What it covers

Manual app testing on BrowserStack's cloud of real devices, not emulators, with app-profiling data for crash and performance debugging.
Manual web testing across every major browser and OS, including sites served from localhost — no deploy step needed to test a local build.
Automated testing for Playwright, Selenium, accessibility suites and more: the server fetches logs, diagnoses why a script broke, and can apply a context-aware fix in the repo you have open.
Test management: creating projects and folders, organising test cases, and linking back to the Test Management dashboard.

As of the current release it exposes 44 tools. A hosted multi-tenant Remote MCP server is also available; tools that depend on local file or process state are disabled there and only work in the local npx setup.

Requirements

Node.js 18 or newer (22 LTS recommended) and a BrowserStack account — set BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY in the server environment. One-click installers are published for VS Code and Cursor. Published as @browserstack/mcp-server under the ISC licence.

Related MCP Servers

MCP: Mobile MCP

by Mobile Next

New

Platform-agnostic MCP server that drives iOS and Android apps on simulators, emulators and real devices through the accessibility tree rather than screenshots.

Developer Tools