SkillsLLM
Back to catalog

browser-tools-mcp

by AgentDeskAI

Pending

Monitor browser logs directly from Cursor and other MCP compatible IDEs.

7,039stars
517forks
JavaScript
Added 12/27/2025
View on GitHubDownload ZIP
MCP Serversaianthropiccursormcpmcp-server
Installation
# Add to your Claude Code skills
git clone https://github.com/AgentDeskAI/browser-tools-mcp
README.md

BrowserTools MCP

Make your AI tools 10x more aware and capable of interacting with your browser

This application is a powerful browser monitoring and interaction tool that enables AI-powered applications via Anthropic's Model Context Protocol (MCP) to capture and analyze browser data through a Chrome extension.

Read our docs for the full installation, quickstart and contribution guides.

Roadmap

Check out our project roadmap here: Github Roadmap / Project Board

Updates

v1.2.0 is out! Here's a quick breakdown of the update:

  • You can now enable "Allow Auto-Paste into Cursor" within the DevTools panel. Screenshots will be automatically pasted into Cursor (just make sure to focus/click into the Agent input field in Cursor, otherwise it won't work!)
  • Integrated a suite of SEO, performance, accessibility, and best practice analysis tools via Lighthouse
  • Implemented a NextJS specific prompt used to improve SEO for a NextJS application
  • Added Debugger Mode as a tool which executes all debugging tools in a particular sequence, along with a prompt to improve reasoning
  • Added Audit Mode as a tool to execute all auditing tools in a particular sequence
  • Resolved Windows connectivity issues
  • Improved networking between BrowserTools server, extension and MCP server with host/port auto-discovery, auto-reconnect, and graceful shutdown mechanisms
  • Added ability to more easily exit out of the Browser Tools server with Ctrl+C

Quickstart Guide

There are three components to run this MCP tool:

  1. Install our chrome extension from here: v1.2.0 BrowserToolsMCP Chrome Extension
  2. Install the MCP server from this command within your IDE: npx @agentdeskai/browser-tools-mcp@latest
  3. Open a new terminal and run this command: npx @agentdeskai/browser-tools-server@latest
  • Different IDEs have different configs but this command is generally a good starting point; please reference your IDEs docs for the proper config setup

IMPORTANT TIP - there are two servers you need to install. There's...

  • browser-tools-server (local nodejs server that's a middleware for gathering logs) and
  • browser-tools-mcp (MCP server that you install into your IDE that communicates w/ the extension + browser-tools-server)

npx @agentdeskai/browser-tools-mcp@latest is what you put into your IDE npx @agentdeskai/browser-tools-server@latest is what you run in a new terminal window

After those three steps, open up your chrome dev tools and then the BrowserToolsMCP panel.

If you're still having issues try these steps:

  • Quit / close down your browser. Not just the window but all of Chrome itself.
  • Restart the local node server (browser-tools-server)
  • Make sure you only have ONE instance of chrome dev tools panel open

After that, it should work but if it doesn'...