Parameters:
- outputPath (string, optional): Directory path where screenshot will be saved (default: OS temp directory)
- name (string, optional): Screenshot name (default: "screenshot")
- selector (string, optional): CSS selector for element to capture
- fullPage (boolean, optional): Capture full scrollable page (default: false)
- type (enum, optional): Image format - "png" or "jpeg" (default: "png")
- quality (number, optional): The quality of the image, between 0-100. Not applicable to PNG images, only used for JPEG format (default: 100)
- includeBase64 (boolean, optional): Include base64-encoded image data in the response (default: false)

Returns:
- filePath (string): Full path of the saved screenshot file
- image (object, optional): Screenshot image data with mimeType (only included when includeBase64 is true)

Notes:
- The screenshot is always saved to the file system and the file path is returned
- By default, image data is NOT included in the response to reduce payload size
- Set includeBase64 to true when the AI assistant cannot access the MCP server's file system (e.g., remote server, containerized environment, or different machine)
- The quality parameter only applies to JPEG images. PNG images are always saved at full quality
- Lower quality values (e.g., 50-70) result in smaller file sizes but reduced image quality


Parameters:
- selector (string, optional): CSS selector to limit the HTML content to a specific container
- removeScripts (boolean, optional): Remove all script tags from the HTML (default: true)
- removeComments (boolean, optional): Remove all HTML comments (default: false)
- removeStyles (boolean, optional): Remove all style tags from the HTML (default: false)
- removeMeta (boolean, optional): Remove all meta tags from the HTML (default: false)
- cleanHtml (boolean, optional): Perform comprehensive HTML cleaning (default: false)
- minify (boolean, optional): Minify the HTML output (default: false)
- maxLength (number, optional): Maximum number of characters to return (default: 50000)

Returns:
- output (string): The requested HTML content of the page


Parameters:
- selector (string, optional): CSS selector to limit the text content to a specific container
- maxLength (number, optional): Maximum number of characters to return (default: 50000)

Returns:
- output (string): The requested text content of the page


Parameters:
- outputPath (string, optional): Directory path where PDF will be saved (default: OS temp directory)
- name (string, optional): PDF name (default: "page")
- format (enum, optional): Page format - "Letter", "Legal", "Tabloid", "Ledger", "A0" through "A6" (default: "A4")
- printBackground (boolean, optional): Whether to print background graphics (default: false)
- margin (object, optional): Page margins with top, right, bottom, left (default: "1cm" for each)

Returns:
- filePath (string): Full path of the saved PDF file


Parameters:
- selector (string, required): CSS selector for the element to click


Parameters:
- selector (string, required): CSS selector for the input field
- value (string, required): Value to fill


Parameters:
- selector (string, required): CSS selector for the element to hover


Parameters:
- key (string, required): Key to press (e.g., "Enter", "Escape", "Tab")
- selector (string, optional): CSS selector to focus before sending the key
- holdMs (number, optional): Duration in milliseconds to hold the key (repeat duration if repeat is true)
- repeat (boolean, optional, default: false): If true, simulates key auto-repeat by pressing repeatedly during holdMs
- repeatIntervalMs (number, optional, default: 50, min: 10): Interval between repeated key presses in ms (only when repeat is true)


Parameters:
- selector (string, required): CSS selector for the select element
- value (string, required): Value to select


Parameters:
- sourceSelector (string, required): CSS selector for the source element
- targetSelector (string, required): CSS selector for the target element


Parameters:
- mode (enum, optional): Scroll mode - "by" (relative delta), "to" (absolute position), "top", "bottom", "left", "right" (default: "by")
- selector (string, optional): CSS selector for a scrollable container. If omitted, scrolls the document viewport
- dx (number, optional): Horizontal scroll delta in pixels (used when mode="by", default: 0)
- dy (number, optional): Vertical scroll delta in pixels (used when mode="by", default: 0)
- x (number, optional): Absolute horizontal scroll position in pixels (used when mode="to")
- y (number, optional): Absolute vertical scroll position in pixels (used when mode="to")
- behavior (enum, optional): Native scroll behavior - "auto" or "smooth" (default: "auto")

