tontoko/fast-playwright-mcp

Use the Claude Code CLI to add the Playwright MCP server:

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

Follow the MCP install guide, use the standard config above.

Click the button to install:

Or install manually:

Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command npx @tontoko/fast-playwright-mcp@latest. You can also verify config or add command like arguments via clicking Edit.

Follow the MCP install guide, use the standard config above.

Click the button to install:

Or install manually:

Go to Advanced settings -> Extensions -> Add custom extension. Name to your liking, use type STDIO, and set the command to npx @tontoko/fast-playwright-mcp. Click "Add Extension".

Click the button to install:

Or install manually:

Go to Program in the right sidebar -> Install -> Edit mcp.json. Use the standard config above.

Follow the MCP Servers documentation. For example in ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "playwright": {
      "type": "local",
      "command": [
        "npx",
        "@tontoko/fast-playwright-mcp"
      ],
      "enabled": true
    }
  }
}

Open Qodo Gen chat panel in VSCode or IntelliJ → Connect more tools → + Add new MCP → Paste the standard config above.

Click Save.

Click the button to install:

Or install manually:

Follow the MCP install guide, use the standard config above. You can also install the Playwright MCP server using the VS Code CLI:

# For VS Code
code --add-mcp '{"name":"fast-playwright","command":"npx","args":["@tontoko/fast-playwright-mcp@latest"]}'

After installation, the Playwright MCP server will be available for use with your GitHub Copilot agent in VS Code.

Follow Windsurf MCP documentation. Use the standard config above.

NOTE: The Docker implementation only supports headless chromium at the moment.

{
  "mcpServers": {
    "playwright": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "--pull=always", "mcr.microsoft.com/playwright/mcp"]
    }
  }
}

You can build the Docker image yourself.

docker build -t mcr.microsoft.com/playwright/mcp .

• browser_batch_execute
  • Title: Batch Execute Browser Actions
  • Description: Execute multiple browser actions in sequence. PREFER over individual tools for 2+ operations.
  • Parameters:
    • steps (array): Array of steps to execute in sequence. Recommended for form filling (multiple type→click), multi-step navigation, any workflow with 2+ known steps. Saves 90% tokens vs individual calls. Example: [{tool:"browser_navigate",arguments:{url:"https://example.com"}},{tool:"browser_type",arguments:{selectors:[{css:"#user"}],text:"john"}},{tool:"browser_click",arguments:{selectors:[{css:"#btn"}]}}]
    • stopOnFirstError (boolean, optional): Stop entire batch on first error
    • globalExpectation (optional): Default expectation for all steps. Recommended: {includeSnapshot:false,snapshotOptions:{selector:"#app"},diffOptions:{enabled:true}}. Per-step override with steps[].expectation
  • Read-only: false

