fastbrowser_cli 1.0.30 → 1.0.33

package/docs/target_tools/target_tools_playwright.md

@@ -0,0 +1,763 @@
+# Tools available on MCP target 'playwright' (23)
+
+## browser_close
+
+### Description
+Close the page
+
+### Input schema
+```
+{
+  "type": "object",
+  "properties": {},
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_resize
+
+### Description
+Resize the browser window
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_console_messages
+
+### Description
+Returns all console messages
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_handle_dialog
+
+### Description
+Handle a dialog
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_evaluate
+
+### Description
+Evaluate JavaScript expression on page or element
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_file_upload
+
+### Description
+Upload one or multiple files
+
+### Input 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"
+      }
+    }
+  },
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_drop
+
+### 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.
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_fill_form
+
+### Description
+Fill multiple form fields
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_press_key
+
+### Description
+Press a key on the keyboard
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_type
+
+### Description
+Type text into editable element
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_navigate
+
+### Description
+Navigate to a URL
+
+### Input schema
+```
+{
+  "type": "object",
+  "properties": {
+    "url": {
+      "type": "string",
+      "description": "The URL to navigate to"
+    }
+  },
+  "required": [
+    "url"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_navigate_back
+
+### Description
+Go back to the previous page in the history
+
+### Input schema
+```
+{
+  "type": "object",
+  "properties": {},
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_network_requests
+
+### Description
+Returns a numbered list of network requests since loading the page. Use browser_network_request with the number to get full details.
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_network_request
+
+### Description
+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 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_run_code_unsafe
+
+### Description
+Run a Playwright code snippet. Unsafe: executes arbitrary JavaScript in the Playwright server process and is RCE-equivalent.
+
+### Input 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"
+    }
+  },
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_take_screenshot
+
+### Description
+Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.
+
+### Input 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": {
+      "default": "png",
+      "description": "Image format for the screenshot. Default is png.",
+      "type": "string",
+      "enum": [
+        "png",
+        "jpeg"
+      ]
+    },
+    "filename": {
+      "description": "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.",
+      "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"
+    }
+  },
+  "required": [
+    "type"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_snapshot
+
+### Description
+Capture accessibility snapshot of the current page, this is better than screenshot
+
+### Input 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",
+      "type": "boolean"
+    }
+  },
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_click
+
+### Description
+Perform click on a web page
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_drag
+
+### Description
+Perform drag and drop between two elements
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_hover
+
+### Description
+Hover over element on page
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_select_option
+
+### Description
+Select an option in a dropdown
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_tabs
+
+### Description
+List, create, close, or select a browser tab.
+
+### Input 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"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+
+## browser_wait_for
+
+### Description
+Wait for text to appear or disappear or a specified time to pass
+
+### Input 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"
+    }
+  },
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false
+}
+```
+