Returns:
- mode (string): The scroll mode used
- selector (string | null): The selector of the scroll container if provided; otherwise null (document viewport)
- behavior (string): The scroll behavior used
- before (object): Scroll metrics before the scroll action (x, y, scrollWidth, scrollHeight, clientWidth, clientHeight)
- after (object): Scroll metrics after the scroll action (x, y, scrollWidth, scrollHeight, clientWidth, clientHeight)
- canScrollX (boolean): Whether horizontal scrolling is possible
- canScrollY (boolean): Whether vertical scrolling is possible
- maxScrollX (number): Maximum horizontal scrollLeft
- maxScrollY (number): Maximum vertical scrollTop
- isAtLeft (boolean): Whether the scroll position is at the far left
- isAtRight (boolean): Whether the scroll position is at the far right
- isAtTop (boolean): Whether the scroll position is at the very top
- isAtBottom (boolean): Whether the scroll position is at the very bottom

Usage:
- Reveal content below the fold
- Jump to the top/bottom without knowing exact positions
- Bring elements into view before clicking
- Inspect lazy-loaded content that appears on scroll


Parameters:
- width (number, required): Target viewport width in CSS pixels (minimum: 200)
- height (number, required): Target viewport height in CSS pixels (minimum: 200)

Returns:
- requested (object): Requested viewport configuration (width, height)
- viewport (object): Viewport metrics observed inside the page after resizing:
- innerWidth, innerHeight: window.innerWidth/innerHeight
- outerWidth, outerHeight: window.outerWidth/outerHeight
- devicePixelRatio: window.devicePixelRatio

Notes:
- This affects window.innerWidth/innerHeight, CSS media queries, layout, rendering, and screenshots
- This does NOT resize the OS-level browser window
- Runtime switching to viewport=null (binding to real window size) is not supported by Playwright
- If you need real window-driven responsive behavior, start the BrowserContext with viewport: null and use the window resize tool instead


Parameters:
- width (number, optional): Target window width in pixels (required when state="normal", minimum: 200)
- height (number, optional): Target window height in pixels (required when state="normal", minimum: 200)
- state (enum, optional): Target window state - "normal", "maximized", "minimized", or "fullscreen" (default: "normal")

Returns:
- requested (object): Requested window change parameters (width, height, state)
- before (object): Window bounds before resizing (windowId, state, left, top, width, height)
- after (object): Window bounds after resizing (windowId, state, left, top, width, height)
- viewport (object): Page viewport metrics after resizing (innerWidth, innerHeight, outerWidth, outerHeight, devicePixelRatio)

Notes:
- Works best on Chromium-based browsers (Chromium/Chrome/Edge)
- Especially useful in headful sessions when running with viewport emulation disabled (viewport: null)
- If Playwright viewport emulation is enabled (viewport is NOT null), resizing the OS window may not change page layout
- On non-Chromium browsers (Firefox/WebKit), CDP is not available and this tool will fail


Parameters:
- url (string, required): URL to navigate to (must include scheme)
- timeout (number, optional): Maximum operation time in milliseconds (default: 0 - no timeout)
- waitUntil (enum, optional): When to consider navigation succeeded - "load", "domcontentloaded", "networkidle", or "commit" (default: "load")

Returns:
- url (string): Final URL after navigation
- status (number): HTTP status code
- statusText (string): HTTP status text
- ok (boolean): Whether navigation was successful (2xx status)


Parameters:
- timeout (number, optional): Maximum operation time in milliseconds (default: 0 - no timeout)
- waitUntil (enum, optional): When to consider navigation succeeded - "load", "domcontentloaded", "networkidle", or "commit" (default: "load")

Returns:
- url (string): Final URL after reload
- status (number): HTTP status code
- statusText (string): HTTP status text
- ok (boolean): Whether reload was successful (2xx status)


Parameters:
- script (string, required): JavaScript code to execute

Returns:
- result (any): Result of the evaluation. This value can be of any type, including primitives, arrays, or objects. It represents the direct return value of the JavaScript expression executed in the page context.

Notes:
- The code executes in the PAGE CONTEXT (real browser environment):
- Has access to window, document, DOM, Web APIs
- Can read/modify the page state
- Runs with the same permissions as the loaded web page
- The code runs in an isolated execution context, but within the page
- No direct access to Node.js APIs
- Return value must be serializable

Typical use cases:
- Inspect or mutate DOM state
- Read client-side variables or framework internals
- Trigger browser-side logic
- Extract computed values directly from the page


