@playwright/mcp 0.0.70 → 0.0.71-alpha-2026-04-28

package/README.md

@@ -18,7 +18,7 @@ This package provides MCP interface into Playwright. If you are using a **coding
 
 ### Requirements
 - Node.js 18 or newer
-- VS Code, Cursor, Windsurf, Claude Desktop, Goose or any other MCP client
+- VS Code, Cursor, Windsurf, Claude Desktop, Goose, Junie or any other MCP client
 
 <!--
 // Generate using:
@@ -237,6 +237,35 @@ Follow the MCP install [guide](https://github.com/google-gemini/gemini-cli/blob/
 Go to `Advanced settings` -> `Extensions` -> `Add custom extension`. Name to your liking, use type `STDIO`, and set the `command` to `npx @playwright/mcp`. Click "Add Extension".
 </details>
 
+<details>
+<summary>Junie</summary>
+
+To add the Playwright MCP server in Junie CLI:
+
+1. Type `/mcp`
+2. Press `Ctrl+A` to add a new MCP server
+3. Select **Playwright** from the list
+
+Alternatively, add to `.junie/mcp/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "Playwright": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@playwright/mcp@latest"
+      ]
+    }
+  }
+}
+```
+
+For more information, see the [Junie MCP configuration documentation](https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html).
+
+</details>
+
 <details>
 <summary>Kiro</summary>
 
@@ -371,7 +400,7 @@ Playwright MCP server supports following arguments. They can be provided in the
 | --console-level <level> | level of console messages to return: "error", "warning", "info", "debug". Each level includes the messages of more severe levels.<br>*env* `PLAYWRIGHT_MCP_CONSOLE_LEVEL` |
 | --device <device> | device to emulate, for example: "iPhone 15"<br>*env* `PLAYWRIGHT_MCP_DEVICE` |
 | --executable-path <path> | path to the browser executable.<br>*env* `PLAYWRIGHT_MCP_EXECUTABLE_PATH` |
-| --extension | Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.<br>*env* `PLAYWRIGHT_MCP_EXTENSION` |
+| --extension | Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright Extension" to be installed.<br>*env* `PLAYWRIGHT_MCP_EXTENSION` |
 | --endpoint <endpoint> | Bound browser endpoint to connect to.<br>*env* `PLAYWRIGHT_MCP_ENDPOINT` |
 | --grant-permissions <permissions...> | List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".<br>*env* `PLAYWRIGHT_MCP_GRANT_PERMISSIONS` |
 | --headless | run browser in headless mode, headed by default<br>*env* `PLAYWRIGHT_MCP_HEADLESS` |
@@ -413,15 +442,17 @@ Persistent profile is located at the following locations and you can override it
 
 ```bash
 # Windows
-%USERPROFILE%\AppData\Local\ms-playwright\mcp-{channel}-profile
+%USERPROFILE%\AppData\Local\ms-playwright\mcp-{channel}-{workspace-hash}
 
 # macOS
-- ~/Library/Caches/ms-playwright/mcp-{channel}-profile
+- ~/Library/Caches/ms-playwright/mcp-{channel}-{workspace-hash}
 
 # Linux
-- ~/.cache/ms-playwright/mcp-{channel}-profile
+- ~/.cache/ms-playwright/mcp-{channel}-{workspace-hash}
 ```
 
+`{workspace-hash}` is derived from the MCP client's workspace root, so different projects get separate profiles automatically.
+
 **Isolated**
 
 In the isolated mode, each session is started in the isolated profile. Every time you ask MCP to close the browser,
@@ -446,7 +477,7 @@ state [here](https://playwright.dev/docs/auth).
 
 **Browser Extension**
 
-The Playwright MCP Chrome Extension allows you to connect to existing browser tabs and leverage your logged-in sessions and browser state. See [packages/extension/README.md](packages/extension/README.md) for installation and setup instructions.
+The Playwright MCP Chrome Extension allows you to connect to existing browser tabs and leverage your logged-in sessions and browser state. See [microsoft/playwright › packages/extension](https://github.com/microsoft/playwright/tree/main/packages/extension#readme) for installation and setup instructions.
 
 ### Initial state
 
@@ -563,7 +594,7 @@ npx @playwright/mcp@latest --config path/to/config.json
   /**
    * Connect to a running browser instance (Edge/Chrome only). If specified, `browser`
    * config is ignored.
-   * Requires the "Playwright MCP Bridge" browser extension to be installed.
+   * Requires the "Playwright Extension" to be installed.
    */
   extension?: boolean;
 
@@ -793,8 +824,7 @@ http.createServer(async (req, res) => {
   - Description: Perform click on a web page
   - Parameters:
     - `element` (string, optional): Human-readable element description used to obtain permission to interact with the element
-    - `ref` (string): Exact target element reference from the page snapshot
-    - `selector` (string, optional): CSS or role selector for the target element, when "ref" is not available
+    - `target` (string): Exact target element reference from the page snapshot, or a unique element selector
     - `doubleClick` (boolean, optional): Whether to perform a double click instead of a single click
     - `button` (string, optional): Button to click, defaults to left
     - `modifiers` (array, optional): Modifier keys to press
@@ -825,12 +855,22 @@ http.createServer(async (req, res) => {
   - Title: Drag mouse
   - Description: Perform drag and drop between two elements
   - Parameters:
-    - `startElement` (string): Human-readable source element description used to obtain the permission to interact with the element
-    - `startRef` (string): Exact source element reference from the page snapshot
-    - `startSelector` (string, optional): CSS or role selector for the source element, when ref is not available
-    - `endElement` (string): Human-readable target element description used to obtain the permission to interact with the element
-    - `endRef` (string): Exact target element reference from the page snapshot
-    - `endSelector` (string, optional): CSS or role selector for the target element, when ref is not available
+    - `startElement` (string, optional): Human-readable source element description used to obtain the permission to interact with the element
+    - `startTarget` (string): Exact target element reference from the page snapshot, or a unique element selector
+    - `endElement` (string, optional): Human-readable target element description used to obtain the permission to interact with the element
+    - `endTarget` (string): Exact target element reference from the page snapshot, or a unique element selector
+  - Read-only: **false**
+
+<!-- NOTE: This has been generated via update-readme.js -->
+
+- **browser_drop**
+  - Title: Drop files or data onto an element
+  - Description: 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.
+  - Parameters:
+    - `element` (string, optional): Human-readable element description used to obtain permission to interact with the element
+    - `target` (string): Exact target element reference from the page snapshot, or a unique element selector
+    - `paths` (array, optional): Absolute paths to files to drop onto the element.
+    - `data` (object, optional): Data to drop, as a map of MIME type to string value (e.g. {"text/plain": "hello", "text/uri-list": "https://example.com"}).
   - Read-only: **false**
 
 <!-- NOTE: This has been generated via update-readme.js -->
@@ -839,10 +879,9 @@ http.createServer(async (req, res) => {
   - Title: Evaluate JavaScript
   - Description: Evaluate JavaScript expression on page or element
   - Parameters:
-    - `function` (string): () => { /* code */ } or (element) => { /* code */ } when element is provided
     - `element` (string, optional): Human-readable element description used to obtain permission to interact with the element
-    - `ref` (string, optional): Exact target element reference from the page snapshot
-    - `selector` (string, optional): CSS or role selector for the target element, when "ref" is not available.
+    - `target` (string, optional): Exact target element reference from the page snapshot, or a unique element selector
+    - `function` (string): () => { /* code */ } or (element) => { /* code */ } when element is provided
     - `filename` (string, optional): Filename to save the result to. If not provided, result is returned as text.
   - Read-only: **false**
 
@@ -881,8 +920,7 @@ http.createServer(async (req, res) => {
   - Description: Hover over element on page
   - Parameters:
     - `element` (string, optional): Human-readable element description used to obtain permission to interact with the element
-    - `ref` (string): Exact target element reference from the page snapshot
-    - `selector` (string, optional): CSS or role selector for the target element, when "ref" is not available
+    - `target` (string): Exact target element reference from the page snapshot, or a unique element selector
   - Read-only: **false**
 
 <!-- NOTE: This has been generated via update-readme.js -->
@@ -951,8 +989,7 @@ http.createServer(async (req, res) => {
   - Description: Select an option in a dropdown
   - Parameters:
     - `element` (string, optional): Human-readable element description used to obtain permission to interact with the element
-    - `ref` (string): Exact target element reference from the page snapshot
-    - `selector` (string, optional): CSS or role selector for the target element, when "ref" is not available
+    - `target` (string): Exact target element reference from the page snapshot, or a unique element selector
     - `values` (array): Array of values to select in the dropdown. This can be a single value or multiple values.
   - Read-only: **false**
 
@@ -962,9 +999,10 @@ http.createServer(async (req, res) => {
   - Title: Page snapshot
   - Description: Capture accessibility snapshot of the current page, this is better than screenshot
   - Parameters:
+    - `target` (string, optional): Exact target element reference from the page snapshot, or a unique element selector
     - `filename` (string, optional): Save snapshot to markdown file instead of returning it in the response.
-    - `selector` (string, optional): Element selector of the root element to capture a partial snapshot instead of the whole page
     - `depth` (number, optional): Limit the depth of the snapshot tree
+    - `boxes` (boolean, optional): Include each element's bounding box as [box=x,y,width,height] in the snapshot
   - Read-only: **true**
 
 <!-- NOTE: This has been generated via update-readme.js -->
@@ -973,11 +1011,10 @@ http.createServer(async (req, res) => {
   - Title: Take a screenshot
   - Description: Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.
   - Parameters:
+    - `element` (string, optional): Human-readable element description used to obtain permission to interact with the element
+    - `target` (string, optional): Exact target element reference from the page snapshot, or a unique element selector
     - `type` (string): 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. Prefer relative file names to stay within the output directory.
-    - `element` (string, optional): Human-readable element description used to obtain permission to screenshot the element. If not provided, the screenshot will be taken of viewport. If element is provided, ref must be provided too.
-    - `ref` (string, optional): Exact target element reference from the page snapshot. If not provided, the screenshot will be taken of viewport. If ref is provided, element must be provided too.
-    - `selector` (string, optional): CSS or role selector for the target element, when "ref" is not available.
     - `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.
   - Read-only: **true**
 
@@ -988,8 +1025,7 @@ http.createServer(async (req, res) => {
   - Description: Type text into editable element
   - Parameters:
     - `element` (string, optional): Human-readable element description used to obtain permission to interact with the element
-    - `ref` (string): Exact target element reference from the page snapshot
-    - `selector` (string, optional): CSS or role selector for the target element, when "ref" is not available
+    - `target` (string): Exact target element reference from the page snapshot, or a unique element selector
     - `text` (string): Text to type into the element
     - `submit` (boolean, optional): Whether to submit entered text (press Enter after)
     - `slowly` (boolean, optional): 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.
@@ -1019,6 +1055,7 @@ http.createServer(async (req, res) => {
   - Parameters:
     - `action` (string): Operation to perform
     - `index` (number, optional): Tab index, used for close/select. If omitted for close, current tab is closed.
+    - `url` (string, optional): URL to navigate to in the new tab, used for new.
   - Read-only: **false**
 
 </details>
@@ -1254,6 +1291,27 @@ http.createServer(async (req, res) => {
 
 <!-- NOTE: This has been generated via update-readme.js -->
 
+- **browser_hide_highlight**
+  - Title: Hide element highlight
+  - Description: Remove a highlight overlay previously added for the element.
+  - Parameters:
+    - `element` (string, optional): Human-readable element description used when adding the highlight; must match the value passed to browser_highlight.
+    - `target` (string, optional): Exact target element reference from the page snapshot, or a unique element selector
+  - Read-only: **true**
+
+<!-- NOTE: This has been generated via update-readme.js -->
+
+- **browser_highlight**
+  - Title: Highlight element
+  - Description: Show a persistent highlight overlay around the element on the page.
+  - Parameters:
+    - `element` (string, optional): Human-readable element description used to obtain permission to interact with the element
+    - `target` (string): Exact target element reference from the page snapshot, or a unique element selector
+    - `style` (string, optional): Additional inline CSS applied to the highlight overlay, e.g. "outline: 2px dashed red".
+  - Read-only: **true**
+
+<!-- NOTE: This has been generated via update-readme.js -->
+
 - **browser_resume**
   - Title: Resume paused script execution
   - Description: Resume script execution after it was paused. When called with step set to true, execution will pause again before the next action.
@@ -1401,8 +1459,7 @@ http.createServer(async (req, res) => {
   - Description: Generate locator for the given element to use in tests
   - Parameters:
     - `element` (string, optional): Human-readable element description used to obtain permission to interact with the element
-    - `ref` (string): Exact target element reference from the page snapshot
-    - `selector` (string, optional): CSS or role selector for the target element, when "ref" is not available
+    - `target` (string): Exact target element reference from the page snapshot, or a unique element selector
   - Read-only: **true**
 
 <!-- NOTE: This has been generated via update-readme.js -->
@@ -1422,8 +1479,7 @@ http.createServer(async (req, res) => {
   - Description: Verify list is visible on the page
   - Parameters:
     - `element` (string): Human-readable list description
-    - `ref` (string): Exact target element reference that points to the list
-    - `selector` (string, optional): CSS or role selector for the target list, when "ref" is not available.
+    - `target` (string): Exact target element reference that points to the list
     - `items` (array): Items to verify
   - Read-only: **false**
 
@@ -1444,8 +1500,7 @@ http.createServer(async (req, res) => {
   - Parameters:
     - `type` (string): Type of the element
     - `element` (string): Human-readable element description
-    - `ref` (string): Exact target element reference from the page snapshot
-    - `selector` (string, optional): CSS or role selector for the target element, when "ref" is not available
+    - `target` (string): Exact target element reference from the page snapshot
     - `value` (string): Value to verify. For checkbox, use "true" or "false".
   - Read-only: **false**
 

package/cli.js

@@ -16,17 +16,17 @@
  */
 
 const { program } = require('playwright-core/lib/utilsBundle');
-const { decorateMCPCommand } = require('playwright-core/lib/tools/mcp/program');
+const { tools, libCli } = require('playwright-core/lib/coreBundle');
 
 if (process.argv.includes('install-browser')) {
   const argv = process.argv.map(arg => arg === 'install-browser' ? 'install' : arg);
-  const { program: mainProgram } = require('playwright-core/lib/cli/program');
-  mainProgram.parse(argv);
+  libCli.decorateProgram(program);
+  void program.parseAsync(argv);
   return;
 }
 
 const packageJSON = require('./package.json');
 const p = program.version('Version ' + packageJSON.version).name('Playwright MCP');
-decorateMCPCommand(p, packageJSON.version)
+tools.decorateMCPCommand(p, packageJSON.version);
 
 void program.parseAsync(process.argv);

package/config.d.ts

@@ -101,7 +101,7 @@ export type Config = {
   /**
    * Connect to a running browser instance (Edge/Chrome only). If specified, `browser`
    * config is ignored.
-   * Requires the "Playwright MCP Bridge" browser extension to be installed.
+   * Requires the "Playwright Extension" to be installed.
    */
   extension?: boolean;
 

package/index.js

@@ -15,5 +15,5 @@
  * limitations under the License.
  */
 
-const { createConnection } = require('playwright-core/lib/tools/exports');
-module.exports = { createConnection };
+const { tools } = require('playwright-core/lib/coreBundle');
+module.exports = { createConnection: tools.createConnection };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playwright/mcp",
-  "version": "0.0.70",
+  "version": "0.0.71-alpha-2026-04-28",
   "description": "Playwright Tools for MCP",
   "repository": {
     "type": "git",
@@ -23,7 +23,11 @@
     "wtest": "playwright test --project=webkit",
     "dtest": "MCP_IN_DOCKER=1 playwright test --project=chromium-docker",
     "build": "echo OK",
-    "npm-publish": "npm run lint && npm run test && npm publish"
+    "npm-publish": "npm run lint && npm run test && npm publish",
+    "docker-build": "docker build --no-cache -t playwright-mcp-dev:latest .",
+    "docker-rm": "docker rm playwright-mcp-dev",
+    "docker-run": "docker run -it -p 8080:8080 --name playwright-mcp-dev playwright-mcp-dev:latest",
+    "roll": "node roll.js"
   },
   "exports": {
     "./package.json": "./package.json",
@@ -33,8 +37,13 @@
     }
   },
   "dependencies": {
-    "playwright": "1.60.0-alpha-1774999321000",
-    "playwright-core": "1.60.0-alpha-1774999321000"
+    "playwright": "1.60.0-alpha-2026-04-27",
+    "playwright-core": "1.60.0-alpha-2026-04-27"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@playwright/test": "1.60.0-alpha-2026-04-27",
+    "@types/node": "^24.3.0"
   },
   "bin": {
     "playwright-mcp": "cli.js"