Capture a screenshot of the full screen or a specific display.

Parameters:

• display: Display number (0 = all displays combined, 1 = main, 2 = secondary). Default 0.

• max_size: Maximum pixel dimension for the largest side. Default 800. Smaller = faster + fewer tokens. Use 400 for quick checks, 1200 for detail.

Returns the screenshot as an Image. Requires Screen Recording permission in macOS System Settings.

Capture a screenshot of a specific window by its title.

Searches for a window whose title contains the given text (case-insensitive). Also matches against application name. Use list_windows() first to see available windows.

Parameters:

• window_title: Full or partial window title to match (e.g., "Firefox", "Terminal", "Blender"). Also matches application names.

• max_size: Maximum pixel dimension for the largest side. Default 800.

Returns the screenshot as an Image. If no match is found, returns an error listing available windows.

Capture a specific rectangular region of the screen.

Parameters:

• x: Left edge coordinate in pixels (0 = left edge of screen).

• y: Top edge coordinate in pixels (0 = top edge of screen).

• width: Width of the region in pixels.

• height: Height of the region in pixels.

• max_size: Maximum pixel dimension for the output. Default 800.

Use capture_screen first to see the full screen and identify coordinates. Returns the captured region as an Image.

Capture a screenshot of a web page using a headless browser.

Useful for capturing local dev servers (localhost), web apps, or any URL. The browser launches on first use and stays running for subsequent captures.

Parameters:

• url: The URL to capture (e.g., "http://localhost:3000", "https://example.com").

• viewport_width: Browser viewport width in pixels. Default 1280.

• viewport_height: Browser viewport height in pixels. Default 720.

• max_size: Maximum pixel dimension for the output. Default 800.

• full_page: If true, capture the entire scrollable page. Default false.

• wait_for_selector: Optional CSS selector to wait for before capturing (e.g., "#main-content", ".loaded"). Leave empty to skip.

Returns the web page screenshot as an Image.

Compare two screenshots and describe visual differences.

Analyzes pixel differences between two images and reports the percentage of changed pixels and the region of change.

Useful for:

• Verifying UI changes after code edits

• Checking before/after visual regression

• Confirming rendering output differences

Parameters:

• image_path_1: Absolute path to the first (baseline) image.

• image_path_2: Absolute path to the second (comparison) image.

• max_size: Maximum pixel dimension for analysis. Default 800.

Returns a text description of the differences found.

List all open windows with their application names and titles.

Use this to find the correct window title before calling capture_window_tool. Returns a formatted list showing 'Application | Window Title' for each open window.

No parameters required.