Parameters:
- code (string, required): JavaScript code to run on the MCP server in a VM sandbox. The code is wrapped in an async IIFE, so await is allowed. Use return ... to return a value
- timeoutMs (number, optional): Max VM CPU time for synchronous execution in milliseconds (default: 5000, max: 30000)

Returns:
- result (any): Return value of the sandboxed code (best-effort JSON-safe). If user returns undefined but logs exist, returns { logs }. If error occurs, returns { error, logs }

Available bindings:
- page: Playwright Page (main interaction surface)
- console: captured logs (log/warn/error)
- sleep(ms): async helper

Safe built-ins:
- Math, JSON, Number, String, Boolean, Array, Object, Date, RegExp
- isFinite, isNaN, parseInt, parseFloat
- URL, URLSearchParams
- TextEncoder, TextDecoder
- structuredClone
- crypto.randomUUID()
- AbortController
- setTimeout / clearTimeout

NOT available:
- require, process, fs, Buffer
- globalThis

Notes:
- This runs on the MCP SERVER (not in the browser)
- This is NOT a security boundary. Intended for trusted automation logic
- The timeoutMs parameter limits synchronous execution time, but does not automatically time out awaited Promises


Parameters:
- type (enum, optional): Filter by message level - "ERROR", "WARNING", "INFO", "DEBUG"
- search (string, optional): Text to search for in messages
- timestamp (number, optional): Start time filter (Unix epoch milliseconds)
- sequenceNumber (number, optional): Only return messages after this sequence number
- limit (object, optional): Limit results
- count (number): Maximum number of messages
- from (enum): "start" or "end" (default: "end")

Returns:
- messages (array): Array of console messages with type, text, location, timestamp, and sequence number


Parameters:
- resourceType (enum, optional): Filter by resource type (e.g., "document", "script", "stylesheet")
- status (object, optional): Filter by status code range
- min (number): Minimum status code
- max (number): Maximum status code
- ok (boolean, optional): Filter by success/failure (2xx = success)
- timestamp (number, optional): Start time filter (Unix epoch milliseconds)
- sequenceNumber (number, optional): Only return requests after this sequence number
- limit (object, optional): Limit results
- count (number): Maximum number of requests
- from (enum): "start" or "end" (default: "end")

Returns:
- requests (array): Array of HTTP requests with URL, method, headers, body, response, timing, and metadata


Parameters:
- waitMs (number, optional): Optional wait duration in milliseconds before reading metrics (default: 0, max: 30000). Useful to allow LCP/INP/CLS to settle after interactions
- includeDebug (boolean, optional): If true, returns additional debug details such as entry counts and LCP element hint (default: false)

Returns:
- url (string): Current page URL
- title (string): Current page title
- timestampMs (number): Unix epoch timestamp (ms) when the metrics were captured
- metrics (object): Raw metric values (null if unavailable):
- lcpMs (number | null): Largest Contentful Paint in milliseconds
- inpMs (number | null): Interaction to Next Paint in milliseconds (best-effort approximation)
- cls (number | null): Cumulative Layout Shift score
- ttfbMs (number | null): Time to First Byte in milliseconds
- fcpMs (number | null): First Contentful Paint in milliseconds
- ratings (object): Ratings computed from Google thresholds for each metric:
- lcp, inp, cls, ttfb, fcp: Each contains:
- rating (enum): "good", "needs_improvement", "poor", or "not_available"
- value (number | null): Metric value
- unit (enum): "ms" or "score"
- thresholds (object): Thresholds used for rating (good, poor)
- recommendations (object): Recommendations based on measured values:
- coreWebVitalsPassed (boolean): True if all Core Web Vitals are rated "good"
- summary (array): High-level summary and prioritization guidance
- lcp, inp, cls, ttfb, fcp (array): Specific recommendations for each metric
- general (array): General measurement and debugging notes
- notes (array): Notes about metric availability, browser limitations, and interpretation
- debug (object, optional): Optional debug details (when includeDebug=true):
- waitMs (number): Actual wait duration used
- entries (object): Counts of PerformanceEntry types used to compute metrics
- lastLcpSelectorHint (string | null): Best-effort selector hint for the last LCP element
- lastLcpTagName (string | null): Tag name of the last LCP element

