// MCP TOOL REFERENCE

DOMSHELL TOOLS

38 tools from the DOMShell MCP Server, categorised by risk level.

// ALL 38 DOMSHELL TOOLS

READ 22 tools

Read domshell_back Navigate back in browser history. Equivalent to the browser back button. Automatically refreshes the AX tre... Read domshell_cat Read detailed metadata about a DOM element: role, type, AX ID, DOM backend ID, value, child count, text con... Read domshell_cd Change directory — sets your scope for all subsequent commands (ls, find, grep, text all operate relative t... Read domshell_extract_links Extract all links under the current directory or a named child as a clean numbered list in [text](url) form... Read domshell_extract_table Extract a table element as structured markdown or CSV. Reads all rows and cells, returns formatted output. ... Read domshell_find Deep recursive search from the CURRENT DIRECTORY downward. Scope matters: cd into a section first, then fin... Read domshell_focus Focus an input element. Use before Read domshell_for Iterate over command output lines. Runs a source command, splits output into lines, and for each line repla... Read domshell_forward Navigate forward in browser history. Only works after a Read domshell_functions List callable global JavaScript functions on the current page. Shows function name, arity (parameter count)... Read domshell_grep Search for elements matching a pattern. Matches against name, role, and value. Case-insensitive.\n\nBy defa... Read domshell_here Jump to the active tab in the last focused Chrome window. Use this to quickly enter whichever tab the user ... Read domshell_ls List children of the current directory. In the DOM tree: shows elements as files and directories. At the br... Read domshell_pwd Print the current working directory path in the DOM tree. Read domshell_read Structured subtree extraction — returns the hierarchy of elements under the current directory or a named ch... Read domshell_refresh Force re-fetch the Accessibility Tree. Use after page navigation or significant DOM changes. Note: the tree... Read domshell_screenshot Capture a PNG screenshot of the current tab. Returns the image for visual inspection. Useful for understand... Read domshell_tabs List all open browser tabs with their IDs, titles, URLs, and window info. Use this to find the right tab be... Read domshell_text Extract ALL text content from the current directory or a named child, including every descendant. Returns f... Read domshell_tree Show a tree view of the current directory in the DOM, displaying the hierarchy of elements with type prefix... Read domshell_watch Re-run a command periodically and collect results. Useful for monitoring dynamic content changes within a s... Read domshell_whoami Check authentication status by examining cookies for the current page. Shows session cookies and expiry.

WRITE 10 tools

Write domshell_call Call a global JavaScript function by name. Arguments are auto-parsed as JSON if valid, otherwise passed as ... Write domshell_click Click a DOM element. May trigger navigation, form submission, or page changes. The DOM tree auto-refreshes ... Write domshell_close Close a tab. With no arguments, closes the current tab and returns to browser root. With a tab ID, closes t... Write domshell_diff Compare the current AX tree against the snapshot taken before the last write/navigate action (click, type, ... Write domshell_eval Evaluate a JavaScript expression in the tab context (read-only). Returns the result. Unlike domshell_js (wh... Write domshell_open Open a URL in a new tab and enter it (path becomes ~/tabs/<id>). Automatically builds the accessibility tre... Write domshell_scroll Scroll the page or scroll a specific element into view. Use this when content is below the fold or when you... Write domshell_select Select an option from a <select> dropdown element. Matches by option value first, then by visible text (cas... Write domshell_submit Atomic form submission — focuses input, clears existing value, types new value, then submits (clicks button... Write domshell_type Type text into the currently focused element. Use domshell_focus first to target an input field.\n\nFor sea...

EXECUTE 6 tools

Execute domshell_each Run a command across multiple open tabs. Iterates over all non-chrome tabs (optionally filtered by title/UR... Execute domshell_execute Run DOMShell commands to browse and read web pages — the primary DOMShell interface. DOMShell maps a page Execute domshell_js Execute arbitrary JavaScript in the current tab and return the result. Use this for complex DOM queries, CS... Execute domshell_navigate Navigate the current tab to a URL. Automatically rebuilds the accessibility tree after navigation completes... Execute domshell_script Save and run multi-command scripts. Scripts persist across service worker restarts.\n\nSubcommands:\n scri... Execute domshell_wait Wait for an element to appear in the AX tree. Polls the tree every 500ms until the element is found or time...

// RUNNING THIS SERVER

The managed route: connect DOMShell through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y @apireno/domshell

// FAQ

How many tools does the DOMShell MCP server have? +

The DOMShell MCP server exposes 38 tools across 3 categories: Read, Write, Execute.

How do I enforce policies on DOMShell tools? +

Route the DOMShell server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do DOMShell tools fall into? +

DOMShell tools are categorised as Read (22), Write (10), Execute (6). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.