BrowserTools MCP Server: Setup for Cursor, Claude and Other Apps

• Shows errors and crashes from the browser console

  Returns error-level console output and uncaught exceptions from the tab you are inspecting. You can filter by keyword and page through results.

  Try: “Check the console for errors on this page.”

  Read · getConsoleErrors

• Shows everything printed to the browser console

  Returns console output, filterable by keyword, with paging.

  Try: “Show console logs mentioning "hydration".”

  Read · getConsoleLogs

• Shows failed requests

  Returns only failed requests and 4xx or 5xx responses.

  Try: “Which API calls failed when I clicked Pay?”

  Read · getNetworkErrors

• Shows the page's web requests

  Returns XHR and fetch requests with status, timing and bodies. Filter by URL or body keywords.

  Try: “List the requests to /api/ and their response times.”

  Read · getNetworkLogs

• Takes a screenshot of the page you are on

  Returns the screenshot as an image and saves it to a local folder.

  Try: “Take a screenshot and tell me what looks broken.”

  Write · takeScreenshot

• Reads the element you picked in DevTools

  Returns the element currently selected in the Elements panel.

  Try: “Look at the element I have selected and tell me why it is misaligned.”

  Read · getSelectedElement

• Tells you which page the browser is on

  Returns the page the browser is currently on.

  Try: “What page am I on?”

  Read · getPageInfo

• Checks the browser extension is connected

  Reports whether the extension is connected and how much has been captured.

  Try: “Is the browser extension connected?”

  Read · getConnectionStatus

• Lists tabs that have DevTools open

  Lists the tabs being tracked, each with a tab ID you can pass to other tools.

  Try: “Which tabs are you watching?”

  Read · listBrowserTabs

• Reads localStorage, sessionStorage and cookies

  Returns browser storage. The README says values are withheld unless explicitly requested.

  Try: “Show the keys in localStorage for this page.”

  Read · getBrowserStorage

• Reloads the page you are inspecting

  Reloads the tab so you can capture a full page load.

  Try: “Reload the page and check the network calls again.”

  Write · refreshBrowser

• Clears captured console and network history

  Clears the telemetry captured so far, for a clean reproduction of a bug.

  Try: “Clear the logs, then I will reproduce the bug.”

  Delete · wipeLogs

• Runs a Lighthouse accessibility check

  Runs a Lighthouse accessibility audit on a page.

  Try: “Run an accessibility audit on this page.”

  Network · runAccessibilityAudit

• Runs a Lighthouse speed check

  Runs a Lighthouse performance audit, including Core Web Vitals.

  Try: “How fast is this page? Run a performance audit.”

  Network · runPerformanceAudit

• Runs a Lighthouse SEO check

  Runs a Lighthouse SEO audit on a page.

  Try: “Run an SEO audit on this page.”

  Network · runSEOAudit

• Runs a Lighthouse best-practices check

  Runs a Lighthouse best-practices audit on a page.

  Try: “Check this page against web best practices.”

  Network · runBestPracticesAudit

• Lists browser tabs without DevTools (unreleased)

  Lists tabs that Chrome reports, without attaching the debugger. Unreleased: listed in the main branch README, not in the v2.0.4 release.

  Try: “List my open tabs.”

  Read · listTabs

• Reads the headings and text of a tab (unreleased)

  Returns headings, an excerpt and a snapshot of a tab without the debugger. Unreleased: listed in the main branch README, not in the v2.0.4 release.

  Try: “Read the tab about pricing and summarize it.”

  Read · readTab

• Opens a URL in an inspected tab (unreleased)

  Loads a URL in a tab with DevTools open, without focusing it. Needs the input flag turned on. Unreleased: listed in the main branch README, not in the v2.0.4 release.

  Try: “Open the staging site in the inspected tab.”

  Write · navigateBrowser

• Opens a URL in a background tab (unreleased)

  Loads a URL in a tab from the tab list. Needs the input flag turned on. Unreleased: listed in the main branch README, not in the v2.0.4 release.

  Try: “Load the docs page in that tab.”

  Write · navigateTab

• Tries to click an element (unreleased)

  Attempts an untrusted click and reports whether it worked or needs a real gesture. Unreleased: listed in the main branch README, not in the v2.0.4 release.

  Try: “Click the Submit button.”

  Write · softClick

• Tries to type into a field (unreleased)

  Attempts untrusted typing and reports whether it worked or needs a real gesture. Unreleased: listed in the main branch README, not in the v2.0.4 release.

  Try: “Type "test" into the search box.”

  Write · softType

Watch out for

• It sees what your logged-in browser sees

  Console output, requests, responses and screenshots can contain private data. The README says credentials are scrubbed, headers are off by default and storage values are withheld unless requested. github.com

• Version 1.x has critical flaws

  The README says 1.x allowed remote code execution and unauthenticated access to captured data, and will not be patched. Use 2.0 or newer. github.com

• It can reload pages and clear history

  Reload and clear-logs tools change the page state and wipe captured data. Hide them with --exclude if you do not want that. github.com

• Screenshots are saved to your disk

  Screenshots are written to a local folder, which you can set with --screenshot-dir. github.com

• Local only by default

  The README says the connector only binds to 127.0.0.1 and refuses non-loopback addresses. github.com

Security advisories