WaveXisMCP

Generate a PDF via the low-level Page.printToPDF CDP method. Offers pixel-level control over paper size, margins, and print options beyond ``wavexis_pdf``. Use ``wavexis_pdf`` for simpler high-level PDF generation. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided; writes to ``output_path`` when given. Returns: JSON string with keys: 'status' ('ok'/'error'), 'type' ('pdf'), 'base64' (str) or 'path' (str), 'size_bytes' (int).

Capture the page as MHTML or a plain text document. Use ``wavexis_scrape`` for structured data extraction, or this tool when a full page archive (MHTML) or text dump is required. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided; writes to ``output_path`` when given. Returns: JSON string with keys: 'status' ('ok'/'error'), 'format' (str), 'content' (str) or 'path' (str), 'size_bytes' (int).

Generate a PDF document from a web page. Use ``wavexis_screenshot`` for image capture, or ``wavexis_page_pdf`` when pixel-level control over paper size and margins is required. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided, optionally evaluates ``js``; writes to ``output_path`` when given. Returns: JSON string with keys: 'status' ('ok'/'error'), 'base64' (str) or 'path' (str), 'size_bytes' (int).

Type a sequence of characters at the page level without targeting an element. Use ``wavexis_key_down``/``wavexis_key_up`` instead for individual modifier-key control, or ``wavexis_act`` for natural-language typing. Side effects: Dispatches keyDown/keyUp pairs to the browser page; no network requests. Returns: JSON string with keys: 'status' ('ok'/'error'), 'typed' (str).

Reload the current page, optionally bypassing the cache. Use to refresh stale content or retry a failed load; use wavexis_navigate to go to a different URL instead. Side effects: Re-issues network requests for the current page and its resources; discards in-memory page state. Returns: JSON string with keys: 'status' ('ok'/'error').

Right-click an element matching a CSS selector. Use wavexis_click for standard left clicks or wavexis_double_click for double clicks. Side effects: Fires a contextmenu event on the element, typically opening a context menu in the browser. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Scrape data from multiple URLs by evaluating a JS expression on each. Use ``wavexis_eval`` for single-page evaluation, or ``wavexis_scrape`` when the same expression must run across many pages with pagination. Side effects: launches/acquires a browser backend, navigates to each URL in ``urls`` sequentially, evaluates ``expression`` in every page context. Returns: JSON string with keys: 'status' ('ok'/'error'), 'results' (list[dict[str, Any]]), 'format' (str), 'count' (int), 'total' (int).

Capture a frame-by-frame screenshot sequence over a duration. Use ``wavexis_screenshot`` for a single still image, or ``wavexis_screencast`` when animation or time-series capture is needed. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided, captures frames for ``duration``; writes frame files to ``output_dir`` when given. Returns: JSON string with keys: 'status' ('ok'/'error'), 'frames' (list[str]) or 'dir' (str), 'count' (int).

Capture a screenshot of a web page or matched element. Use ``wavexis_pdf`` when a print-ready document is needed, or ``wavexis_annotated_screenshot`` when labelled element markers are required. Side effects: launches/acquires a browser backend, navigates to ``url`` if provided, optionally evaluates ``js``; writes to ``output_path`` when given. Returns: JSON string with keys: 'status' ('ok'/'error'), 'format' (str), 'base64' (str) or 'path' (str), 'size_bytes' (int).

Select an option in a ``<select>`` element by value. Use wavexis_fill for text inputs or wavexis_click for custom dropdown widgets that are not native ``<select>`` elements. Side effects: Changes the selected option of the ``<select>`` element, firing change and input events. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Close a browser session and release all associated resources. Call when the session is no longer needed to free memory and browser processes; use wavexis_close_tab to close individual tabs instead. Side effects: Terminates the browser process (or disconnects from a remote one) and frees session state. Destructive — all unsaved page state is lost. Returns: JSON string with keys: 'status' ('ok'/'error'), 'session_id' (str).

Query metadata and current URL of an active browser session. Use to inspect session health or retrieve the current page URL; use wavexis_list_tabs for tab-level details instead. Side effects: None — read-only; queries in-memory session state and the browser's current URL. Returns: JSON string with keys: 'status' ('ok'/'error'), 'session_id' (str), 'backend' (str), 'created_at' (str), 'current_url' (str).

Launch a persistent browser session for multi-step workflows. Call once at the start of a task and reuse the returned session_id for all subsequent calls; use wavexis_navigate with session_id omitted for one-off page fetches instead. Side effects: Launches a browser process (or connects to an existing one) and allocates server-side session state; may open network connections to remote/cloud browsers. Returns: JSON string with keys: 'status' ('ok'/'error'), 'session_id' (str), 'backend' (str).

Upload files to a file input element (``<input type="file">``). Use wavexis_drop when you need to simulate drag-and-drop of files or MIME data onto a non-file-input element. Side effects: Sets the selected files on the target file input element, firing change events that typically trigger upload logic. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Click an element inside a shadow DOM tree. Pierces shadow boundaries using the provided selector chain. Use wavexis_shadow_eval only for custom JS that click/fill cannot express. Side effects: Triggers click handlers and may navigate or mutate the shadow DOM. Returns: JSON string with keys: 'status' ('ok'/'error').

Evaluate a JavaScript expression inside a shadow DOM tree. Pierces shadow boundaries using the provided selector chain: ``selectors[0]`` is in the main document, ``selectors[1]`` in ``selectors[0].shadowRoot``, and so on. Use wavexis_shadow_click or wavexis_shadow_fill for standard interactions instead of raw JS. Side effects: Arbitrary; executes user-supplied JavaScript within the shadow DOM context. Returns: JSON string with keys: 'status' ('ok'/'error'), 'result' (any).

Fill an input element inside a shadow DOM tree with a value. Pierces shadow boundaries using the provided selector chain. Use wavexis_shadow_click to submit or activate the field after filling. Side effects: Mutates the input value within the shadow DOM; may trigger input/change events. Returns: JSON string with keys: 'status' ('ok'/'error').

Stop all pending navigations and resource loads in the session. Use when a page load is hanging or no longer needed; use wavexis_wait to wait for a load to complete instead. Side effects: Aborts in-flight network requests and pending navigations; the page is left in its current partial state. Returns: JSON string with keys: 'status' ('ok'/'error').

Tap an element matching a CSS selector (touch-emulated click). Use wavexis_click for mouse-based clicking on desktop contexts or wavexis_nl_click when you only have a natural language description. Side effects: Dispatches a touch tap on the target element, which may toggle controls or trigger navigation on mobile-optimised pages. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Type text into an element character by character with optional delay. Use wavexis_fill instead when you want to set a field's value instantly without per-keystroke delays, or wavexis_fill_form for multiple fields. Side effects: Appends characters to the target input/textarea element, firing keydown/keypress/input/keyup events per character. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Uncheck a checkbox matching a CSS selector by clicking it. Use wavexis_check to check a checkbox or wavexis_click for generic element activation. Side effects: Clicks the target checkbox to toggle it to unchecked, firing change events. Returns: JSON string with keys: 'status' ('ok'/'error'). On error also 'error', 'tool', 'type', 'message', 'suggestion' (all str).

Block until a page condition (load, selector, URL, network idle) is met. Use after wavexis_navigate when the wait strategy was 'none', or to wait for dynamic content; use wavexis_stop to cancel a load instead. Side effects: None — read-only polling with no page mutations; blocks the tool call up to the configured timeout. Returns: JSON string with keys: 'status' ('ok'/'error'), 'elapsed_ms' (int).