Playwright MCP Server

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "element": {
      "description": "Human-readable element description used to obtain permission to interact with the element",
      "type": "string"
    },
    "target": {
      "type": "string",
      "description": "Exact target element reference from the page snapshot, or a unique element selector"
    },
    "doubleClick": {
      "description": "Whether to perform a double click instead of a single click",
      "type": "boolean"
    },
    "button": {
      "description": "Button to click, defaults to left",
      "type": "string",
      "enum": [
        "left",
        "right",
        "middle"
      ]
    },
    "modifiers": {
      "description": "Modifier keys to press",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Alt",
          "Control",
          "ControlOrMeta",
          "Meta",
          "Shift"
        ]
      }
    }
  },
  "required": [
    "target"
  ],
  "additionalProperties": false
}

{
  "title": "Click",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "title": "Close browser",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "level": {
      "default": "info",
      "description": "Level of the console messages to return. Each level includes the messages of more severe levels. Defaults to \"info\".",
      "type": "string",
      "enum": [
        "error",
        "warning",
        "info",
        "debug"
      ]
    },
    "all": {
      "description": "Return all console messages since the beginning of the session, not just since the last navigation. Defaults to false.",
      "type": "boolean"
    },
    "filename": {
      "description": "Filename to save the console messages to. If not provided, messages are returned as text.",
      "type": "string"
    }
  },
  "required": [
    "level"
  ],
  "additionalProperties": false
}

{
  "title": "Get console messages",
  "readOnlyHint": true,
  "destructiveHint": false,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "startElement": {
      "description": "Human-readable source element description used to obtain the permission to interact with the element",
      "type": "string"
    },
    "startTarget": {
      "type": "string",
      "description": "Exact target element reference from the page snapshot, or a unique element selector"
    },
    "endElement": {
      "description": "Human-readable target element description used to obtain the permission to interact with the element",
      "type": "string"
    },
    "endTarget": {
      "type": "string",
      "description": "Exact target element reference from the page snapshot, or a unique element selector"
    }
  },
  "required": [
    "startTarget",
    "endTarget"
  ],
  "additionalProperties": false
}

{
  "title": "Drag mouse",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "element": {
      "description": "Human-readable element description used to obtain permission to interact with the element",
      "type": "string"
    },
    "target": {
      "type": "string",
      "description": "Exact target element reference from the page snapshot, or a unique element selector"
    },
    "paths": {
      "description": "Absolute paths to files to drop onto the element.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "data": {
      "description": "Data to drop, as a map of MIME type to string value (e.g. {\"text/plain\": \"hello\", \"text/uri-list\": \"https://example.com\"}).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "target"
  ],
  "additionalProperties": false
}

{
  "title": "Drop files or data onto an element",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "element": {
      "description": "Human-readable element description used to obtain permission to interact with the element",
      "type": "string"
    },
    "target": {
      "description": "Exact target element reference from the page snapshot, or a unique element selector",
      "type": "string"
    },
    "function": {
      "type": "string",
      "description": "() => { /* code */ } or (element) => { /* code */ } when element is provided"
    },
    "filename": {
      "description": "Filename to save the result to. If not provided, result is returned as text.",
      "type": "string"
    }
  },
  "required": [
    "function"
  ],
  "additionalProperties": false
}

{
  "title": "Evaluate JavaScript",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "paths": {
      "description": "The absolute paths to the files to upload. Can be single file or multiple files. If omitted, file chooser is cancelled.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": false
}

{
  "title": "Upload files",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "element": {
            "description": "Human-readable element description used to obtain permission to interact with the element",
            "type": "string"
          },
          "target": {
            "type": "string",
            "description": "Exact target element reference from the page snapshot, or a unique element selector"
          },
          "name": {
            "type": "string",
            "description": "Human-readable field name"
          },
          "type": {
            "type": "string",
            "enum": [
              "textbox",
              "checkbox",
              "radio",
              "combobox",
              "slider"
            ],
            "description": "Type of the field"
          },
          "value": {
            "type": "string",
            "description": "Value to fill in the field. If the field is a checkbox, the value should be `true` or `false`. If the field is a combobox, the value should be the text of the option."
          }
        },
        "required": [
          "target",
          "name",
          "type",
          "value"
        ],
        "additionalProperties": false
      },
      "description": "Fields to fill in"
    }
  },
  "required": [
    "fields"
  ],
  "additionalProperties": false
}

{
  "title": "Fill form",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "text": {
      "description": "Plain text to search for in the page snapshot (case-insensitive substring match). Provide either text or regex, not both.",
      "type": "string"
    },
    "regex": {
      "description": "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 regex, not both.",
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "title": "Find in page snapshot",
  "readOnlyHint": true,
  "destructiveHint": false,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "accept": {
      "type": "boolean",
      "description": "Whether to accept the dialog."
    },
    "promptText": {
      "description": "The text of the prompt in case of a prompt dialog.",
      "type": "string"
    }
  },
  "required": [
    "accept"
  ],
  "additionalProperties": false
}

{
  "title": "Handle a dialog",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "element": {
      "description": "Human-readable element description used to obtain permission to interact with the element",
      "type": "string"
    },
    "target": {
      "type": "string",
      "description": "Exact target element reference from the page snapshot, or a unique element selector"
    }
  },
  "required": [
    "target"
  ],
  "additionalProperties": false
}

