Playwright MCP Server

Exposes Playwright browser automation capabilities as an MCP server, allowing Claude and other MCP clients to invoke browser control through standardized tool definitions. Implements the Model Context Protocol specification to translate high-level browser intents (navigate, click, extract) into Playwright API calls, with request/response serialization over stdio or HTTP transports.

Supports launching browsers in both headless (no UI) and headed (visible UI) modes through Playwright's launch configuration, allowing developers to toggle between fast automated testing and visual debugging. Exposes mode selection as a server configuration or per-session parameter, with automatic browser context management for each mode.

Provides tools for listening to page events (load, error, popup, console messages) and intercepting network requests/responses. Supports route interception for request modification, response mocking, and request blocking. Enables advanced workflows like API mocking, request inspection, and error handling.

Provides tools for setting viewport dimensions, emulating specific devices (mobile phones, tablets), and configuring user agent strings. Supports preset device profiles (iPhone, iPad, Android) and custom viewport/device configurations. Enables testing of responsive designs and mobile-specific behavior.

Manages multiple browser pages and contexts within a single browser instance, allowing parallel or sequential navigation and interaction across different pages. Uses Playwright's context and page abstractions to isolate cookies, local storage, and DOM state, with context-aware tool invocations that route commands to the correct page or context.

Provides tools for locating and interacting with DOM elements using CSS selectors, XPath expressions, and Playwright's built-in locator API. Supports click, type, fill, hover, and other interaction primitives with automatic waiting for element visibility/stability. Implements selector validation and error handling to provide meaningful feedback when elements are not found.

Extracts page content as plain text, HTML, or structured data using Playwright's page evaluation APIs. Supports full-page text extraction, targeted element text retrieval, and custom JavaScript execution for complex data extraction. Returns content with optional formatting preservation and metadata about extracted elements.

Captures full-page or element-specific screenshots as base64-encoded images, enabling visual verification of page state and debugging of visual issues. Supports viewport-specific screenshots, full-page scrolling captures, and element bounding box screenshots. Returns images in PNG format with optional metadata about capture dimensions and timing.

Provides tools for navigating to URLs, handling redirects, and managing browser history. Supports goto() with wait conditions (load, domcontentloaded, networkidle), back/forward navigation, and URL retrieval. Implements timeout handling and error reporting for failed navigations, with automatic redirect following.

Provides tools for filling form fields, submitting forms, and simulating keyboard input (typing, key presses, keyboard shortcuts). Supports both direct field filling (fill()) and character-by-character typing (type()) with optional delays to simulate human input speed. Handles form submission with automatic waiting for navigation or network idle.

Provides tools for waiting on page state changes, element visibility, network activity, and custom conditions. Supports waitForSelector(), waitForNavigation(), waitForFunction(), and waitForLoadState() with configurable timeouts. Enables reliable automation of pages with dynamic content loading, AJAX requests, and asynchronous rendering.

Provides tools for reading, setting, and clearing cookies and local storage values. Supports cookie operations (get, set, delete, clear all) with domain/path/expiration control, and localStorage/sessionStorage manipulation via JavaScript evaluation. Enables session persistence and state management across page navigations.