Skip to main content

🛠️ Supported Tools

Playwright MCP for Browser automation has following key features

  • Console log monitoring
  • Code Generation
  • Web Scraping
  • Screenshot capabilities
  • JavaScript execution
  • Basic web interaction (navigation, clicking, form filling, drop down select and hover)
  • Content retrieval (visible text and HTML)
Note

Playwright UI automation is supported for very limited feature sets, more features will be added in upcoming days. Please feel free to fork the repo and add the feature and raise PR, will can build the library together!

Code Generation Tools​

These tools allow you to record and generate reusable Playwright test scripts.

start_codegen_session​

Start a new code generation session to record Playwright actions.

  • Inputs:

    • options (object, required):
      Code generation options:
      • outputPath (string, required):
        Directory path where generated tests will be saved (use absolute path).
      • testNamePrefix (string, optional):
        Prefix to use for generated test names (default: 'GeneratedTest').
      • includeComments (boolean, optional):
        Whether to include descriptive comments in generated tests.

  • Response:

    • Session ID for the newly created code generation session.

end_codegen_session​

End a code generation session and generate the test file.

  • Inputs:

    • sessionId (string, required):
      ID of the session to end.

  • Response:

    • Information about the generated test file.

get_codegen_session​

Get information about a code generation session.

  • Inputs:

    • sessionId (string, required):
      ID of the session to retrieve.

  • Response:

    • Session information including recorded actions and status.

clear_codegen_session​

Clear a code generation session without generating a test.

  • Inputs:

    • sessionId (string, required):
      ID of the session to clear.

  • Response:

    • Confirmation that the session was cleared.

Browser Automation Tools​

Playwright_navigate​

Navigate to a URL in the browser with configurable viewport and browser settings

  • url (string, required):
    URL of the application under test.

  • browserType (string, optional, default: "chromium"):
    Browser engine to use. Supported values: "chromium", "firefox", "webkit".

  • width (number, optional, default: 1280):
    Viewport width in pixels.

  • height (number, optional, default: 720):
    Viewport height in pixels.

  • timeout (number, optional):
    Navigation timeout in milliseconds.

  • waitUntil (string, optional):
    Navigation wait condition.

  • headless (boolean, optional, default: false):
    Run browser in headless mode.

Playwright_screenshot​

Capture screenshots of the entire page or specific elements

  • name (string, required):
    Name for the screenshot.

  • selector (string, optional):
    CSS selector for the element to screenshot.

  • width (number, optional, default: 800):
    Screenshot width.

  • height (number, optional, default: 600):
    Screenshot height.

  • storeBase64 (boolean, optional, default: false):
    Store the screenshot as a base64 string.

  • fullPage (boolean, optional, default: false): Capture a screenshot of the full page.

  • savePng (boolean, optional, default: false): Save the screenshot as a PNG file.

  • downloadsDir (string, optional): Directory to save the screenshot.

Playwright_click​

Click elements on the page.

  • selector (string):
    CSS selector for the element to click.

Playwright_iframe_click​

Click elements in an iframe on the page.

  • iframeSelector (string):
    CSS selector for the iframe containing the element to click.

  • selector (string):
    CSS selector for the element to click.

Playwright_hover​

Hover over elements on the page.

  • selector (string):
    CSS selector for the element to hover.

Playwright_fill​

Fill out input fields.

  • selector (string):
    CSS selector for the input field.
  • value (string):
    Value to fill.

Playwright_select​

Select an element with the SELECT tag.

  • selector (string):
    CSS selector for the element to select.
  • value (string):
    Value to select.

Playwright_evaluate​

Execute JavaScript in the browser console.

  • script (string):
    JavaScript code to execute.

Playwright_console_logs​

Retrieve console logs from the browser with filtering options Supports Retrieval of logs like - all, error, warning, log, info, debug

  • search (string):
    Text to search for in logs (handles text with square brackets).

  • limit (number): Maximum number of logs to retrieve.

  • type (string): Type of logs to retrieve (all, error, warning, log, info, debug).

  • clear (boolean): Whether to clear logs after retrieval (default: false).

Playwright_close​

Close the browser and release all resources. Useful while working with Cline, Cursor to release the resources.

Playwright_expect_response​

Ask Playwright to start waiting for a HTTP response. This tool initiates the wait operation but does not wait for its completion.

  • Inputs:
    • id (string):
      Unique & arbitrary identifier to be used for retrieving this response later with Playwright_assert_response.
    • url (string):
      URL pattern to match in the response.

Playwright_assert_response​

Wait for and validate a previously initiated HTTP response wait operation.

  • Inputs:

    • id (string):
      Identifier of the HTTP response initially expected using Playwright_expect_response.
    • value (string, optional):
      Data to expect in the body of the HTTP response. If provided, the assertion will fail if this value is not found in the response body.

  • Response:

    • statusCode (string):
      Status code of the response.
    • responseUrl (string):
      Full URL of the captured response.
    • responseBody (string):
      Full response body in JSON format.

playwright_custom_user_agent​

Set a custom User Agent for the browser.

  • Inputs:
    • userAgent (string):
      Custom User Agent for the Playwright browser instance

playwright_get_visible_text​

Get the visible text content of the current page.

  • Response:
    • content (string):
      The visible text content of the current page, extracted from visible DOM elements. Hidden elements (with display:none or visibility:hidden) are excluded.

playwright_get_visible_html​

Get the HTML content of the current page.

  • Response:
    • content (string):
      The complete HTML content of the current page.

playwright_go_back​

Navigate back in browser history.

  • Response:
    • Confirmation message that the browser has navigated back in its history.

playwright_go_forward​

Navigate forward in browser history.

  • Response:
    • Confirmation message that the browser has navigated forward in its history.

playwright_drag​

Drag an element to a target location.

  • Inputs:

    • sourceSelector (string):
      CSS selector for the element to drag.
    • targetSelector (string):
      CSS selector for the target location.

  • Response:

    • Confirmation message that the drag operation has been performed.

playwright_press_key​

Press a keyboard key.

  • Inputs:

    • key (string):
      Key to press (e.g. 'Enter', 'ArrowDown', 'a').
    • selector (string, optional):
      CSS selector for an element to focus before pressing the key.

  • Response:

    • Confirmation message indicating which key was pressed.

playwright_save_as_pdf​

Save the current page as a PDF file.

  • Inputs:

    • outputPath (string):
      Directory path where the PDF will be saved.
    • filename (string, optional, default: "page.pdf"):
      Name of the PDF file.
    • format (string, optional, default: "A4"):
      Page format (e.g. 'A4', 'Letter').
    • printBackground (boolean, optional, default: true):
      Whether to print background graphics.
    • margin (object, optional):
      Page margins with the following properties:
      • top (string): Top margin (e.g. '1cm').
      • right (string): Right margin (e.g. '1cm').
      • bottom (string): Bottom margin (e.g. '1cm').
      • left (string): Left margin (e.g. '1cm').

  • Response:

    • Path to the saved PDF file.