MCP Server

Browser TestingCross-BrowserE2E TestingApache 2.0

Playwright MCP Server

by Microsoft · microsoft/playwright-mcp

Playwright MCP Server brings Microsoft's industry-leading cross-browser automation framework to AI coding assistants through the Model Context Protocol. Your agent can launch Chrome, Firefox, and WebKit browsers, navigate to any URL, interact with page elements, capture screenshots across viewports, intercept network traffic, and run full end-to-end test suites — all through natural language commands without leaving your IDE.

Unlike single-browser solutions, Playwright MCP tests your application across all major rendering engines simultaneously. Its intelligent auto-waiting system eliminates the flaky failures common in browser automation by automatically waiting for elements to be visible, enabled, and stable before interacting. Combined with network interception, trace recording, and parallel execution support, it provides the most comprehensive browser testing toolkit available to AI agents.

Browsers

Chrome, Firefox, WebKit

Review

Setup

client-specific setup

15+

Tools Exposed

navigate, click, assert...

Apache 2.0

License

open source

Install with source evidence

MCP_SERVER · SOURCE_CHECKED_ONLY

Official instructions checked 2026-10-13. No client installation or runtime test performed by this site.

Access: launches local code with your OS account permissions and lets an agent control a browser. Browser pages, session data, local files and network access can be exposed. Use a separate test profile and no sensitive accounts. This is not a sandbox or safety certification.

Prerequisites: Use Node.js 20+ for the current installation guide (the repository README still lists 18+). No API key or environment variable is required for this basic local setup. Browser dependencies depend on your machine. The latest tag can change; review the upstream version before running.

CLI registration

Run in the intended project. Claude Code defaults to local project scope; inspect existing registration first.

claude mcp add playwright -- npx @playwright/mcp@latest

Verify after you choose to install

Open /mcp and check playwright is connected. Ask for one navigation to a non-sensitive test page; inspect the returned snapshot.

Remove this registration

Run claude mcp remove playwright in the same project and scope, then check /mcp again. Removing registration does not erase downloaded packages, browser profiles or session files.

If launch fails, check the client log and official troubleshooting before adding flags. For Windows launch-wrapper options, see the existing command builder. Copying does not install or verify anything.

View listed source repository →

Key Features

Cross-Browser Testing

Run identical test scenarios across Chrome, Firefox, and WebKit with a single command. Catch browser-specific rendering bugs, CSS inconsistencies, and JavaScript compatibility issues before your users encounter them in production.

Intelligent Auto-Waiting

Playwright automatically waits for elements to be visible, enabled, and stable before performing actions. No manual sleep statements or polling loops needed — the agent interacts with elements exactly when they are ready, eliminating flaky test failures.

Network Interception

Intercept, modify, and mock network requests and responses at the browser level. Block analytics scripts during testing, simulate API failures for error handling validation, or inject mock data to test edge cases without modifying backend services.

Multi-Context Isolation

Create multiple independent browser contexts within a single browser instance. Each context has isolated cookies, storage, and session state — enabling parallel test execution and multi-user scenario testing without cross-contamination between sessions.

Trace Recording

Record detailed execution traces capturing screenshots, DOM snapshots, network activity, and console logs at every step. Replay traces in Playwright's Trace Viewer to debug failures visually with full timeline context and element highlighting.

Mobile Emulation

Emulate mobile devices with accurate viewport sizes, device scale factors, touch events, and user agent strings. Test responsive layouts and mobile-specific behaviors on iPhone, iPad, Pixel, and other device profiles without physical hardware.

Execution Brief

Use this page as a rollout checklist, not just reference text.

Suggest update

Tool Mapping Lens

Organize Tools by Workflow Phase

Start with the task you need to complete. Build a shortlist, then check each tool for security, ownership and fit before adding it to your workflow.

Define the job-to-be-done first
Group tools by stage
Prioritize by adoption friction

Actionable Utility Module

Skill Implementation Board

