Peekaboo MCP

--- summary: 'Review Model Context Protocol (MCP) in Peekaboo guidance' read_when: - 'planning work related to model context protocol (mcp) in peekaboo' - 'debugging or extending features described here' --- # Model Context Protocol (MCP) in Peekaboo This document explains how Peekaboo exposes its automation tools as an MCP server and how to start it from the CLI. ## Overview Peekaboo runs as an MCP server over stdio, exposing its native tools (image, see, click, etc.) to external MCP clients such as Claude Desktop or Cursor. Peekaboo no longer hosts or manages external MCP servers; configure your MCP client to launch `peekaboo mcp` directly. Supported transports: - **stdio**: supported and default. - **http / sse**: recognized flags, but server transports are not implemented yet. ## CLI usage Show help: ``` peekaboo mcp --help ``` Start the server (defaults to stdio): ``` peekaboo mcp ``` Explicit transport: ``` peekaboo mcp serve --transport stdio ``` ## Troubleshooting - Ensure Screen Recording + Accessibility permissions are granted (`peekaboo permissions status`). - If the MCP client cannot connect, confirm you are launching Peekaboo with `mcp` or `mcp serve` and that the client is using stdio transport.