# io.github.microsoft/playwright-mcp (npm · @playwright/mcp)

Playwright Tools for MCP

- Trust score: 78/100 (medium)
- Change this week: −13
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@playwright/mcp`: 78/100 (this document), [markdown](https://verifymcp.io/servers/microsoft-playwright-mcp/playwright-mcp.md), [page](https://verifymcp.io/servers/microsoft-playwright-mcp/playwright-mcp)

## Channel facts

- Registry: `npm`
- Package: `@playwright/mcp`
- Version: `0.0.78`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 1 of 3 dependencies flagged as unhealthy (1 deprecated).
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to microsoft/playwright-mcp).
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 70/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 2034 tokens (~84/item across 24 items; 24 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add microsoft-playwright-mcp -- npx -y @playwright/mcp
```

### Codex

```bash
codex mcp add microsoft-playwright-mcp -- npx -y @playwright/mcp
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add microsoft-playwright-mcp --command npx --arg -y --arg @playwright/mcp
```

### Hermes

```yaml
mcp_servers:
  microsoft-playwright-mcp:
    command: "npx"
    args: ["-y", "@playwright/mcp"]
```

### Other

```json
{
  "mcpServers": {
    "microsoft-playwright-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@playwright/mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 78, +15)

- [security improvement] Malware scan: unverified → pass
- [functional regression] Dependency health: 0.90 → 0.80

### 2026-07-31 (score 63, −10)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 73, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 91, +32)

- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: pass
- [functional] First check of Schema quality: good
- [functional] First check of Tool coverage: 100

### 2026-07-26 (score 59)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (24)

### `browser_close` (~12 tokens)

Close the page

### `browser_resize` (~37 tokens)

Resize the browser window

Input parameters:

- `height` (number, required): Height of the browser window
- `width` (number, required): Width of the browser window

### `browser_console_messages` (~95 tokens)

Returns all console messages

Input parameters:

- `all` (boolean): Return all console messages since the beginning of the session, not just since the last navigation. Defaults to false.
- `filename` (string): Filename to save the console messages to. If not provided, messages are returned as text.
- `level` (string, required): Level of the console messages to return. Each level includes the messages of more severe levels. Defaults to "info".

### `browser_handle_dialog` (~44 tokens)

Handle a dialog

Input parameters:

- `accept` (boolean, required): Whether to accept the dialog.
- `promptText` (string): The text of the prompt in case of a prompt dialog.

### `browser_evaluate` (~110 tokens)

Evaluate JavaScript expression on page or element

Input parameters:

- `element` (string): Human-readable element description used to obtain permission to interact with the element
- `filename` (string): Filename to save the result to. If not provided, result is returned as text.
- `function` (string, required): () => { /* code */ } or (element) => { /* code */ } when element is provided
- `target` (string): Exact target element reference from the page snapshot, or a unique element selector

### `browser_file_upload` (~46 tokens)

Upload one or multiple files

Input parameters:

- `paths` (array): The absolute paths to the files to upload. Can be single file or multiple files. If omitted, file chooser is cancelled.

### `browser_drop` (~142 tokens)

Drop files or MIME-typed data onto an element, as if dragged from outside the page. At least one of "paths" or "data" must be provided.

Input parameters:

- `data` (object): Data to drop, as a map of MIME type to string value (e.g. {"text/plain": "hello", "text/uri-list": "https://example.com"}).
- `element` (string): Human-readable element description used to obtain permission to interact with the element
- `paths` (array): Absolute paths to files to drop onto the element.
- `target` (string, required): Exact target element reference from the page snapshot, or a unique element selector

### `browser_find` (~156 tokens)

Search the accessibility snapshot of the current page for text or a regular expression. Returns matching snapshot nodes with a few lines of surrounding context (like search snippets), each shown under its path from the root of the tree, which is cheaper than capturing the whole snapshot when you only need to locate an element and its ref.

Input parameters:

- `regex` (string): Regular expression to search for in the page snapshot. Matching is case-sensitive by default; wrap the pattern in slashes to add flags, e.g. "/error/i" for case-insensitive. Provide either text or re…
- `text` (string): Plain text to search for in the page snapshot (case-insensitive substring match). Provide either text or regex, not both.

### `browser_fill_form` (~25 tokens)

Fill multiple form fields

Input parameters:

- `fields` (array, required): Fields to fill in

### `browser_press_key` (~44 tokens)

Press a key on the keyboard

Input parameters:

- `key` (string, required): Name of the key to press or a character to generate, such as `ArrowLeft` or `a`

### `browser_type` (~118 tokens)

Type text into editable element

Input parameters:

- `element` (string): Human-readable element description used to obtain permission to interact with the element
- `slowly` (boolean): Whether to type one character at a time. Useful for triggering key handlers in the page. By default entire text is filled in at once.
- `submit` (boolean): Whether to submit entered text (press Enter after)
- `target` (string, required): Exact target element reference from the page snapshot, or a unique element selector
- `text` (string, required): Text to type into the element

### `browser_navigate` (~26 tokens)

Navigate to a URL

Input parameters:

- `url` (string, required): The URL to navigate to

### `browser_navigate_back` (~20 tokens)

Go back to the previous page in the history

### `browser_network_requests` (~106 tokens)

Returns a numbered list of network requests since loading the page. Use browser_network_request with the number to get full details.

Input parameters:

- `filename` (string): Filename to save the network requests to. If not provided, requests are returned as text.
- `filter` (string): Only return requests whose URL matches this regexp (e.g. "/api/.*user").
- `static` (boolean, required): Whether to include successful static resources like images, fonts, scripts, etc. Defaults to false.

### `browser_network_request` (~107 tokens)

Returns full details (headers and body) of a single network request, or a single part if `part` is set. Use the number from browser_network_requests.

Input parameters:

- `filename` (string): Filename to save the result to. If not provided, output is returned as text.
- `index` (integer, required): 1-based index of the request, as printed by browser_network_requests.
- `part` (string): Return only this part of the request. Omit to return full details.

### `browser_run_code_unsafe` (~134 tokens)

Run a Playwright code snippet. Unsafe: executes arbitrary JavaScript in the Playwright server process and is RCE-equivalent.

Input parameters:

- `code` (string): A JavaScript function containing Playwright code to execute. It will be invoked with a single argument, page, which you can use for any page interaction. For example: `async (page) => { await page.ge…
- `filename` (string): Load code from the specified file. If both code and filename are provided, code will be ignored.

### `browser_take_screenshot` (~218 tokens)

Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.

Input parameters:

- `element` (string): Human-readable element description used to obtain permission to interact with the element
- `filename` (string): File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified. Prefer relative file names to stay within the output directory.
- `fullPage` (boolean): When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Cannot be used with element screenshots.
- `scale` (string, required): Image resolution scale. "css" produces a screenshot sized in CSS pixels (smaller, consistent across devices). "device" produces a high-resolution screenshot using device pixels (larger, accounts for…
- `target` (string): Exact target element reference from the page snapshot, or a unique element selector
- `type` (string, required): Image format for the screenshot. Default is png.

### `browser_snapshot` (~115 tokens)

Capture accessibility snapshot of the current page, this is better than screenshot

Input parameters:

- `boxes` (boolean): Include each element's bounding box as [box=x,y,width,height] in the snapshot. Coordinates are viewport-relative, in CSS pixels (Element.getBoundingClientRect)
- `depth` (number): Limit the depth of the snapshot tree
- `filename` (string): Save snapshot to markdown file instead of returning it in the response.
- `target` (string): Exact target element reference from the page snapshot, or a unique element selector

### `browser_click` (~100 tokens)

Perform click on a web page

Input parameters:

- `button` (string): Button to click, defaults to left
- `doubleClick` (boolean): Whether to perform a double click instead of a single click
- `element` (string): Human-readable element description used to obtain permission to interact with the element
- `modifiers` (array): Modifier keys to press
- `target` (string, required): Exact target element reference from the page snapshot, or a unique element selector

### `browser_drag` (~106 tokens)

Perform drag and drop between two elements

Input parameters:

- `endElement` (string): Human-readable target element description used to obtain the permission to interact with the element
- `endTarget` (string, required): Exact target element reference from the page snapshot, or a unique element selector
- `startElement` (string): Human-readable source element description used to obtain the permission to interact with the element
- `startTarget` (string, required): Exact target element reference from the page snapshot, or a unique element selector

### `browser_hover` (~55 tokens)

Hover over element on page

Input parameters:

- `element` (string): Human-readable element description used to obtain permission to interact with the element
- `target` (string, required): Exact target element reference from the page snapshot, or a unique element selector

### `browser_select_option` (~82 tokens)

Select an option in a dropdown

Input parameters:

- `element` (string): Human-readable element description used to obtain permission to interact with the element
- `target` (string, required): Exact target element reference from the page snapshot, or a unique element selector
- `values` (array, required): Array of values to select in the dropdown. This can be a single value or multiple values.

### `browser_tabs` (~73 tokens)

List, create, close, or select a browser tab.

Input parameters:

- `action` (string, required): Operation to perform
- `index` (number): Tab index, used for close/select. If omitted for close, current tab is closed.
- `url` (string): URL to navigate to in the new tab, used for new.

### `browser_wait_for` (~63 tokens)

Wait for text to appear or disappear or a specified time to pass

Input parameters:

- `text` (string): The text to wait for
- `textGone` (string): The text to wait for to disappear
- `time` (number): The time to wait in seconds

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/microsoft-playwright-mcp/playwright-mcp#diagnostics

## Score history

- 2026-08-03: 78
- 2026-08-02: 78
- 2026-08-01: 63
- 2026-07-31: 63
- 2026-07-30: 73
- 2026-07-28: 91
- 2026-07-27: 91
- 2026-07-26: 59

## Links

- npm package: https://www.npmjs.com/package/@playwright/mcp
- Socket report: https://socket.dev/npm/package/@playwright/mcp
- Repository: https://github.com/microsoft/playwright-mcp
- Changelog RSS feed: https://verifymcp.io/servers/microsoft-playwright-mcp/playwright-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/microsoft-playwright-mcp/playwright-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/microsoft-playwright-mcp/playwright-mcp