browser-tools-mcp
Monitor browser logs directly from Cursor and other MCP compatible IDEs.
What is browser-tools-mcp?
Monitor browser logs directly from Cursor and other MCP compatible IDEs.
Overview of browser-tools-mcp
What it is
BrowserTools MCP is a tool that gives AI coding agents access to browser data. It streams console output, network activity, screenshots, and Lighthouse audits from a real Chrome session to any MCP-compatible client, such as Cursor, Claude Code, Windsurf, Cline, Zed, and Gemini CLI. Version 2.0 is a rewrite that runs as one process, removes the unauthenticated local server, scrubs credentials before they leave the browser, and includes a test suite.
Key features
- Streams console logs, network requests, screenshots, and Lighthouse audits (performance, accessibility, SEO, best practices) from the user's actual Chrome session.
- Attaches to the browser through a DevTools extension, so the user stays logged in and on the same page.
- Provides over 20 tools, including
getConsoleLogs,getNetworkLogs,takeScreenshot,runAccessibilityAudit,runPerformanceAudit, and more. - Exposes large data as MCP resources (console, network, HAR, screenshots, audit reports) to keep the context window manageable.
- Ships three prompts (
debuggerMode,auditMode,nextjsSeoAudit) to guide the agent's workflow. - Supports multiple tabs simultaneously, with telemetry attributed per tab and tools acting on the current tab by default.
Use cases
- Debugging the application the user is currently viewing, without recreating authentication state in a separate browser profile.
- Running Lighthouse audits for performance, accessibility, SEO, and best practices directly from an IDE.
- Monitoring console errors and network failures in real time while developing.
Getting started
- Add the MCP server configuration to your MCP client:
{
"mcpServers": {
"browser-tools": {
"command": "npx",
"args": ["-y", "@agentdeskai/browser-tools-mcp@latest"]
}
}
}
On Windows, use "command": "cmd" with "args": ["/c", "npx", "-y", "@agentdeskai/browser-tools-mcp@latest"]. Requires Node 22.19 or newer.
-
Load the Chrome extension: open
chrome://extensions, enable Developer mode, choose "Load unpacked", and select thechrome-extensiondirectory from the cloned repository. -
Open Chrome DevTools (F12) on the page to inspect. Capture begins automatically. To verify the setup, run
npx @agentdeskai/browser-tools-mcp --doctor.
License and pricing
Licensed under MIT. Open source and free to use.
Based on the project's public README and repository metadata.