Core Web Vitals Thresholds:
- LCP (Largest Contentful Paint): good <= 2500ms, poor > 4000ms
- INP (Interaction to Next Paint): good <= 200ms, poor > 500ms
- CLS (Cumulative Layout Shift): good <= 0.1, poor > 0.25

Supporting Metrics Thresholds:
- TTFB (Time to First Byte): good <= 800ms, poor > 1800ms
- FCP (First Contentful Paint): good <= 1800ms, poor > 3000ms

Usage:
- Call after navigation and after user actions
- If you need more stable LCP/CLS/INP, pass waitMs (e.g., 1000-3000ms)
- Some metrics may be unavailable depending on browser support and whether interactions occurred


Returns:
- traceId (string, optional): The OpenTelemetry compatible trace id of the current session if available

Note: Requires OpenTelemetry to be enabled (OTEL_ENABLE=true).


Returns:
- traceId (string): The generated new OpenTelemetry compatible trace id

Note: Requires OpenTelemetry to be enabled (OTEL_ENABLE=true). The new trace ID is automatically set and will be used for all subsequent traces in the session.


Parameters:
- traceId (string, optional): The OpenTelemetry compatible trace id to be set. Leave it empty to clear the session trace id, so no OpenTelemetry trace header will be propagated from browser throughout the API calls

Returns:
- No return value

Note: Requires OpenTelemetry to be enabled (OTEL_ENABLE=true). When a trace ID is set, it will be propagated in HTTP headers (traceparent) for all API calls, enabling correlation with backend traces.


Parameters:
- timeoutMs (number, optional): Maximum time to wait before failing (milliseconds, default: 30000)
- idleTimeMs (number, optional): How long the network must stay idle continuously before resolving (milliseconds, default: 500)
- maxConnections (number, optional): Idle threshold - network is considered idle when in-flight requests <= maxConnections (default: 0)
- pollIntervalMs (number, optional): Polling interval used to sample the in-flight request count (milliseconds, default: 50)

Returns:
- waitedMs (number): Total time waited until the network became idle or the tool timed out
- idleTimeMs (number): Idle duration required for success
- timeoutMs (number): Maximum allowed wait time
- maxConnections (number): Idle threshold used
- pollIntervalMs (number): Polling interval used
- finalInFlightRequests (number): The last observed number of in-flight requests
- observedIdleMs (number): How long the in-flight request count stayed <= maxConnections

Usage:
- Use before interacting with SPA pages that load data asynchronously
- Use before taking screenshots or AX tree snapshots for more stable results
- Use after actions that trigger background fetch/XHR activity

Note: This tool uses server-side tracking, so it works reliably even with strict CSP. It does NOT rely on window globals or page-injected counters.


Parameters:
- selector (string, optional): CSS selector for element to snapshot

Returns:
- output (string): Includes the page URL, title, and a YAML-formatted accessibility tree

Usage:
- Use in combination with accessibility_take-ax-tree-snapshot for comprehensive UI analysis
- Provides semantic structure and accessibility roles
- Helps identify accessibility issues and page hierarchy problems


Parameters:
- roles (array, optional): Optional role allowlist (button, link, textbox, checkbox, radio, combobox, switch, tab, menuitem, dialog, heading, listbox, listitem, option). If omitted, a built-in set of interactive roles is used
- includeStyles (boolean, optional): Whether to include computed CSS styles for each node (default: true)
- includeRuntimeVisual (boolean, optional): Whether to compute runtime visual information (bounding box, visibility, viewport) (default: true)
- checkOcclusion (boolean, optional): If true, checks whether each element is visually occluded by another element using elementFromPoint() sampled at multiple points (default: false)
- onlyVisible (boolean, optional): If true, only visually visible nodes are returned (default: false)
- onlyInViewport (boolean, optional): If true, only nodes intersecting the viewport are returned (default: false)
- textPreviewMaxLength (number, optional): Maximum length of the text preview extracted from each element (default: 80)
- styleProperties (array, optional): List of CSS computed style properties to extract (default: includes display, visibility, opacity, position, z-index, colors, fonts, etc.)

