Peekaboo MCP

{ "description": "Captures screen content and optionally analyzes it. Targets entire screens, specific app windows, or all windows of an app (via `app_target`). Supports foreground/background capture. Output to file path or inline Base64 data (`format: \"data\"`). If a `question` is provided, an AI model analyzes the image. Window shadows/frames excluded.", "properties": { "app_target": { "description": "Optional. Specifies the capture target.\nFor example:\nOmit or use an empty string (e.g., `''`) for all screens.\nUse `'screen:INDEX'` (e.g., `'screen:0'`) for a specific display.\nUse `'frontmost'` for all windows of the current foreground application.\nUse `'AppName'` (e.g., `'Safari'`) for all windows of that application.\nUse `'PID:PROCESS_ID'` (e.g., `'PID:663'`) to target a specific process by its PID.\nUse `'AppName:WINDOW_TITLE:Title'` (e.g., `'TextEdit:WINDOW_TITLE:My Notes'`) for a window of 'AppName' matching that title.\nUse `'AppName:WINDOW_INDEX:Index'` (e.g., `'Preview:WINDOW_INDEX:0'`) for a window of 'AppName' at that index.\nEnsure components are correctly colon-separated.", "type": "string" }, "capture_focus": { "default": "auto", "description": "Optional. Focus behavior. 'auto' (default): bring target to front only if not already active. 'background': capture without altering window focus. 'foreground': always bring target to front before capture.", "enum": [ "background", "auto", "foreground" ], "type": "string" }, "format": { "description": "Optional. Output format.\nCan be `'png'`, `'jpg'`, `'jpeg'` (alias for jpg), or `'data'`.\nFormat is case-insensitive (e.g., 'PNG', 'Png', 'png' are all valid).\nIf `'png'` or `'jpg'`, saves the image to the specified `path`.\nIf `'data'`, returns Base64 encoded PNG data inline in the response.\nIf `path` is also provided when `format` is `'data'`, the image is saved (as PNG) AND Base64 data is returned.\nDefaults to `'data'` if `path` is not given.\nInvalid format values automatically fall back to 'png'.", "enum": [ "png", "jpg", "data" ], "type": "string" }, "path": { "description": "Optional. Base absolute path for saving the image.\nRelevant if `format` is `'png'`, `'jpg'`, or if `'data'` is used with the intention to also save the file.\nIf a `question` is provided and `path` is omitted, a temporary path is used for image capture, and this temporary file is deleted after analysis.", "type": "string" }, "question": { "description": "Optional. If provided, the captured image will be analyzed by an AI model.\nThe server automatically selects an AI provider from the `PEEKABOO_AI_PROVIDERS` environment variable.\nThe analysis result (text) is included in the response.", "type": "string" } }, "required": [ "path", "format" ], "type": "object" }