Capture a screenshot of the webview page (or a specific element by ID). Uses CDP (edgechromium/qt renderer). Call this first to orient yourself.

Get the DOM tree of the page as JSON. Each element has: id, tag, html_id, class, role, text, visible, bounds, children. Use element IDs from this tree in other tools.

Get detailed properties of a specific DOM element by MCP id.

Get app-level state: page title, URL, focus element, pywebview platform.

Search DOM elements by CSS selector, tag, html id, ARIA role, text, or visibility. Examples: find_element(selector="#launch-btn") find_element(text="Launch") find_element(role="button")

Click an element or page coordinate.

• element_id only: clicks the center of that element

• element_id + x/y: clicks at offset within element bounds

• x/y only: clicks at viewport coordinates

Double-click an element.

Type text into an input element (focuses it first).

Press a key on the focused element. Named keys: enter, escape, tab, backspace, delete, arrows, space, home, end, f1–f6.

Scroll the page or an element. dy > 0 scrolls down.

Get the last n Python logging records from the app.

Get the last n lines of the launched app's stdout/stderr. Only works for apps started via launch_app on this server.

Evaluate Python in the app process. Context: window, webview, api (js_api object). WARNING: debugging only.

Execute JavaScript in the webview page and return the result.

Call a js_api method directly on the Python object exposed to the page. Example: call_api("get_state") when the app exposes state via js_api.

Return how to call launch_app — especially the script parameter.

Call this before launch_app when you are unsure which entry .py to use or whether script should include a subfolder path.

Launch a pywebview app with the MCP bridge injected, then wait until the UI is ready.

Wait until DOM is ready and pywebview API is available.

Wait until the page has been quiet (no DOM mutations) for quiet_ms.

Report process + bridge health; detect likely native dialog blocks.

List clickable buttons, links, and role=button elements.

Click a button/link by html id (name) or visible text without DOM traversal.

Stop a previously launched app (started via launch_app).