{
  "title": "Hover mouse",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The URL to navigate to"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

{
  "title": "Navigate to a URL",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "title": "Go back",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "index": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "1-based index of the request, as printed by browser_network_requests."
    },
    "part": {
      "description": "Return only this part of the request. Omit to return full details.",
      "type": "string",
      "enum": [
        "request-headers",
        "request-body",
        "response-headers",
        "response-body"
      ]
    },
    "filename": {
      "description": "Filename to save the result to. If not provided, output is returned as text.",
      "type": "string"
    }
  },
  "required": [
    "index"
  ],
  "additionalProperties": false
}

{
  "title": "Show network request details",
  "readOnlyHint": true,
  "destructiveHint": false,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "static": {
      "default": false,
      "description": "Whether to include successful static resources like images, fonts, scripts, etc. Defaults to false.",
      "type": "boolean"
    },
    "filter": {
      "description": "Only return requests whose URL matches this regexp (e.g. \"/api/.*user\").",
      "type": "string"
    },
    "filename": {
      "description": "Filename to save the network requests to. If not provided, requests are returned as text.",
      "type": "string"
    }
  },
  "required": [
    "static"
  ],
  "additionalProperties": false
}

{
  "title": "List network requests",
  "readOnlyHint": true,
  "destructiveHint": false,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "Name of the key to press or a character to generate, such as `ArrowLeft` or `a`"
    }
  },
  "required": [
    "key"
  ],
  "additionalProperties": false
}

{
  "title": "Press a key",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "width": {
      "type": "number",
      "description": "Width of the browser window"
    },
    "height": {
      "type": "number",
      "description": "Height of the browser window"
    }
  },
  "required": [
    "width",
    "height"
  ],
  "additionalProperties": false
}

{
  "title": "Resize browser window",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "description": "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.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }`",
      "type": "string"
    },
    "filename": {
      "description": "Load code from the specified file. If both code and filename are provided, code will be ignored.",
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "title": "Run Playwright code (unsafe)",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "element": {
      "description": "Human-readable element description used to obtain permission to interact with the element",
      "type": "string"
    },
    "target": {
      "type": "string",
      "description": "Exact target element reference from the page snapshot, or a unique element selector"
    },
    "values": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of values to select in the dropdown. This can be a single value or multiple values."
    }
  },
  "required": [
    "target",
    "values"
  ],
  "additionalProperties": false
}

{
  "title": "Select option",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "target": {
      "description": "Exact target element reference from the page snapshot, or a unique element selector",
      "type": "string"
    },
    "filename": {
      "description": "Save snapshot to markdown file instead of returning it in the response.",
      "type": "string"
    },
    "depth": {
      "description": "Limit the depth of the snapshot tree",
      "type": "number"
    },
    "boxes": {
      "description": "Include each element's bounding box as [box=x,y,width,height] in the snapshot. Coordinates are viewport-relative, in CSS pixels (Element.getBoundingClientRect)",
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

{
  "title": "Page snapshot",
  "readOnlyHint": true,
  "destructiveHint": false,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "new",
        "close",
        "select"
      ],
      "description": "Operation to perform"
    },
    "index": {
      "description": "Tab index, used for close/select. If omitted for close, current tab is closed.",
      "type": "number"
    },
    "url": {
      "description": "URL to navigate to in the new tab, used for new.",
      "type": "string"
    }
  },
  "required": [
    "action"
  ],
  "additionalProperties": false
}

{
  "title": "Manage tabs",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "element": {
      "description": "Human-readable element description used to obtain permission to interact with the element",
      "type": "string"
    },
    "target": {
      "description": "Exact target element reference from the page snapshot, or a unique element selector",
      "type": "string"
    },
    "type": {
      "description": "Image format for the screenshot. If unset, inferred from the filename extension, otherwise png.",
      "type": "string",
      "enum": [
        "png",
        "jpeg",
        "webp"
      ]
    },
    "filename": {
      "description": "File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg|webp}` if not specified. Prefer relative file names to stay within the output directory.",
      "type": "string"
    },
    "fullPage": {
      "description": "When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Cannot be used with element screenshots.",
      "type": "boolean"
    },
    "scale": {
      "default": "css",
      "description": "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 the device pixel ratio). Default is css.",
      "type": "string",
      "enum": [
        "css",
        "device"
      ]
    }
  },
  "required": [
    "scale"
  ],
  "additionalProperties": false
}

{
  "title": "Take a screenshot",
  "readOnlyHint": true,
  "destructiveHint": false,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "element": {
      "description": "Human-readable element description used to obtain permission to interact with the element",
      "type": "string"
    },
    "target": {
      "type": "string",
      "description": "Exact target element reference from the page snapshot, or a unique element selector"
    },
    "text": {
      "type": "string",
      "description": "Text to type into the element"
    },
    "submit": {
      "description": "Whether to submit entered text (press Enter after)",
      "type": "boolean"
    },
    "slowly": {
      "description": "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.",
      "type": "boolean"
    }
  },
  "required": [
    "target",
    "text"
  ],
  "additionalProperties": false
}

{
  "title": "Type text",
  "readOnlyHint": false,
  "destructiveHint": true,
  "openWorldHint": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "time": {
      "description": "The time to wait in seconds",
      "type": "number"
    },
    "text": {
      "description": "The text to wait for",
      "type": "string"
    },
    "textGone": {
      "description": "The text to wait for to disappear",
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "title": "Wait for",
  "readOnlyHint": true,
  "destructiveHint": false,
  "openWorldHint": true
}