headless_browser

MCP tool from Web Eval Agent by refreshdotdev

(optional, default false) – set to true to hide the browser window

How to use it

headless_browser is exposed by the Web Eval Agent MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the headless_browser tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Web Eval Agent

$npm install -g chromium playwright && uvx --with playwright playwright install --with-deps

FULL WEB EVAL AGENT LISTING

Other tools in Web Eval Agent (4)

setup_browser_state

🔒 Opens an interactive (non-headless) browser so you can sign in once; the saved cookies/local-storage are reused by subsequent webevalagent runs.

task

(required) – natural-language description of what to test ("run through the signup flow and note any UX issues")

url

(required) – address of the running app (e.g. http://localhost:3000)

web_eval_agent

🤖 Automated UX evaluator that drives the browser, captures screenshots, console & network logs, and returns a rich UX report.