BrowserTools

by AgentDeskAI

Community Browser Automation 7k likes

BrowserTools MCP pairs a Chrome extension with an MCP server so an agent in Cursor or another IDE can read console logs and network requests and run Lighthouse audits.

Start the MCP server

npx @agentdeskai/browser-tools-mcp

Source: https://github.com/AgentDeskAI/browser-tools-mcp

About

Browser Tools MCP is a two-piece system: a Chrome extension that observes whatever tab you're working in, and an MCP server (plus a local browser-tools-server bridge) that surfaces that data to an IDE like Cursor. An agent can pull console logs and errors, inspect network requests and failures, grab the currently selected DOM element, and take screenshots, all without copy-pasting devtools output into chat.

It also wraps Lighthouse to run accessibility, performance, SEO, and best-practices audits on demand, plus a NextJS-specific prompt aimed at SEO improvements, and, as of 1.2.0, an 'Allow Auto-Paste into Cursor' option that pastes captured screenshots straight into the editor.

Key features

  • Reads live console logs and errors from the active browser tab
  • Captures network request/response logs, split into success and error lists
  • Reports the currently selected DOM element back to the agent
  • Runs Lighthouse-based accessibility, performance, SEO, and best-practices audits on command
  • Auto-paste option sends captured screenshots directly into Cursor
  • Ships as a companion Chrome extension plus a local bridge server rather than a single opaque binary

Use cases

  • Debugging a frontend issue by having an agent read console errors and network failures directly instead of pasting devtools output
  • Running quick Lighthouse accessibility/performance/SEO audits on a page from inside an IDE
  • Capturing and auto-pasting a screenshot of the current page into Cursor while iterating on UI
  • Inspecting whatever DOM element is selected in the browser from within an agent conversation

Available tools

mcp_getConsoleLogs

Retrieves recent console log output from the active browser tab.

mcp_getConsoleErrors

Retrieves recent console errors from the active browser tab.

mcp_getNetworkLogs

Returns network request activity captured by the extension.

mcp_getSelectedElement

Returns details about the DOM element currently selected in the browser.

mcp_runAccessibilityAudit

Runs a Lighthouse-based WCAG accessibility audit on the current page.

mcp_runPerformanceAudit

Runs a Lighthouse-based performance audit on the current page.

Frequently asked questions

Do I need to install anything besides the MCP server?

Yes. You also need the Chrome extension and a locally running bridge (npx @agentdeskai/browser-tools-server), which connects the extension to the MCP server your IDE talks to.

What powers the SEO/performance auditing?

Lighthouse. The server wraps Google's own auditing engine to run accessibility, performance, SEO, and best-practices checks against the page you're viewing, plus a NextJS-specific prompt focused on SEO fixes.