Use this board for Playwright MCP Server before rollout. Capture inputs, apply one decision rule, execute the checklist, and log outcome.

Input: Objective

Deliver one measurable improvement with playwright mcp server claude code cross-browser testing e2e automation webkit firefox chrome

Input: Baseline Window

20-30 minutes

Input: Fallback Window

8-12 minutes

Decision Trigger	Action	Expected Output
Input: one workflow objective and release owner are defined	Run preview execution with fixed acceptance criteria.	Go or hold decision backed by repeatable evidence.
Input: output quality below baseline or retries increase	Limit scope, isolate root issue, and rerun controlled test.	One confirmed correction path before wider rollout.
Input: checks pass for two consecutive replay windows	Promote to broader traffic with fallback path active.	Stable rollout with low operational surprise.

Execution Steps

Record objective, owner, and stop condition.
Execute one controlled preview run.
Measure quality, latency, and correction burden.
Promote only when pass criteria are stable.

Output Template

tool=playwright mcp server claude code cross-browser testing e2e automation webkit firefox chrome
objective=
preview_result=pass|fail
primary_metric=
next_step=rollout|patch|hold

Share execution feedback

What Is Playwright MCP Server?

Playwright MCP Server is a Model Context Protocol bridge that connects AI coding assistants to Microsoft's Playwright browser automation framework. It exposes cross-browser testing primitives — navigation, element interaction, assertions, network interception, screenshot capture, and trace recording — as MCP tools that Claude Code, Cursor, or any compatible client can invoke directly from the IDE.

Modern web applications must work flawlessly across Chrome, Firefox, and Safari — three fundamentally different rendering engines with their own quirks and behaviors. Playwright MCP gives your agent the ability to test across all three simultaneously. Ask "run this checkout flow on all browsers and tell me if anything breaks" and the agent handles launching browsers, executing steps, comparing results, and reporting differences in one seamless interaction.

What sets Playwright apart from other browser automation tools is its intelligent auto-waiting system. Every action — clicking a button, filling a field, checking a checkbox — automatically waits for the target element to be attached to the DOM, visible, stable (not animating), enabled, and not obscured by other elements. This eliminates the single biggest source of flaky tests in browser automation without requiring any extra code from the developer.

Playwright MCP integrates naturally with the broader MCP ecosystem. Filesystem MCP saves screenshots and trace files to disk for comparison, GitHub MCP creates issues from failed tests and attaches visual evidence to pull requests, and Postgres MCP stores test results in a database for historical trend analysis. The combination creates a complete CI-quality testing pipeline driven entirely by your AI assistant.

How to Calculate Better Results with playwright mcp server claude code cross-browser testing e2e automation webkit firefox chrome

Review the source evidence card above. Microsoft publishes @playwright/mcp; select the configuration for your actual client. A SKILL.md folder is a different integration and must not be installed as a guessed MCP package.

Use Node.js 20 or later for the current installation guide, and check and the selected browser requirements in the official installation guide. The configuration shown registers a local stdio server; it is not a completed installation test. Do not assume a fixed download size or that all engines are already installed.

Use documented Playwright MCP options such as --browser and --headless when needed. Review the upstream configuration section for their exact values; do not rely on generic PLAYWRIGHT_BROWSERS, PLAYWRIGHT_HEADLESS, PLAYWRIGHT_TIMEOUT or PLAYWRIGHT_TRACE variables as this server’s configuration contract.

After you choose to install, inspect the client status, request a navigation to a non-sensitive test page, and confirm the returned result. Remove the registration using the same client and scope if it fails. This site has checked sources only, not installed the server or tested your machine.

Treat this page as a decision map. Build a shortlist fast, then run a focused second pass for security, ownership, and operational fit.

When a team keeps one shared selection rubric, tool adoption speeds up because evaluators stop debating criteria every time a new option appears.

Worked Examples

Cross-browser checkout flow validation

