Browser Tools

by agentdeskai

Recommended

6.7k stars

178k downloads

GitHub Website

About

Enables web browsing capabilities through tools for content extraction, link following, and browser automation with customizable parameters for scraping, data collection, and web crawling tasks.

Details

Author: agentdeskai
Repository: AgentDeskAI/browser-tools-mcp
GitHub stars: 6,656
Downloads: 177,962
License: MIT License
Categories: Developer Tools, Infrastructure, Frontend, Security, AI, Automation

- Captures console logs, network activity, and DOM elements in real time
- Takes full-page screenshots via WebSocket commands
- Runs accessibility (WCAG), performance, SEO, and best practices audits
- NextJS-specific audit and combined audit/debugger modes
- Stores all data locally; never sent to third parties
- Auto-discovers hosts/ports, supports auto-reconnect and graceful shutdown

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Browser Tools

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

`getConsoleLogs`

Console output, filterable by keyword with paging.

`getConsoleErrors`

Error-level output and uncaught exceptions.

`getNetworkLogs`

XHR/fetch requests with status, timing and bodies.

`getNetworkErrors`

Only failed and 4xx/5xx requests.

`getSelectedElement`

The element selected in the Elements panel.

`getPageInfo`

Which page the browser is currently on.

`getConnectionStatus`

Whether the extension is connected, and capture counts.

`listBrowserTabs`

Every tab with DevTools open, and the id to address it by.

`takeScreenshot`

Screenshot returned as an image, plus its file path.

`refreshBrowser`

Reloads the inspected tab.

`getBrowserStorage`

localStorage, sessionStorage and cookies (values gated).

`wipeLogs`

Clears captured telemetry before a clean reproduction.

`runAccessibilityAudit`

Lighthouse accessibility audit.

`runPerformanceAudit`

Lighthouse performance audit with Core Web Vitals.

`runSEOAudit`

Lighthouse SEO audit.

`runBestPracticesAudit`

Lighthouse best-practices audit.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "browser tools": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

# BrowserTools MCP Give your AI coding agent eyes on the browser. BrowserTools MCP streams console output, network activity, screenshots and Lighthouse audits from **your real Chrome session** — the one already logged into your app — to any MCP-compatible

5.0 · 1 review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

getConsoleLogs

getConsoleErrors

getNetworkLogs

getNetworkErrors

getSelectedElement

getPageInfo

getConnectionStatus

listBrowserTabs

takeScreenshot

refreshBrowser

getBrowserStorage

wipeLogs

runAccessibilityAudit

runPerformanceAudit

runSEOAudit

runBestPracticesAudit

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Sequential Thinking

`getConsoleLogs`

`getConsoleErrors`

`getNetworkLogs`

`getNetworkErrors`

`getSelectedElement`

`getPageInfo`

`getConnectionStatus`

`listBrowserTabs`

`takeScreenshot`

`refreshBrowser`

`getBrowserStorage`

`wipeLogs`

`runAccessibilityAudit`

`runPerformanceAudit`

`runSEOAudit`

`runBestPracticesAudit`