ZenLink MCP

Close a browser window by ID (from zen_windows).

Return computed CSS for an element. Defaults to the layout-relevant set.

Return buffered console logs from a tab (requires zen_watch_console first).

Cookie operations: "get", "set", "remove", "clear". - get: returns matching cookies (use url/domain/name to filter). - set: requires url + name + value. - remove: requires url + name. - clear: clears all cookies for url or domain.

Open a new browser window. Pass a URL to load it at start.

Delete a saved session file.

Pop a tab out into its own new window.

Get the accessibility tree of interactive elements on the page. Args: tab_id: Optional tab to target. Defaults to active tab.

Dispatch a synthetic double-click on the matched element.

Downloads operations. Args: op: "download" | "list" | "cancel". url: For "download", the URL to fetch. filename: Optional output filename. query: For "list", a downloads.search query dict.

Synthetic drag-and-drop from one element to another (HTML5 drag events).

Duplicate a tab. Returns the new tab id.

Screenshot a single element. Scrolls into view, captures, crops in the extension via OffscreenCanvas. Saves a PNG and returns its path (saved_to). Args: selector: CSS selector of the element tab_id: Optional tab to target. Defaults to active tab. save_to: Optional file path (default: ~/claude-zen-screenshots/element_<time>.png) data_url: Also return the PNG data URL (large - only if you really need the bytes inline) scale: 1-4 output pixels per CSS pixel. 2 = genuinely sharper capture at twice the size (needs extension 2.1.1+; older extensions ignore it)

Diagnose a CSS selector: match count, sample matches, suggestions for a more-specific selector if you got too many.

Set a form field's value directly (faster than typing). Args: selector: CSS selector of the input/select element value: Value to set tab_id: Optional tab to target. Defaults to active tab.

Find elements on the page using natural language description. Args: query: What to find (e.g. "login button", "search bar", "email input") tab_id: Optional tab to target. Defaults to active tab.

Move focus to the matched element.

Bring a browser window to the foreground.

Fill many fields at once via fuzzy matching. Each key in `fields` is matched as: CSS selector → name attribute → label text (case-insensitive contains) → placeholder. Each value is applied via the appropriate setter (.value for inputs/textareas, .checked for checkboxes/radios, value for selects). Returns per-key results. Args: fields: {"email": "foo@bar", "Password": "...", "#submit-target": true}

Get all form fields on the current page with their labels and values. Args: tab_id: Optional tab to target. Defaults to active tab.

Go forward in history.

Return document/viewport sizes + scroll position + devicePixelRatio.

Scroll-and-stitch screenshot covering the full document height (up to 30 viewports tall). Saves one PNG of the entire page and returns its path (saved_to). Args: tab_id: Optional tab to target. Defaults to active tab. save_to: Optional file path (default: ~/claude-zen-screenshots/fullpage_<time>.png) data_url: Also return the PNG data URL (large)

Return the active URL/readonly policy.

Return the current zoom factor (1.0 = 100%).

Extended health/status: bridge version, ports, keep-alive list, pool state, tags, policy, sessions dir, audit/log sizes.

Highlight an element on the page with a visual overlay. Args: selector: CSS selector of the element to highlight tab_id: Optional tab to target. Defaults to active tab.

Hover over an element on the page. Args: selector: CSS selector of the element to hover over tab_id: Optional tab to target. Defaults to active tab.

Return the outerHTML of a specific element. Cap 100KB.

List all iframes with src + same-origin/accessible flags.

Return every <img> with src, alt, and natural dimensions.

Block, log, or redirect HTTP requests by URL regex. Useful to suppress analytics/ads during agent runs (3–10× page speed-up) or to log what an SPA actually fetches. Args: op: "add" | "clear" | "list" | "log" | "clearLog". patterns: For "add", regex patterns to match against request URLs. effect: For "add", "block" (cancel request) or "redirect".

Execute JavaScript in the current page context. Args: code: JavaScript code to run (e.g. "document.title" or "document.querySelectorAll('a').length") tab_id: Optional tab to target. Defaults to active tab. full: Results are capped at 8 MB (50 KB on extensions older than 2.1.0). full=True runs the code once and reads the result back in slices, so any size comes back complete.

Keep tabs warm so Zen's Tab Unloader won't discard them mid-workflow. Starts a background pinger in the bridge that fires a no-op JS evaluation at each listed tab on the given interval. Any script access resets Zen's idle timer, so the tabs stay loaded. Replaces any existing keep-alive for the same tabs (use a new interval to change cadence). Use this at the start of parallel multi-tab work: open your tabs, call zen_keep_alive with their IDs, drive them in parallel via zen_parallel or by passing tab_id to individual commands, then zen_keep_alive_stop when done. The pinger auto-stops if the b…

Stop the keep-alive pinger for some or all tabs. Args: tab_ids: Tabs to stop pinging. Omit (or pass null) to stop all.

Dispatch a synthetic keyboard event. Use modifiers like `{"ctrl": True, "shift": True}`. Pass `text` to also insert characters into editable targets. Args: key: Key name, e.g. "Enter", "Tab", "Escape", "ArrowDown", "a". selector: Optional element to target. Defaults to document.activeElement. modifiers: {"ctrl"|"shift"|"alt"|"meta": True}. text: If set, also insert this text into editable targets.

