playwright 1.56.0-alpha-2025-09-03 → 1.56.0-alpha-2025-09-04

package/lib/mcp/log.js

@@ -0,0 +1,35 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var log_exports = {};
+__export(log_exports, {
+  logUnhandledError: () => logUnhandledError,
+  testDebug: () => testDebug
+});
+module.exports = __toCommonJS(log_exports);
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+const errorsDebug = (0, import_utilsBundle.debug)("pw:mcp:errors");
+function logUnhandledError(error) {
+  errorsDebug(error);
+}
+const testDebug = (0, import_utilsBundle.debug)("pw:mcp:test");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  logUnhandledError,
+  testDebug
+});

package/lib/mcp/program.js

@@ -0,0 +1,96 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var mcpServer = __toESM(require("./sdk/server"));
+var import_config = require("./browser/config");
+var import_context = require("./browser/context");
+var import_browserContextFactory = require("./browser/browserContextFactory");
+var import_proxyBackend = require("./sdk/proxyBackend");
+var import_browserServerBackend = require("./browser/browserServerBackend");
+var import_extensionContextFactory = require("./extension/extensionContextFactory");
+const packageJSON = require("../../package.json");
+import_utilsBundle.program.version("Version " + packageJSON.version).name("Playwright MCP").option("--allowed-origins <origins>", "semicolon-separated list of origins to allow the browser to request. Default is to allow all.", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--config <path>", "path to the configuration file.").option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".').option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--user-agent <ua string>", "specify user agent string").option("--user-data-dir <path>", "path to the user data directory. If not specified, a temporary directory will be created.").option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280, 720"').addOption(new import_utilsBundle.ProgramOption("--connect-tool", "Allow to switch between different browser connection methods.").hideHelp()).addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
+  setupExitWatchdog();
+  if (options.vision) {
+    console.error("The --vision option is deprecated, use --caps=vision instead");
+    options.caps = "vision";
+  }
+  const config = await (0, import_config.resolveCLIConfig)(options);
+  const browserContextFactory = (0, import_browserContextFactory.contextFactory)(config);
+  const extensionContextFactory = new import_extensionContextFactory.ExtensionContextFactory(config.browser.launchOptions.channel || "chrome", config.browser.userDataDir, config.browser.launchOptions.executablePath);
+  if (options.extension) {
+    const serverBackendFactory = {
+      name: "Playwright w/ extension",
+      nameInConfig: "playwright-extension",
+      version: packageJSON.version,
+      create: () => new import_browserServerBackend.BrowserServerBackend(config, extensionContextFactory)
+    };
+    await mcpServer.start(serverBackendFactory, config.server);
+    return;
+  }
+  if (options.connectTool) {
+    const providers = [
+      {
+        name: "default",
+        description: "Starts standalone browser",
+        connect: () => mcpServer.wrapInProcess(new import_browserServerBackend.BrowserServerBackend(config, browserContextFactory))
+      },
+      {
+        name: "extension",
+        description: "Connect to a browser using the Playwright MCP extension",
+        connect: () => mcpServer.wrapInProcess(new import_browserServerBackend.BrowserServerBackend(config, extensionContextFactory))
+      }
+    ];
+    const factory2 = {
+      name: "Playwright w/ switch",
+      nameInConfig: "playwright-switch",
+      version: packageJSON.version,
+      create: () => new import_proxyBackend.ProxyBackend(providers)
+    };
+    await mcpServer.start(factory2, config.server);
+    return;
+  }
+  const factory = {
+    name: "Playwright",
+    nameInConfig: "playwright",
+    version: packageJSON.version,
+    create: () => new import_browserServerBackend.BrowserServerBackend(config, browserContextFactory)
+  };
+  await mcpServer.start(factory, config.server);
+});
+function setupExitWatchdog() {
+  let isExiting = false;
+  const handleExit = async () => {
+    if (isExiting)
+      return;
+    isExiting = true;
+    setTimeout(() => process.exit(0), 15e3);
+    await import_context.Context.disposeAll();
+    process.exit(0);
+  };
+  process.stdin.on("close", handleExit);
+  process.on("SIGINT", handleExit);
+  process.on("SIGTERM", handleExit);
+}
+void import_utilsBundle.program.parseAsync(process.argv);

