cap-of-tea avatar

GDD - AI-Controlled Browser Farm

cap-of-tea/gdd

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 tools

Public 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.


View the full README on GitHub

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

Related Web & Browser Automation MCP servers

View all
10ics-srls avatarui-ticket-mcp0ics-srls/ui-ticket-mcp_publicHuman-to-AI code review bridge. Review UI in the browser, AI agents fix code via MCP.0stars
2virtualsms-io avatarSmsvirtualsms-io/mcp-serverReal SIM numbers for AI agents: SMS verification, rentals, proxies, cloud browser, x402 deposits.0stars
3tosin2013 avatarHelmdecktosin2013/helmdeckSelf-hosted MCP server: sandboxed browser, desktop, vision, code-edit packs for any agent.6stars
4ironclawdevs27 avatarArgusironclawdevs27/argusAutomated web QA via Chrome DevTools MCP — a11y, security, visual, env diff, CI; Aegis redaction.5stars
5enreign avatarPagerunner — The Browser Layer That Learnsenreign/pagerunnerReal Chrome profiles with site intelligence — already logged in, PII anonymization, sessions persist3stars
6kc23go avatarAnybrowsekc23go/anybrowseConverts any URL to clean, LLM-ready Markdown using real Chrome browsers3stars