GDD AI Controlled Browser Farm

What GDD - AI-Controlled Browser Farm does

GDD - AI-Controlled Browser Farm MCP server exposes an HTTP MCP endpoint for operating multiple isolated Chromium instances. Each browser instance has its own profile, cookies, device settings, geolocation, and network conditions. Agents can create and remove browser instances, address each one by player ID, and inspect the current collection with its active state.

The server is suited to browser-based application testing and scripted interaction. An agent can open a site, complete forms, trigger touch or mouse interactions, capture screenshots, and inspect page output. Multiple browsers can be configured with different device presets so the same workflow can be checked across phones, tablets, and desktops.

How it works

GDD starts a headless or headed browser-control service and listens on port 9700 by default. MCP clients connect to http://localhost:9700/mcp. The agent first creates one or more players, optionally selecting a device preset, then passes the relevant player ID to navigation, input, reading, and diagnostic tools.

Input actions use browser-level events. Tapping chooses touch or mouse input according to the emulated device, while typing sends trusted key events and supports contenteditable elements. Optional humanization adds cursor paths or per-key timing variation. Dragging uses real pointer events and can target coordinates or another element. Page state can be checked through text reads, screenshots, console output, network details, notifications, and the current URL or title.

Setup and configuration

Download the server package for Windows, Linux, or macOS, or run the published Docker image. The server can also be installed for Claude Desktop through the provided .mcpb package. Linux, macOS, and Windows packages include platform-specific launch instructions; Chromium dependencies are included in the Docker image.

Start the binary directly, or add --headless for CI/CD environments. Other documented flags include --stealth, --stealth-max, --update, --version, and --help. Connect an MCP client with an HTTP server entry pointing to http://localhost:9700/mcp. Client configuration changes require restarting the client session.

GDD - AI-Controlled Browser Farm can alternatively be launched through the repository's Windows, Linux, or macOS stdio proxy scripts. The desktop edition is separate from the headless server and provides a browser-thumbnail grid for manually taking over sessions.

Tools and capabilities

The listed tools cover:

• Creating, removing, listing, and inspecting browser instances.
• Navigating, reloading, going backward or forward, and waiting for CSS selectors.
• Tapping, swiping, dragging, scrolling, hovering, typing, pressing keys, selecting options, and handling JavaScript dialogs.
• Reading one or many matching elements and capturing JPEG screenshots.
• Applying device presets, viewport dimensions, location, timezone, locale, language, and network conditions.
• Reading console output, uncaught exceptions, network requests, request timing, status codes, and push notifications.
• Rewriting response headers to remove framing restrictions such as X-Frame-Options and CSP.

Limitations and notes

The server uses port 9700, while the optional desktop application uses port 9800. By default, browsers launch in headed mode, so headless operation must be selected for display-free environments.

Claude Code asks for confirmation on each MCP tool call by default; its documented permission setting can allow the GDD tool namespace without repeated prompts. The material does not specify authentication or remote-access controls for the HTTP endpoint, so deployment beyond the local machine should be evaluated separately.