Capture a screenshot of the app window (or a specific widget by ID). Returns the image so you can see the current UI state. Call this first to orient yourself.

Get the full widget hierarchy of all visible windows as JSON. Each widget has: id, class, object_name, visible, enabled, geometry, text, children. Use widget IDs from this tree in other tools.

Get detailed properties and state of a specific widget. Includes geometry, text, enabled/visible state, and dynamic Qt properties.

Get app-level state: active window, focused widget, screen info. Useful to understand focus before sending keyboard events.

Search for widgets by class, objectName, text content, or visibility. Returns a list of matching widgets with their IDs. Examples: find_widget(class_name="QPushButton") find_widget(text="Apply Mods") find_widget(object_name="enabledCheckBox")

Click a widget or screen coordinate.

• widget_id only: clicks the center of that widget

• widget_id + x/y: clicks at (x, y) relative to the widget's top-left

• x/y only: clicks at (x, y) relative to the main window button: 'left' (default), 'right', or 'middle'

Double-click a widget. Sends two rapid left-clicks.

Type text into a widget (focuses it first) or the currently focused widget. For special characters use press_key instead.

Press a key on the currently focused widget. Named keys: enter, return, escape, tab, backtab, backspace, delete, up, down, left, right, space, home, end, pageup, pagedown, f1–f6 Single characters: pass the character directly, e.g. 'a', 'A', '1'

Scroll a widget. dy > 0 scrolls down, dy < 0 scrolls up. dx: horizontal scroll (positive = right). widget_id: target widget; omit to scroll the main window.

Get the last n log messages captured from the app's Python logging system. Includes timestamp, level, logger name, and message.

Get the last n lines of the launched app's real stdout/stderr: print() output, uncaught tracebacks, and Qt/console warnings.

This is the app's actual console output, captured because launch_app redirects it to a log file. Use this to debug crashes or startup failures. For structured Python logging records use get_logs() instead.

Only works for apps started via launch_app on this server.

Evaluate a Python expression or execute a statement inside the app process. Context provides:

• app: QApplication instance

• widgets: dict mapping widget_id → QWidget Examples: eval_python("app.activeWindow().windowTitle()") eval_python("widgets['3'].isEnabled()") eval_python("list(app.allWidgets())") WARNING: runs arbitrary code in the app — use only for debugging.

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 PySide6 app with the MCP bridge injected, then wait until the UI is ready.

Wait until the app UI is ready: a visible top-level window that has been quiet (no layout/paint activity) for quiet_ms milliseconds.

Use after an action that reloads or rebuilds the UI. Returns the readiness snapshot. Does not launch anything — the app must already be running.

Wait until the app's UI has been quiet (no layout/paint activity) for quiet_ms ms, or until timeout seconds elapse. Call after a click or action that triggers async work, before taking a screenshot.

Report combined health of a launched app: whether the process is alive, its exit code, whether the bridge responds, and whether the main thread is likely blocked by a modal dialog (process alive but bridge unresponsive).

List all QActions (menu items, toolbar actions) in visible windows with their name, text, shortcut, and enabled/checked state.

Trigger a QAction directly by objectName (name) or visible label (text), without clicking through menus. Useful to avoid opening modal menus and to reach toolbar/menu actions reliably. Provide at least one of name/text.

List apps launched by this MCP server. Each entry is {pid}. Pass pid= to other tools when more than one app is running.

Stop a previously launched app (started via launch_app). Omit pid to stop the last launched app.