browser-tools-mcp
Monitor browser logs directly from Cursor and other MCP compatible IDEs.
BrowserTools MCP is an MCP server that streams console output, network activity, screenshots, and Lighthouse audits from your active Chrome browser session directly to AI coding assistants like Cursor, Claude Code, Windsurf, and Cline. Unlike CDP-based automation tools, it attaches to your real browser session—the one already logged into your app—through a Chrome DevTools extension, eliminating the need to recreate authentication state. It provides 17 tools for reading console logs, network traffic, page info, browser storage, and running accessibility, performance, SEO, and best-practices audits, all while scrubbing credentials and keeping large payloads out of the context window through MCP resources.
Key Features
Use Cases
- 01Debugging production issues in authenticated web applications without recreating login sessions in automated browsers
- 02Having AI agents analyze console errors and network failures in real-time during development
- 03Running accessibility, performance, and SEO audits on live pages and having agents interpret Lighthouse results
- 04Monitoring hydration errors, API response issues, and client-side exceptions while pair-programming with AI
- 05Capturing full network activity as HAR files for AI-assisted performance analysis and optimization
- 06Inspecting browser storage (localStorage, sessionStorage, cookies) to debug authentication and state management issues
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
browser-tools-mcp — FAQ
What is BrowserTools MCP and what does it do?+
BrowserTools MCP is an MCP server that connects AI coding assistants to your active Chrome browser session, enabling them to read console logs, network traffic, screenshots, page info, and run Lighthouse audits. Unlike automation-based tools, it works with your real logged-in browser session through a DevTools extension.
How do I install BrowserTools MCP?+
Add the server to your MCP client config using npx to run @agentdeskai/browser-tools-mcp@latest, then install the Chrome extension by loading the chrome-extension directory unpacked from chrome://extensions. Requires Node.js 22.19 or newer.
Which AI clients and editors work with BrowserTools MCP?+
It works with any MCP-compatible client including Cursor, Claude Code, Windsurf, Cline, Zed, and Gemini CLI. The README specifically mentions these clients as tested.
Do I need API keys or special credentials?+
No API keys are required. You only need Node.js 22.19 or newer and Chrome (or a Chromium-based browser like Brave, Edge, Vivaldi, or Arc) to install the DevTools extension.
Is BrowserTools MCP free to use?+
Yes, it is released under the MIT license and available as a free open-source tool.
How do I troubleshoot if it's not working?+
Run npx @agentdeskai/browser-tools-mcp --doctor to check your setup and identify missing pieces. Use the --verbose flag to watch capture events in real-time and verify telemetry is flowing from the browser to the MCP server.
How do I install browser-tools-mcp?+
Open the source repository on GitHub and follow its README. browser-tools-mcp is a mcp server — MCP Agents Market links you directly to the official repo.
Is browser-tools-mcp free?+
browser-tools-mcp is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.