
GDD - AI-Controlled Browser Farm
Runs a local fleet of isolated Chromium instances that Claude can orchestrate through 36 MCP tools. You get parallel browser control across 22 device profiles (iPhone 15 Pro, Desktop 1080p, etc.), each with separate cookies, console access, and network conditions. The tools cover navigation, element interaction (tap, type, scroll), screenshots, console log extraction, and device emulation. Think testing a responsive signup flow on three phones and a desktop simultaneously, or scraping content that requires different geolocations and user agents. Connects via HTTP on localhost:9700, so it works with Claude Code, Cursor, and VS Code based IDEs. Available as standalone binaries for Linux, macOS, Windows, or a Docker image with Chromium pre installed.
- GitHub stars
- 10
- tools
- 39
- transport
- STDIO
- last updated
- May 20, 2026
Tools
39 toolsPublic tool metadata for what this MCP can expose to an agent.
gdd_add_playersAdd N browser instances with optional device preset
Add N browser instances with optional device preset
No parameter schema in public metadata yet.
gdd_remove_playerRemove a browser instance by player ID
Remove a browser instance by player ID
No parameter schema in public metadata yet.
gdd_list_windowsList all active browsers with current state
List all active browsers with current state
No parameter schema in public metadata yet.
gdd_navigateNavigate to a URL
Navigate to a URL
No parameter schema in public metadata yet.
gdd_waitWait for a CSS selector to appear (with timeout)
Wait for a CSS selector to appear (with timeout)
No parameter schema in public metadata yet.
gdd_reloadReload page (`hard=true` bypasses cache)
Reload page (`hard=true` bypasses cache)
No parameter schema in public metadata yet.
gdd_backNavigate back
Navigate back
No parameter schema in public metadata yet.
gdd_forwardNavigate forward
Navigate forward
No parameter schema in public metadata yet.
gdd_tapTap element by CSS selector or coordinates; sends a single device-appropriate input (touch on touch devices, mouse on desktop), never both. `humanize=true` adds a continuous human-like cursor path
Tap element by CSS selector or coordinates; sends a single device-appropriate input (touch on touch devices, mouse on desktop), never both. `humanize=true` adds a continuous human-like cursor path
No parameter schema in public metadata yet.
gdd_swipeSwipe gesture (up/down/left/right)
Swipe gesture (up/down/left/right)
No parameter schema in public metadata yet.
gdd_dragDrag an element to (x, y) or onto another element via real pointer events (drives dnd-kit & HTML5 drag-and-drop)
Drag an element to (x, y) or onto another element via real pointer events (drives dnd-kit & HTML5 drag-and-drop)
No parameter schema in public metadata yet.
gdd_scrollScroll page or element
Scroll page or element
No parameter schema in public metadata yet.
gdd_typeType text with real, trusted keystrokes (CDP dispatchKeyEvent — masks, autocomplete and maxlength behave as for a real user; works on contenteditable). Physical key codes follow the emulated layout (US/RU/DE/FR); `humanize=true` adds per-key jitter; `paste=true` inserts in one...
Type text with real, trusted keystrokes (CDP dispatchKeyEvent — masks, autocomplete and maxlength behave as for a real user; works on contenteditable). Physical key codes follow the emulated layout (US/RU/DE/FR); `humanize=true` adds per-key jitter; `paste=true` inserts in one...
No parameter schema in public metadata yet.
gdd_pressPress a single key or shortcut (Enter, Tab, Escape, Arrow keys, F1–F12, or a character) with optional modifiers (Control/Alt/Shift/Meta); character keys follow the emulated layout
Press a single key or shortcut (Enter, Tab, Escape, Arrow keys, F1–F12, or a character) with optional modifiers (Control/Alt/Shift/Meta); character keys follow the emulated layout
No parameter schema in public metadata yet.
gdd_hoverHover over element. `humanize=true` adds a continuous human-like cursor path
Hover over element. `humanize=true` adds a continuous human-like cursor path
No parameter schema in public metadata yet.
gdd_selectSelect option from `<select>` dropdown
Select option from `<select>` dropdown
No parameter schema in public metadata yet.
gdd_dialogHandle JS alert/confirm/prompt dialogs
Handle JS alert/confirm/prompt dialogs
No parameter schema in public metadata yet.
gdd_readRead text content of an element
Read text content of an element
No parameter schema in public metadata yet.
gdd_read_allRead text from all matching elements
Read text from all matching elements
No parameter schema in public metadata yet.
gdd_screenshotCapture JPEG screenshot at CSS pixel resolution
Capture JPEG screenshot at CSS pixel resolution
No parameter schema in public metadata yet.
gdd_set_deviceSet device preset (22 devices: phones, tablets, desktops)
Set device preset (22 devices: phones, tablets, desktops)
No parameter schema in public metadata yet.
gdd_set_viewportSet custom viewport dimensions
Set custom viewport dimensions
No parameter schema in public metadata yet.
gdd_set_locationSet geolocation, timezone, and locale
Set geolocation, timezone, and locale
No parameter schema in public metadata yet.
gdd_set_networkSet network conditions (4G, 3G, offline)
Set network conditions (4G, 3G, offline)
No parameter schema in public metadata yet.
gdd_set_languageSet browser language
Set browser language
No parameter schema in public metadata yet.
gdd_set_headersRewrite response headers — strip X-Frame-Options/CSP to allow framing
Rewrite response headers — strip X-Frame-Options/CSP to allow framing
No parameter schema in public metadata yet.
gdd_get_stateBrowser state: URL, title, device, auth status
Browser state: URL, title, device, auth status
No parameter schema in public metadata yet.
gdd_get_consoleConsole output and uncaught exceptions
Console output and uncaught exceptions
No parameter schema in public metadata yet.
gdd_get_networkNetwork requests with timing and status
Network requests with timing and status
No parameter schema in public metadata yet.
gdd_get_notificationsReceived push notifications
Received push notifications
No parameter schema in public metadata yet.
gdd_get_performancePerformance metrics (JS heap, DOM nodes, FPS)
Performance metrics (JS heap, DOM nodes, FPS)
No parameter schema in public metadata yet.
gdd_clear_logsClear console and/or network logs
Clear console and/or network logs
No parameter schema in public metadata yet.
gdd_quick_authAuto-register and login with generated credentials
Auto-register and login with generated credentials
No parameter schema in public metadata yet.
gdd_execute_jsExecute JavaScript and return result
Execute JavaScript and return result
No parameter schema in public metadata yet.
gdd_storageRead/write/clear localStorage/sessionStorage
Read/write/clear localStorage/sessionStorage
No parameter schema in public metadata yet.
gdd_cookiesRead or clear browser cookies
Read or clear browser cookies
No parameter schema in public metadata yet.
gdd_get_manualFull GDD manual for AI self-learning
Full GDD manual for AI self-learning
No parameter schema in public metadata yet.
gdd_check_updateCheck for newer versions
Check for newer versions
No parameter schema in public metadata yet.
gdd_updateDownload and install update (restarts GDD)
Download and install update (restarts GDD)
No parameter schema in public metadata yet.
Sponsors
Readme
GDD
GDD — Giggly-Dazzling-Duckling
AI-controlled browser farm on your machine
Simulate multiple real users across 22 device types — test your site like it's launch day.
Details
- Repository
- github.com/cap-of-tea/gdd
- Website
- github.com/Cap-of-tea/GDD
- Category
- Web & Browser Automation
- Package
ghcr.io/cap-of-tea/gdd:1.5.0- Transport
- STDIO
- Registry
- MCP registry, active