Your e-commerce site has a multi-step checkout that must work identically on Chrome, Firefox, and Safari before every release
Ask the agent to launch all three browsers using Playwright MCP and navigate each to your staging site's product page
The agent adds an item to the cart, proceeds to checkout, fills shipping details, enters test payment information, and submits the order on each browser in parallel using isolated browser contexts
At each step, the agent captures screenshots across all browsers and compares them for layout consistency — checking button positions, form field alignment, and error message rendering
The agent verifies that the order confirmation page appears on all browsers with matching order numbers and totals, flagging any browser where the flow diverges
A comprehensive test report is generated showing pass/fail status per browser, screenshots at each step, and any cross-browser inconsistencies found during the checkout flow

Outcome: A thorough cross-browser validation of the most revenue-critical user flow, catching Safari-specific CSS bugs and Firefox form handling differences before they reach production users.

Accessibility audit with mobile emulation

Your team needs to verify that the marketing site meets WCAG accessibility standards across desktop and mobile viewports
Ask the agent to navigate to each critical page (homepage, pricing, docs, blog) using Playwright MCP with desktop viewport (1920x1080) and then with iPhone 14 mobile emulation
The agent runs accessibility checks using Playwright's built-in accessibility tree inspection, extracting ARIA roles, labels, tab order, and color contrast ratios from each page
For mobile viewports, the agent verifies that touch targets meet minimum size requirements (48x48px), navigation menus are reachable, and no content is hidden behind non-scrollable overlays
The agent takes screenshots of any elements flagged as accessibility violations, annotating the specific WCAG criterion that was violated and the severity level
Results are compiled into a structured report saved via Filesystem MCP, with a summary table showing violation counts per page and severity, plus actionable fix suggestions for each issue

Outcome: A comprehensive accessibility audit covering both desktop and mobile experiences, with visual evidence and specific WCAG references that the team can use to prioritize remediation work.

Frequently Asked Questions

What is the Playwright MCP Server?

Playwright MCP Server is a Model Context Protocol integration built on Microsoft's Playwright framework that gives AI coding assistants the ability to automate Chrome, Firefox, and WebKit browsers simultaneously. It exposes browser automation primitives — navigation, element interaction, screenshot capture, network interception, and assertion helpers — as MCP tools callable from Claude Code, Cursor, or any compatible client.

How does Playwright MCP differ from Puppeteer MCP?

The biggest difference is browser coverage. Puppeteer MCP only supports Chromium-based browsers, while Playwright MCP can drive Chrome, Firefox, and WebKit from a single API. Playwright also offers built-in auto-waiting that intelligently waits for elements to become actionable before interacting, reducing flaky test failures. Additionally, Playwright supports multiple browser contexts for parallel test isolation and has richer network interception capabilities.

Which browsers does Playwright MCP support?

Playwright MCP supports three browser engines: Chromium (Chrome and Edge), Firefox (Gecko engine), and WebKit (Safari engine). Select the browser through the official --browser option and check its local dependencies. Registering an MCP server does not automatically install or validate every engine; cross-browser runs need separate configuration.

Can Playwright MCP run tests in parallel?

Yes. Playwright's browser context isolation allows the agent to create multiple independent browser sessions within a single browser instance. Each context has its own cookies, local storage, and session state. This enables parallel test execution where different user flows run simultaneously without interfering with each other, dramatically reducing total test time.

How do I handle authentication in Playwright MCP tests?

Playwright MCP supports saving and restoring authentication state. The agent can log in once, save the browser context's storage state (cookies and local storage) to a JSON file via Filesystem MCP, and reload that state in subsequent test runs. This skips the login flow for every test, making test suites faster and more reliable while still testing authenticated pages.

Does Playwright MCP work in CI/CD pipelines?

The MCP server supports the --headless option. Configure browser dependencies and the client environment explicitly for CI; a copied registration is not evidence of a working CI pipeline.

Missing a better tool match?

Send the exact workflow you are solving and we will prioritize a new comparison or rollout guide.

Submit feedback