package/lib/mcp/sdk/bundle.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var bundle_exports = {};
 __export(bundle_exports, {
@@ -33,7 +43,7 @@ __export(bundle_exports, {
   zodToJsonSchema: () => zodToJsonSchema
 });
 module.exports = __toCommonJS(bundle_exports);
-const bundle = require("../../mcpBundleImpl");
+var bundle = __toESM(require("../../mcpBundleImpl"));
 const zodToJsonSchema = bundle.zodToJsonSchema;
 const Client = bundle.Client;
 const Server = bundle.Server;

package/lib/mcp/sdk/exports.js

@@ -20,7 +20,7 @@ __reExport(exports_exports, require("./proxyBackend"), module.exports);
 __reExport(exports_exports, require("./server"), module.exports);
 __reExport(exports_exports, require("./tool"), module.exports);
 __reExport(exports_exports, require("./http"), module.exports);
-__reExport(exports_exports, require("./call"), module.exports);
+__reExport(exports_exports, require("./mdb"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./inProcessTransport"),
@@ -28,5 +28,5 @@ __reExport(exports_exports, require("./call"), module.exports);
   ...require("./server"),
   ...require("./tool"),
   ...require("./http"),
-  ...require("./call")
+  ...require("./mdb")
 });

package/lib/mcp/sdk/http.js

@@ -37,12 +37,13 @@ var import_assert = __toESM(require("assert"));
 var import_http = __toESM(require("http"));
 var import_crypto = __toESM(require("crypto"));
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
-var mcp = __toESM(require("./bundle"));
-var import_server = require("./server");
+var mcpBundle = __toESM(require("./bundle"));
+var mcpServer = __toESM(require("./server"));
 const testDebug = (0, import_utilsBundle.debug)("pw:mcp:test");
 async function startHttpServer(config, abortSignal) {
   const { host, port } = config;
   const httpServer = import_http.default.createServer();
+  decorateServer(httpServer);
   await new Promise((resolve, reject) => {
     httpServer.on("error", reject);
     abortSignal?.addEventListener("abort", () => {
@@ -91,10 +92,10 @@ async function handleSSE(serverBackendFactory, req, res, url, sessions) {
     }
     return await transport.handlePostMessage(req, res);
   } else if (req.method === "GET") {
-    const transport = new mcp.SSEServerTransport("/sse", res);
+    const transport = new mcpBundle.SSEServerTransport("/sse", res);
     sessions.set(transport.sessionId, transport);
     testDebug(`create SSE session: ${transport.sessionId}`);
-    await (0, import_server.connect)(serverBackendFactory, transport, false);
+    await mcpServer.connect(serverBackendFactory, transport, false);
     res.on("close", () => {
       testDebug(`delete SSE session: ${transport.sessionId}`);
       sessions.delete(transport.sessionId);
@@ -116,11 +117,11 @@ async function handleStreamable(serverBackendFactory, req, res, sessions) {
     return await transport.handleRequest(req, res);
   }
   if (req.method === "POST") {
-    const transport = new mcp.StreamableHTTPServerTransport({
+    const transport = new mcpBundle.StreamableHTTPServerTransport({
       sessionIdGenerator: () => import_crypto.default.randomUUID(),
       onsessioninitialized: async (sessionId2) => {
         testDebug(`create http session: ${transport.sessionId}`);
-        await (0, import_server.connect)(serverBackendFactory, transport, true);
+        await mcpServer.connect(serverBackendFactory, transport, true);
         sessions.set(sessionId2, transport);
       }
     });
@@ -136,6 +137,20 @@ async function handleStreamable(serverBackendFactory, req, res, sessions) {
   res.statusCode = 400;
   res.end("Invalid request");
 }
+function decorateServer(server) {
+  const sockets = /* @__PURE__ */ new Set();
+  server.on("connection", (socket) => {
+    sockets.add(socket);
+    socket.once("close", () => sockets.delete(socket));
+  });
+  const close = server.close;
+  server.close = (callback) => {
+    for (const socket of sockets)
+      socket.destroy();
+    sockets.clear();
+    return close.call(server, callback);
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   httpAddressToString,

package/lib/mcp/sdk/mdb.js

@@ -35,15 +35,14 @@ __export(mdb_exports, {
 module.exports = __toCommonJS(mdb_exports);
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
 var import_utils = require("playwright-core/lib/utils");
-var import_bundle = require("./bundle.js");
-var import_bundle2 = require("./bundle.js");
-var mcpBundle = __toESM(require("./bundle.js"));
-var import_tool = require("./tool.js");
-var mcpServer = __toESM(require("./server.js"));
-var mcpHttp = __toESM(require("./http.js"));
-var import_server = require("./server.js");
+var import_tool = require("./tool");
+var mcpBundle = __toESM(require("./bundle"));
+var mcpServer = __toESM(require("./server"));
+var mcpHttp = __toESM(require("./http"));
+var import_server = require("./server");
 const mdbDebug = (0, import_utilsBundle.debug)("pw:mcp:mdb");
 const errorsDebug = (0, import_utilsBundle.debug)("pw:mcp:errors");
+const z = mcpBundle.z;
 class MDBBackend {
   constructor(topLevelBackend) {
     this._stack = [];
@@ -73,6 +72,8 @@ class MDBBackend {
       await entry.client.close();
       entry = this._stack[0];
     }
+    if (!entry)
+      throw new Error(`Tool ${name} not found in the tool stack`);
     const resultPromise = new import_utils.ManualPromise();
     entry.resultPromise = resultPromise;
     this._client().callTool({
@@ -103,14 +104,14 @@ class MDBBackend {
   }
   async _pushTools(params) {
     mdbDebug("pushing tools to the stack", params.mcpUrl);
-    const transport = new import_bundle2.StreamableHTTPClientTransport(new URL(params.mcpUrl));
+    const transport = new mcpBundle.StreamableHTTPClientTransport(new URL(params.mcpUrl));
     await this._pushClient(transport, params.introMessage);
     return { content: [{ type: "text", text: "Tools pushed" }] };
   }
   async _pushClient(transport, introMessage) {
     mdbDebug("pushing client to the stack");
     const client = new mcpBundle.Client({ name: "Internal client", version: "0.0.0" });
-    client.setRequestHandler(import_bundle.PingRequestSchema, () => ({}));
+    client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
     await client.connect(transport);
     mdbDebug("connected to the new client");
     const { tools } = await client.listTools();
@@ -131,9 +132,9 @@ const pushToolsSchema = (0, import_tool.defineToolSchema)({
   name: "mdb_push_tools",
   title: "Push MCP tools to the tools stack",
   description: "Push MCP tools to the tools stack",
-  inputSchema: import_bundle.z.object({
-    mcpUrl: import_bundle.z.string(),
-    introMessage: import_bundle.z.string().optional()
+  inputSchema: z.object({
+    mcpUrl: z.string(),
+    introMessage: z.string().optional()
   }),
   type: "readOnly"
 });
@@ -144,7 +145,7 @@ async function runMainBackend(backendFactory, options) {
     create: () => mdbBackend
   };
   const url = await startAsHttp(factory, { port: options?.port || 0 });
-  process.env.PLAYWRIGHT_MDB_URL = url;
+  process.env.PLAYWRIGHT_DEBUGGER_MCP = url;
   if (options?.port !== void 0)
     return url;
   await mcpServer.connect(factory, new mcpBundle.StdioServerTransport(), false);
@@ -161,8 +162,8 @@ async function runOnPauseBackendLoop(mdbUrl, backend, introMessage) {
   await mcpHttp.installHttpTransport(httpServer, factory);
   const url = mcpHttp.httpAddressToString(httpServer.address());
   const client = new mcpBundle.Client({ name: "Internal client", version: "0.0.0" });
-  client.setRequestHandler(import_bundle.PingRequestSchema, () => ({}));
-  const transport = new import_bundle2.StreamableHTTPClientTransport(new URL(mdbUrl));
+  client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
+  const transport = new mcpBundle.StreamableHTTPClientTransport(new URL(mdbUrl));
   await client.connect(transport);
   const pushToolsResult = await client.callTool({
     name: pushToolsSchema.name,

package/lib/mcp/sdk/proxyBackend.js

@@ -32,8 +32,9 @@ __export(proxyBackend_exports, {
 });
 module.exports = __toCommonJS(proxyBackend_exports);
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
-var mcp = __toESM(require("./bundle"));
+var mcpBundle = __toESM(require("./bundle"));
 const errorsDebug = (0, import_utilsBundle.debug)("pw:mcp:errors");
+const { z, zodToJsonSchema } = mcpBundle;
 class ProxyBackend {
   constructor(mcpProviders) {
     this._roots = [];
@@ -89,8 +90,8 @@ Error: ${error}
         "Connect to a browser using one of the available methods:",
         ...this._mcpProviders.map((factory) => `- "${factory.name}": ${factory.description}`)
       ].join("\n"),
-      inputSchema: mcp.zodToJsonSchema(mcp.z.object({
-        name: mcp.z.enum(this._mcpProviders.map((factory) => factory.name)).default(this._mcpProviders[0].name).describe("The method to use to connect to the browser")
+      inputSchema: zodToJsonSchema(z.object({
+        name: z.enum(this._mcpProviders.map((factory) => factory.name)).default(this._mcpProviders[0].name).describe("The method to use to connect to the browser")
       }), { strictUnions: true }),
       annotations: {
         title: "Connect to a browser context",
@@ -102,14 +103,14 @@ Error: ${error}
   async _setCurrentClient(factory) {
     await this._currentClient?.close();
     this._currentClient = void 0;
-    const client = new mcp.Client({ name: "Playwright MCP Proxy", version: "0.0.0" });
+    const client = new mcpBundle.Client({ name: "Playwright MCP Proxy", version: "0.0.0" });
     client.registerCapabilities({
       roots: {
         listRoots: true
       }
     });
-    client.setRequestHandler(mcp.ListRootsRequestSchema, () => ({ roots: this._roots }));
-    client.setRequestHandler(mcp.PingRequestSchema, () => ({}));
+    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._roots }));
+    client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
     const transport = await factory.connect();
     await client.connect(transport);
     this._currentClient = client;

package/lib/mcp/sdk/server.js

@@ -35,9 +35,9 @@ __export(server_exports, {
 });
 module.exports = __toCommonJS(server_exports);
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
-var mcp = __toESM(require("./bundle"));
-var import_inProcessTransport = require("./inProcessTransport");
+var mcpBundle = __toESM(require("./bundle"));
 var import_http = require("./http");
+var import_inProcessTransport = require("./inProcessTransport");
 const serverDebug = (0, import_utilsBundle.debug)("pw:mcp:server");
 const errorsDebug = (0, import_utilsBundle.debug)("pw:mcp:errors");
 async function connect(factory, transport, runHeartbeat) {
@@ -52,19 +52,19 @@ function createServer(name, version, backend, runHeartbeat) {
   let initializedPromiseResolve = () => {
   };
   const initializedPromise = new Promise((resolve) => initializedPromiseResolve = resolve);
-  const server = new mcp.Server({ name, version }, {
+  const server = new mcpBundle.Server({ name, version }, {
     capabilities: {
       tools: {}
     }
   });
-  server.setRequestHandler(mcp.ListToolsRequestSchema, async () => {
+  server.setRequestHandler(mcpBundle.ListToolsRequestSchema, async () => {
     serverDebug("listTools");
     await initializedPromise;
     const tools = await backend.listTools();
     return { tools };
   });
   let heartbeatRunning = false;
-  server.setRequestHandler(mcp.CallToolRequestSchema, async (request) => {
+  server.setRequestHandler(mcpBundle.CallToolRequestSchema, async (request) => {
     serverDebug("callTool", request);
     await initializedPromise;
     if (runHeartbeat && !heartbeatRunning) {
@@ -120,7 +120,7 @@ function addServerListener(server, event, listener) {
 }
 async function start(serverBackendFactory, options) {
   if (options.port === void 0) {
-    await connect(serverBackendFactory, new mcp.StdioServerTransport(), false);
+    await connect(serverBackendFactory, new mcpBundle.StdioServerTransport(), false);
     return;
   }
   const httpServer = await (0, import_http.startHttpServer)(options);

package/lib/mcp/sdk/tool.js

@@ -22,7 +22,7 @@ __export(tool_exports, {
   toMcpTool: () => toMcpTool
 });
 module.exports = __toCommonJS(tool_exports);
-var import_bundle = require("./bundle.js");
+var import_bundle = require("../sdk/bundle");
 function toMcpTool(tool) {
   return {
     name: tool.name,

package/lib/mcp/{browser/backend.js → test/browserBackend.js}

@@ -26,19 +26,17 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var backend_exports = {};
-__export(backend_exports, {
+var browserBackend_exports = {};
+__export(browserBackend_exports, {
   BrowserBackend: () => BrowserBackend,
   runBrowserBackendOnError: () => runBrowserBackendOnError
 });
-module.exports = __toCommonJS(backend_exports);
+module.exports = __toCommonJS(browserBackend_exports);
 var mcp = __toESM(require("../sdk/exports"));
 var mcpBundle = __toESM(require("../sdk/bundle"));
-var import_tools = require("./tools");
-var import_exports = require("../sdk/exports");
-var import_mdb = require("../sdk/mdb");
+var import_browserTools = require("./browserTools");
 var import_util = require("../../util");
-const tools = [import_tools.snapshot, import_tools.pickLocator, import_tools.evaluate];
+const tools = [import_browserTools.snapshot, import_browserTools.pickLocator, import_browserTools.evaluate];
 class BrowserBackend {
   constructor(page) {
     this.name = "Playwright";
@@ -65,7 +63,7 @@ class BrowserBackend {
     return await tool.handle(this._page, parsedArguments);
   }
 }
-const doneToolSchema = (0, import_exports.defineToolSchema)({
+const doneToolSchema = mcp.defineToolSchema({
   name: "done",
   title: "Done",
   description: "Done",
@@ -84,7 +82,7 @@ ${snapshot2}
 
 ### Task
 Try recovering from the error prior to continuing, use following tools to recover: ${tools.map((tool) => tool.schema.name).join(", ")}`;
-  await (0, import_mdb.runOnPauseBackendLoop)(process.env.PLAYWRIGHT_MDB_URL, new BrowserBackend(page), introMessage);
+  await mcp.runOnPauseBackendLoop(process.env.PLAYWRIGHT_MDB_URL, new BrowserBackend(page), introMessage);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/mcp/test/browserTool.js

@@ -0,0 +1,30 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var browserTool_exports = {};
+__export(browserTool_exports, {
+  defineBrowserTool: () => defineBrowserTool
+});
+module.exports = __toCommonJS(browserTool_exports);
+function defineBrowserTool(tool) {
+  return tool;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineBrowserTool
+});

package/lib/mcp/test/browserTools.js

@@ -0,0 +1,120 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var browserTools_exports = {};
+__export(browserTools_exports, {
+  elementSchema: () => elementSchema,
+  evaluate: () => evaluate,
+  pickLocator: () => pickLocator,
+  snapshot: () => snapshot
+});
+module.exports = __toCommonJS(browserTools_exports);
+var import_utils = require("playwright-core/lib/utils");
+var import_browserTool = require("./browserTool.js");
+var mcpBundle = __toESM(require("../sdk/bundle"));
+const { z } = mcpBundle;
+const snapshot = (0, import_browserTool.defineBrowserTool)({
+  schema: {
+    name: "playwright_test_browser_snapshot",
+    title: "Capture page snapshot",
+    description: "Capture page snapshot for debugging",
+    inputSchema: z.object({}),
+    type: "readOnly"
+  },
+  handle: async (page, params) => {
+    const snapshot2 = await page._snapshotForAI();
+    return {
+      content: [
+        {
+          type: "text",
+          text: snapshot2
+        }
+      ]
+    };
+  }
+});
+const elementSchema = z.object({
+  element: z.string().describe("Human-readable element description used to obtain permission to interact with the element"),
+  ref: z.string().describe("Exact target element reference from the page snapshot")
+});
+const pickLocator = (0, import_browserTool.defineBrowserTool)({
+  schema: {
+    name: "playwright_test_generate_locator",
+    title: "Create locator for element",
+    description: "Generate locator for the given element to use in tests",
+    inputSchema: elementSchema,
+    type: "readOnly"
+  },
+  handle: async (page, params) => {
+    const locator = await refLocator(page, params);
+    try {
+      const { resolvedSelector } = await locator._resolveSelector();
+      const locatorString = (0, import_utils.asLocator)("javascript", resolvedSelector);
+      return { content: [{ type: "text", text: locatorString }] };
+    } catch (e) {
+      throw new Error(`Ref not found, likely because element was removed. Use ${snapshot.schema.name} to see what elements are currently on the page.`);
+    }
+  }
+});
+const evaluateSchema = z.object({
+  function: z.string().describe("() => { /* code */ } or (element) => { /* code */ } when element is provided"),
+  element: z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
+  ref: z.string().optional().describe("Exact target element reference from the page snapshot")
+});
+const evaluate = (0, import_browserTool.defineBrowserTool)({
+  schema: {
+    name: "playwright_test_evaluate_on_pause",
+    title: "Evaluate in page",
+    description: "Evaluate JavaScript expression on page or element",
+    inputSchema: evaluateSchema,
+    type: "destructive"
+  },
+  handle: async (page, params) => {
+    let locator;
+    if (params.ref && params.element)
+      locator = await refLocator(page, { ref: params.ref, element: params.element });
+    const receiver = locator ?? page;
+    const result = await receiver._evaluateFunction(params.function);
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) || "undefined" }]
+    };
+  }
+});
+async function refLocator(page, elementRef) {
+  const snapshot2 = await page._snapshotForAI();
+  if (!snapshot2.includes(`[ref=${elementRef.ref}]`))
+    throw new Error(`Ref ${elementRef.ref} not found in the current page snapshot. Try capturing new snapshot.`);
+  return page.locator(`aria-ref=${elementRef.ref}`).describe(elementRef.element);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  elementSchema,
+  evaluate,
+  pickLocator,
+  snapshot
+});