Return every anchor with href + text. Useful as a crawler primitive.

List saved sessions with their metadata.

List all tag → tab id mappings.

Restore cookies + localStorage from a previously saved session.

Return recent bridge log lines (in-memory ring buffer).

Convert the page (or a selector subtree) to Markdown. Cap 80KB.

Return all meta tags + link rels (canonical, RSS, icons, etc.).

Move a tab to a position (and optionally to a different window). -1 = end.

Mute or unmute a tab.

Navigate the active tab to a URL. Args: url: The URL to navigate to (e.g. "https://example.com") tab_id: Optional tab to navigate. Defaults to active tab. raw: Bare image URLs (.jpg/.png/...) open inside a small local viewer page (image = #zlimg) so the extension can still script them. True opens the raw image.

Open a new browser tab. Args: url: URL to open in the new tab (default: blank page) raw: Bare image URLs open inside a local viewer page (image = #zlimg) unless raw=True.

Get current page URL, title, dimensions, and scroll position. Args: tab_id: Optional tab to target. Defaults to active tab.

Extract all readable text from the current page. Args: tab_id: Optional tab to target. Defaults to active tab. For non-active tabs, prefer this with tab_id over zen_page_text_by_tab_id — they do the same thing now.

Get page text from a specific tab by ID without switching to it. Args: tab_id: The tab ID to read from (get IDs from zen_tabs) Returns the full visible text content of the specified tab.

Run command sequences in parallel — typically one sequence per tab. Each inner list is a sequence that runs serially; all sequences run concurrently. Commands that target a specific tab (navigate, switchTab, or any tab-aware action) MUST include "tabId" inside the parallel batch to avoid race conditions over the active tab. Returns a list of result lists, one per input sequence. Args: sequences: List of command sequences. Each command is a dict with "action" and parameters — same shape as zen_batch commands. Example for driving two tabs at once: [ …

Pin or unpin a tab.

Check out a warm tab from the pool. Returns its tab_id.

Return a tab to the pool for reuse.

Extract multiple fields from every element matching a CSS selector. Much faster and cheaper than calling zen_js per element. The default fields cover the common ones (text, href, value, src, alt, id, name); pass `fields=["text","data-foo","bounds","attrs"]` to get arbitrary attributes or `bounds`/`attrs`/`html` extras. Args: selector: CSS selector. fields: Field names to extract per element. Defaults to a useful set. limit: Max elements to return (capped at 500). tab_id: Optional tab; defaults to active.

Extract the main article on the page (title, byline, clean text). Heuristic: score candidate containers (`article`, `main`, `.post`, etc.) by text density × paragraph count × inverse link density, strip nav/aside, return the winner. Falls back to densest section/div, then body.

Hot-reload the ZenLink extension in the browser. Use this after editing the extension source to pick up changes without going through `about:addons` and toggling the extension by hand. The extension acks the request, then reloads itself ~100ms later; the background script's existing reconnect logic re-establishes the bridge WebSocket immediately. Content scripts in open tabs survive — they re- inject lazily on the next command (see forwardToContent in background.js). Note: only works once you're already on a version of the extension that has this action handler. The very first install of tha…

Reload a tab. Pass `bypass_cache=True` for a hard reload.

Look up the tab id for a tag set via zen_tag_tab.

Wrap any command in exponential-backoff retry. Args: command: A command dict (same shape as zen_batch entries). max_attempts: Total tries including the first. backoff_ms: Initial wait between attempts (doubles each retry). on_errors: Only retry if the error string contains one of these substrings. Default: retry on any error.

Snapshot cookies (and per-origin localStorage if urls given) to disk. Use case: log into a service interactively once, save the session, then have parallel agents load it for authenticated work. Args: name: A label for the session (becomes filename under ~/claude-zen-sessions/). urls: Origins whose cookies + localStorage to snapshot. Each gets opened briefly in a temp tab so localStorage can be read.

Return bridge scheduler state for multi-agent/tab work. Shows active per-tab/global command scopes, pending WebSocket commands, and known tab locks. Useful when several agents are driving separate tabs.

Capture a screenshot of the current page. Returns the saved file path. Note: screenshots are inherently visual and capture the active tab of the focused window. To screenshot a specific tab, switch to it first with zen_switch_tab.

Scroll the page. Args: direction: Scroll direction - "up", "down", "left", or "right" amount: Pixels to scroll tab_id: Optional tab to target. Defaults to active tab.

Choose an <option> in a <select>. Default matches by value; pass `by_text=True` to match by visible text.

Set text or HTML in a contenteditable editor, input, or textarea in one fast operation. Use this for rich editors such as Gmail compose bodies where typing long text is slow. Args: selector: CSS selector or ZenLink ref for the editable element value: Text or HTML to place into the editor format: "text" for plain text or "html" for trusted HTML clear: Whether to replace existing content instead of appending tab_id: Optional tab to target. Defaults to active tab.

Set URL allow/deny regex lists and/or read-only mode. Read-only mode blocks write actions (click/type/navigate/cookies set/etc.) while still allowing read ops. Useful for "let the agent observe only."

Set zoom factor. 0.3 to 5.0 typical; 1.0 = 100%.

Check if ZenLink bridge and browser extension are connected.

localStorage / sessionStorage ops. Args: kind: "local" or "session". op: "get" | "set" | "remove" | "clear" | "list" | "snapshot" | "restore". key: Required for get/set/remove. value: For set, the string value. For restore, a dict of key→value. tab_id: Tab to run against. Storage is per-origin, so prefer driving it on a tab already at the right origin.

Extract JSON-LD blocks, OpenGraph (og:*), and Twitter card meta.

Submit a form. If selector is omitted, submits the first <form> found.

Switch focus to a specific browser tab. Args: tab_id: The tab ID to focus (get IDs from zen_tabs)

Block until a JS predicate returns truthy on every listed tab. Replaces hand-rolled "wait for everything to be ready" loops. Args: tab_ids: Tabs to monitor. predicate: JS expression that returns truthy when the tab is ready, e.g. "!!document.querySelector('.results')". timeout: Overall timeout in ms. poll_interval: Per-poll interval in ms.

Maintain a warm pool of N tabs always ready to be acquired. Grows or shrinks to `size`. Acquire/release via zen_pool_acquire and zen_pool_release. Auto-grows by one if you acquire from an empty pool.

List all open browser tabs with their IDs, titles, and URLs.

Give a tab a memorable name. Refer to it later via zen_resolve_tag. Names survive bridge restarts only if you re-tag — they live in memory.

Click using the real OS mouse pointer for pages that reject synthetic DOM events. This is slower and moves the user's cursor, so prefer zen_click unless a page specifically ignores synthetic clicks. Args: selector: CSS selector to click. If provided, ZenLink clicks its center. x: X coordinate, used if selector is empty. y: Y coordinate, used if selector is empty. coordinate_space: "viewport" for browser viewport coords or "screen" for desktop coords. focus: Whether to try to foreground the browser first. Defaults to false. tab_id: Optional tab to resolve the selector …

Type text into an input field. Args: selector: CSS selector of the input element text: Text to type clear: Whether to clear existing text first tab_id: Optional tab to target. Defaults to active tab.

Remove a tag.

Attach local file(s) to a page's upload control - no OS file dialog. The bridge reads the file from disk and streams it into the page, which builds real File objects and sets them on the <input type=file> (firing input + change). If the selector is a drop zone with no input inside, it fires dragenter/dragover/drop. Args: path: absolute file path, or a list of paths for multi-file inputs. selector: the file input, an element containing it, or a drop zone. Omit to use the first input[type=file] on the page. mode: "auto" (input if found, else drop), "input", or "drop".…

Wait for a CSS selector to appear and become visible on the page. Returns immediately when the element is found, rather than sleeping a fixed duration. Use this instead of sleep when waiting for dynamic/JS-rendered content. Args: selector: CSS selector to wait for (e.g. ".tracking-events", "#results", "[data-loaded]") timeout: Maximum time to wait in milliseconds (default: 10000 = 10s) poll_interval: How often to check in milliseconds (default: 200ms) tab_id: Optional tab to target. Defaults to active tab.

Wait until no new network resources have started for `idle_ms`.

Poll a JavaScript expression until it returns a non-empty result. Args: code: JavaScript expression to evaluate repeatedly timeout: Maximum time to wait in milliseconds poll_interval: How often to check in milliseconds tab_id: Optional tab to target. Defaults to active tab.

Wait until document.title matches a JS regex pattern.

Wait until the tab's URL matches a JS regex pattern.

Revive a tab that Zen's Tab Unloader may have discarded. Zen aggressively unloads inactive tabs to save RAM. An unloaded tab still appears in zen_tabs but has no live content script — commands targeting it will hang or fail until it's reloaded. zen_wake_tab is idempotent: if the tab is already alive it returns immediately; otherwise it reloads the tab and waits for the page to finish loading. Use before targeting a tab that might have been idle for a while. Prefer zen_keep_alive for tabs you'll touch repeatedly. Args: tab_id: The tab ID to wake (get IDs from zen_tabs)

Toggle console capture on a tab. Once enabled, browser console messages (log/info/warn/error/debug + window errors) are buffered up to 500 entries; retrieve via zen_console_logs.

List all open browser windows with their tabs.

Execute a named ZenLink workflow from the bridge workflow directory. Args: name: Workflow file name without .md variables: Optional template variables for the workflow

List available named ZenLink workflows from the bridge workflow directory.

Extract HTML widget content from a WordPress Elementor page. Navigates to the Elementor editor for the given page, waits for load, then extracts the innerHTML of all HTML widgets from the Elementor preview iframe. Returns clean HTML/CSS/JS content. The browser must already be logged into WP admin for this to work. Args: site_url: WordPress site URL (e.g. "https://thankyouexperiences.com") page_id: WordPress page/post ID (e.g. 5719 for Team page)