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

  1. 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.

  1. Load the Chrome extension: open chrome://extensions, enable Developer mode, choose "Load unpacked", and select the chrome-extension directory from the cloned repository.

  2. 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/agentdeskaibrowser-tools-mcp.svg)](https://yunodb.com/tools/agentdeskaibrowser-tools-mcp?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/agentdeskaibrowser-tools-mcp?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/agentdeskaibrowser-tools-mcp.svg" alt="Featured on YunoDB" height="20"></a>