Returns:
- url (string): The current page URL at the time the AX snapshot was captured
- title (string): The document title of the page at the time of the snapshot
- axNodeCount (number): Total number of nodes returned by Chromium Accessibility.getFullAXTree before filtering
- candidateCount (number): Number of DOM-backed AX nodes that passed role filtering before enrichment
- enrichedCount (number): Number of nodes included in the final enriched snapshot output
- truncatedBySafetyCap (boolean): Indicates whether the result set was truncated by an internal safety cap
- nodes (array): List of enriched DOM-backed AX nodes combining accessibility metadata with visual diagnostics, including:
- axNodeId, parentAxNodeId, childAxNodeIds: Tree structure
- role, name, ignored: Accessibility properties
- backendDOMNodeId, domNodeId, frameId: DOM references
- localName, id, className, selectorHint: Element identification
- textPreview: Short preview of rendered text content
- styles: Computed CSS styles (if includeStyles is true)
- runtime: Visual diagnostics including boundingBox, isVisible, isInViewport, and optional occlusion data

Usage:
- Use to detect UI issues like elements that exist semantically but are visually hidden or off-screen
- Identify wrong layout/geometry, styling issues, and overlap/stacking/occlusion problems
- ALWAYS use checkOcclusion: true when investigating UI/layout problems
- Use alongside a11y_take-aria-snapshot tool for complete UI analysis


Parameters:
- pattern (string, required): Glob pattern matched against the full request URL (picomatch)
- modifications (object, optional): Request modifications to apply
- headers (object, optional): Headers to merge into the outgoing request headers
- body (string | object, optional): Override request body. If object/array, it will be JSON-stringified
- method (string, optional): Override HTTP method (e.g., POST, PUT)
- delayMs (number, optional): Artificial delay in milliseconds before continuing the request (default: 0)
- times (number, optional): Apply only N times, then let through. Omit for infinite

Returns:
- stubId (string): Unique id of the installed stub
- kind (string): Stub kind (always "intercept_http_request")
- pattern (string): Glob pattern used
- enabled (boolean): Whether the stub is enabled
- delayMs (number): Applied artificial delay in milliseconds
- times (number): Max applications (-1 means infinite)

Use cases:
- A/B testing / feature flags (inject headers)
- Security testing (inject malformed headers / payload)
- Edge cases (special characters, large payload)
- Auth simulation (add API keys / tokens in headers)

Notes:
- Pattern is a glob matched against the full request URL (picomatch)
- This modifies requests; it does not change responses
- Times limits how many times the interceptor applies (-1 means infinite)


Parameters:
- pattern (string, required): Glob pattern matched against the full request URL (picomatch)
- response (object, required): Mock response configuration
- action (enum, optional): "fulfill" or "abort" (default: "fulfill")
- status (number, optional): HTTP status code (used when action="fulfill", range: 100-599)
- headers (object, optional): HTTP headers for the mocked response
- body (string | object, optional): Response body. If object/array, it will be JSON-stringified
- abortErrorCode (string, optional): Playwright abort error code (used when action="abort"), e.g., "timedout"
- delayMs (number, optional): Artificial delay in milliseconds before applying the stub (default: 0)
- times (number, optional): Apply only N times, then let through. Omit for infinite
- chance (number, optional): Probability (0..1) to apply the stub per request (flaky testing)

Returns:
- stubId (string): Unique id of the installed stub (use it to clear later)
- kind (string): Stub kind (always "mock_http_response")
- pattern (string): Glob pattern used
- enabled (boolean): Whether the stub is enabled
- delayMs (number): Applied artificial delay in milliseconds
- times (number): Max applications (-1 means infinite)
- chance (number, optional): Apply probability (omit means always)
- action (string): Applied action ("fulfill" or "abort")
- status (number, optional): HTTP status (present when action="fulfill")

Use cases:
- Offline testing (return 200 with local JSON)
- Error scenarios (force 500/404 or abort with timedout)
- Edge cases (empty data / huge payload / special characters)
- Flaky API testing (chance < 1.0)
- Performance testing (delayMs)

Notes:
- Pattern is a glob matched against the full request URL
- Stubs are evaluated in insertion order; first match wins
- Times limits how many times the stub applies (-1 means infinite)


Returns:
- stubs (array): Array of installed stubs, each containing:
- id (string): Stub id
- kind (string): Stub kind ("intercept_http_request" or "mock_http_response")
- enabled` (boolean): Whether stub is en