• browser_click
  • Title: Perform click on web page
  • Description: Perform click on web page
  • Parameters:
    • selectors (array): Array of element selectors (max 5). Selectors are tried in order until one succeeds (fallback mechanism). Multiple matches trigger an error with candidate list. Supports: ref (highest priority), CSS (#id, .class, tag), role (button, textbox, etc.), text content. Example: [{css: "#submit"}, {role: "button", text: "Submit"}] - tries ID first, falls back to role+text
    • doubleClick (boolean, optional): Double-click if true
    • button (string, optional): Mouse button (default: left)
    • expectation (object, optional): Page state capture config. Use batch_execute for multi-clicks
  • Read-only: false

• browser_close
  • Title: Close browser
  • Description: Close the page
  • Parameters: None
  • Read-only: true

• browser_console_messages
  • Title: Get console messages
  • Description: Returns all console messages
  • Parameters:
    • consoleOptions (object, optional): undefined
  • Read-only: true

• browser_diagnose
  • Title: Diagnose page
  • Description: Analyze page complexity and performance characteristics. Reports on: iframe count, DOM size, modal states, element statistics. Use for: debugging slow pages, understanding page structure, or monitoring page complexity.
  • Parameters:
    • searchForElements (object, optional): Search for specific elements and include them in the report
    • includePerformanceMetrics (boolean, optional): Include performance metrics in the report
    • includeAccessibilityInfo (boolean, optional): Include accessibility information
    • includeTroubleshootingSuggestions (boolean, optional): Include troubleshooting suggestions
    • diagnosticLevel (string, optional): Level of diagnostic detail: none (no diagnostics), basic (critical only), standard (default), detailed (with metrics), full (all info)
    • useParallelAnalysis (boolean, optional): Use Phase 2 parallel analysis for improved performance and resource monitoring
    • useUnifiedSystem (boolean, optional): Use Phase 3 unified diagnostic system with enhanced error handling and monitoring
    • configOverrides (object, optional): Runtime configuration overrides for diagnostic system
    • includeSystemStats (boolean, optional): Include unified system statistics and health information
    • expectation (object, optional): undefined
  • Read-only: true

• browser_drag
  • Title: Drag mouse
  • Description: Perform drag and drop between two elements
  • Parameters:
    • startSelectors (array): Source element selectors for drag start
    • endSelectors (array): Target element selectors for drag end
    • expectation (object, optional): Page state after drag. Use batch_execute for workflows
  • Read-only: false

• browser_evaluate
  • Title: Evaluate JavaScript
  • Description: Evaluate JavaScript expression on page or element and return result
  • Parameters:
    • function (string): JS function: () => {...} or (element) => {...}
    • selectors (array, optional): Optional element selectors. If provided, function receives element as parameter
    • expectation (object, optional): Page state config. false for data extraction, true for DOM changes
  • Read-only: false

• browser_file_upload
  • Title: Upload files
  • Description: Upload one or multiple files to file input
  • Parameters:
    • paths (array): Absolute paths to upload (array)
    • expectation (object, optional): Page state config. Use batch_execute for click→upload
  • Read-only: false

• browser_find_elements
  • Title: Find elements
  • Description: Find elements on the page using multiple search criteria such as text, role, tag name, or attributes. Returns matching elements sorted by confidence.
  • Parameters:
    • searchCriteria (object): Search criteria for finding elements
    • maxResults (number, optional): Maximum number of results to return
    • includeDiagnosticInfo (boolean, optional): Include diagnostic information about the page
    • useUnifiedSystem (boolean, optional): Use unified diagnostic system for enhanced error handling
    • enableEnhancedDiscovery (boolean, optional): Enable enhanced element discovery with contextual suggestions
    • performanceThreshold (number, optional): Performance threshold in milliseconds for element discovery
    • expectation (object, optional): undefined
  • Read-only: true

• browser_handle_dialog
  • Title: Handle a dialog
  • Description: Handle a dialog (alert, confirm, prompt)
  • Parameters:
    • accept (boolean): Accept (true) or dismiss (false)
    • promptText (string, optional): Text for prompt dialogs
    • expectation (object, optional): Page state after dialog. Use batch_execute for workflows
  • Read-only: false

• browser_hover
  • Title: Hover mouse
  • Description: Hover over element on page
  • Parameters:
    • selectors (array): Array of element selectors (max 5). Selectors are tried in order until one succeeds (fallback mechanism). Multiple matches trigger an error with candidate list. Supports: ref (highest priority), CSS (#id, .class, tag), role (button, textbox, etc.), text content. Example: [{css: "#submit"}, {role: "button", text: "Submit"}] - tries ID first, falls back to role+text
    • expectation (object, optional): Page state after hover. Use batch_execute for hover→click
  • Read-only: true

• browser_inspect_html
  • Title: HTML inspection
  • Description: Extract and analyze HTML content from web pages with intelligent filtering and size control. Optimized for LLM consumption with configurable depth, format options, and automatic truncation.
  • Parameters:
    • selectors (array): Array of element selectors to inspect
    • depth (number, optional): Maximum hierarchy depth to extract
    • includeStyles (boolean, optional): Include computed CSS styles
    • maxSize (number, optional): Maximum size in bytes (1KB-500KB)
    • format (string, optional): Output format
    • includeAttributes (boolean, optional): Include element attributes
    • preserveWhitespace (boolean, optional): Preserve whitespace in content
    • excludeSelector (string, optional): CSS selector to exclude elements
    • includeSuggestions (boolean, optional): Include CSS selector suggestions in output
    • includeChildren (boolean, optional): Include child elements in extraction
    • optimizeForLLM (boolean, optional): Optimize extracted HTML for LLM consumption
    • expectation (object, optional): Page state config (minimal for HTML inspection)
  • Read-only: true

• browser_navigate
  • Title: Navigate to a URL
  • Description: Navigate to a URL
  • Parameters:
    • url (string): The URL to navigate to
    • expectation (object, optional): Page state after navigation
  • Read-only: false

• browser_navigate_back
  • Title: Go back to previous page
  • Description: Go back to previous page
  • Parameters:
    • expectation (object, optional): Page state after going back
  • Read-only: true

• browser_navigate_forward
  • Title: Go forward to next page
  • Description: Go forward to next page
  • Parameters:
    • expectation (object, optional): Page state after going forward
  • Read-only: true

• browser_network_requests
  • Title: List network requests
  • Description: Returns network requests since loading the page with optional filtering
  • Parameters:
    • urlPatterns (array, optional): URL patterns to filter (supports regex)
    • excludeUrlPatterns (array, optional): URL patterns to exclude (takes precedence)
    • statusRanges (array, optional): Status code ranges (e.g., [{min:200,max:299}])
    • methods (array, optional): HTTP methods to filter
    • maxRequests (number, optional): Max requests to return (default: 20)
    • newestFirst (boolean, optional): Order by timestamp (default: newest first)
  • Read-only: true

• browser_press_key
  • Title: Press a key
  • Description: Press a key on the keyboard
  • Parameters:
    • key (string): Key to press
    • expectation (object, optional): Page state config. Use batch_execute for multiple keys
  • Read-only: false

• browser_resize
  • Title: Resize browser window
  • Description: Resize the browser window
  • Parameters:
    • width (number): Width of the browser window
    • height (number): Height of the browser window
    • expectation (object, optional): undefined
  • Read-only: true

• browser_select_option
  • Title: Select option
  • Description: Select option in dropdown
  • Parameters:
    • selectors (array): Array of element selectors (max 5). Selectors are tried in order until one succeeds (fallback mechanism). Multiple matches trigger an error with candidate list. Supports: ref (highest priority), CSS (#id, .class, tag), role (button, textbox, etc.), text content. Example: [{css: "#submit"}, {role: "button", text: "Submit"}] - tries ID first, falls back to role+text
    • values (array): Values to select (array)
    • expectation (object, optional): Page state after selection. Use batch_execute for forms
  • Read-only: false

• browser_snapshot
  • Title: Page snapshot
  • Description: Capture accessibility snapshot of current page
  • Parameters:
    • expectation (object, optional): Page state config
  • Read-only: true

• browser_take_screenshot
  • Title: Take a screenshot
  • Description: Take a screenshot of current page and return image data
  • Parameters:
    • type (string, optional): Image format for the screenshot. Default is png.
    • filename (string, optional): File name to save the screenshot to. Defaults to page-{timestamp}.{png|jpeg} if not specified.
    • selectors (array, optional): Optional element selectors for element screenshots. If not provided, viewport screenshot will be taken.
    • fullPage (boolean, optional): When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Cannot be used with element screenshots.
    • expectation (object, optional): Additional page state config
  • Read-only: true

• browser_type
  • Title: Type text
  • Description: Type text into editable element
  • Parameters:
    • selectors (array): Array of element selectors (max 5) supporting ref, role, CSS, or text-based selection
    • text (string): Text to type into the element
    • submit (boolean, optional): Press Enter after typing if true
    • slowly (boolean, optional): Type slowly for auto-complete if true
    • expectation (object, optional): Page state config. Use batch_execute for forms
  • Read-only: false

• browser_wait_for
  • Title: Wait for
  • Description: Wait for text to appear or disappear or a specified time to pass
  • Parameters:
    • time (number, optional): Wait time in seconds
    • text (string, optional): undefined
    • textGone (string, optional): undefined
    • expectation (object, optional): Page state after wait
  • Read-only: true

• browser_tab_close
  • Title: Close a tab
  • Description: Close a tab by index or close current tab
  • Parameters:
    • index (number, optional): Tab index to close (omit for current)
    • expectation (object, optional): Page state after close
  • Read-only: false

• browser_tab_list
  • Title: List tabs
  • Description: List browser tabs with titles and URLs
  • Parameters:
    • expectation (object, optional): Page state config
  • Read-only: true

• browser_tab_new
  • Title: Open a new tab
  • Description: Open a new tab
  • Parameters:
    • url (string, optional): URL for new tab (optional)
    • expectation (object, optional): Page state of new tab
  • Read-only: true

• browser_tab_select
  • Title: Select a tab
  • Description: Select a tab by index
  • Parameters:
    • index (number): The index of the tab to select
    • expectation (object, optional): Page state after tab switch
  • Read-only: true

• browser_install
  • Title: Install the browser specified in the config
  • Description: Install the browser specified in the config. Call this if you get an error about the browser not being installed.
  • Parameters: None
  • Read-only: false

• browser_mouse_click_xy
  • Title: Click
  • Description: Click at specific coordinates
  • Parameters:
    • element (string): undefined
    • x (number): X coordinate (requires --caps=vision)
    • y (number): Y coordinate (requires --caps=vision)
    • expectation (object, optional): Page state after click. Prefer element ref over coords
  • Read-only: false

• browser_mouse_drag_xy
  • Title: Drag mouse
  • Description: Drag from one coordinate to another
  • Parameters:
    • element (string): undefined
    • startX (number): Start X (requires --caps=vision)
    • startY (number): Start Y (requires --caps=vision)
    • endX (number): End X
    • endY (number): End Y
    • expectation (object, optional): Page state after drag. Prefer element refs over coords
  • Read-only: false

• browser_mouse_move_xy
  • Title: Move mouse
  • Description: Move mouse to specific coordinates.Requires --caps=vision.x,y:coordinates.expectation:{includeSnapshot:false} for simple move,true to see hover effects.PREFER element-based interactions over coordinates when possible.
  • Parameters:
    • element (string): undefined
    • x (number): X coordinate
    • y (number): Y coordinate
    • expectation (object, optional): undefined
  • Read-only: true

• browser_pdf_save
  • Title: Save as PDF
  • Description: Save page as PDF
  • Parameters:
    • filename (string, optional): File name to save the pdf to. Defaults to page-{timestamp}.pdf if not specified.
  • Read-only: true