browserstack

---
name: browserstack
description: Use when running Playwright tests on BrowserStack cloud grid for cross-browser and cross-device testing.
category: Engineering
version: 1.0.0
tools: []
---

# BrowserStack Integration

Run Playwright tests on BrowserStack's cloud grid for cross-browser and cross-device testing.

## Prerequisites

Environment variables:
- `BROWSERSTACK_USERNAME` — your BrowserStack username
- `BROWSERSTACK_ACCESS_KEY` — your access key

## Capabilities

### 1. Configure for BrowserStack

Add BrowserStack connect options to playwright.config.ts with wsEndpoint connecting to `wss://cdp.browserstack.com/playwright`. Set capabilities for browser (chrome/firefox/webkit), browser_version (latest), os (Windows/OS X), os_version.

### 2. Run Tests on BrowserStack

Verify credentials are set. Run tests with BrowserStack projects:
```bash
BROWSERSTACK_USERNAME=$BROWSERSTACK_USERNAME \
BROWSERSTACK_ACCESS_KEY=$BROWSERSTACK_ACCESS_KEY \
npx playwright test --project='chrome@*' --project='firefox@*'
```

Monitor execution and report results per browser.

### 3. Get Build Results

Call browserstack_get_builds MCP tool. Display latest build's sessions with status (pass/fail), browser/OS, duration, video URL, logs.

### 4. Check Available Browsers

Call browserstack_get_browsers MCP tool. Filter for Playwright-compatible browsers. Display available combinations.

### 5. Local Testing

For localhost/staging behind firewall:
1. Install browserstack-local: npm install -D browserstack-local
2. Add local tunnel to config
3. Follow setup instructions

## MCP Tools Used

| Tool | When |
|---|---|
| browserstack_get_plan | Check account limits |
| browserstack_get_browsers | List available browsers |
| browserstack_get_builds | List recent builds |
| browserstack_get_sessions | Get sessions in a build |
| browserstack_get_session | Get session details (video, logs) |
| browserstack_update_session | Mark pass/fail |
| browserstack_get_logs | Get text/network logs |

## Output

- Cross-browser test results table
- Per-browser pass/fail status
- Links to BrowserStack dashboard for video/screenshots
- Browser-specific failures highlighted