Log inSubmit server
MCP Browser Kit logo

MCP Browser Kit

by ndthanhdev

Controls connected local browser tabs through MCP, including reading pages, interacting with elements, scrolling, and taking screenshots.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Browser Kit

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ndthanhdev-mcp-browser-kit": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-browser-kit/server@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 19 tools correctly (1mo ago).

Overview

ndthanhdev/mcp-browser-kit MCP server lets AI assistants interact with connected local browser tabs through a browser extension and MCP tools. It can inspect readable page text and elements, open or close tabs, click and fill fields, scroll pages, capture MV2 screenshots, and request human actions when automation cannot proceed. The server supports stdio by default and can also run over HTTP on a local address. Reach for it when an agent needs to operate an existing browser session rather than use a site-specific API.

Use cases

  • Read content from an open browser tab
  • Fill and submit web forms
  • Navigate between browser tabs
  • Scroll through pages and panels
  • Ask a user to complete CAPTCHA or 2FA

Key features

  • Read page text and interactive elements
  • Click and fill elements by readable path
  • Open, close, and inspect tabs
  • Scroll pages and scrollable containers
  • Capture MV2 screenshots
  • Request human assistance for blocked steps

Tools19

What MCP Browser Kit lets your agent do. Expand a tool for its parameters.

Verified live~5.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 69d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @mcp-browser-kit/server@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars55Stargazers on the source repository.
npm downloads1kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed19Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Browser Kit works

What ndthanhdev/mcp-browser-kit MCP server does

ndthanhdev/mcp-browser-kit MCP server gives an MCP client access to connected local browser sessions. It exposes browser and tab state, readable page content, interactive element paths, element HTML, scrolling, form interaction, navigation, screenshots, and limited JavaScript execution. The browser connection is provided by a separately installed extension, with builds for supported Chromium-based browsers, Firefox, and Safari.

The server is suited to tasks where an agent must work with pages already open in a user's browser. It can discover windows and tabs, read page text, identify controls, click or fill those controls, and submit forms. It can also ask the user to complete a step when a CAPTCHA, two-factor authentication prompt, irreversible confirmation, or unsupported input requires human involvement.

How it works

The MCP server communicates with the client through stdio by default. It can alternatively use HTTP, with the MCP endpoint exposed at /mcp. Browser extensions relay operations to the connected browser. Agents first obtain context through getContext or the bk:///context resource, then use the returned browser, window, and tab identifiers in subsequent calls.

For ordinary interaction, the agent reads readable-elements and uses each element's dot-separated readable path. These paths are not CSS selectors and can become stale after navigation or DOM changes, so the page should be read again when an operation fails or the page changes. Readable text, element lists, and element HTML may be paginated through snapshot identifiers and continuation pages.

Setup and configuration

Install the MCP server through the npm package in an MCP client configuration. The default command uses npx @mcp-browser-kit/server@latest. For HTTP mode, start the same package with --transport http; host and port options are available, with loopback address 127.0.0.1 and port 21082 as the documented defaults.

Install the extension build that matches the browser. Chrome supports M3, while Brave and Edge support both M2 and M3. Firefox and Safari support M2. The documented setup involves downloading a release, loading or installing the extension, enabling it, and refreshing open tabs so the extension scripts are loaded.

Tools and capabilities

ndthanhdev/mcp-browser-kit MCP server includes tools for:

  • Discovering connected browsers, windows, tabs, URLs, titles, and active-tab state.
  • Reading page text, interactive elements, and the outer HTML of a selected element.
  • Clicking elements, filling inputs and textareas, and submitting forms with Enter.
  • Opening and closing tabs, with returned identifiers used for follow-up calls.
  • Scrolling the viewport or a scrollable element in any supported direction.
  • Capturing MV2 tab screenshots and clicking or filling by coordinates when readable paths are unavailable.
  • Executing a JavaScript function body in MV2 page context when supported controls cannot complete the task.
  • Highlighting a target and returning instructions for a human action.

Limitations and notes

The M2 extension exposes more functionality than M3. Screenshot capture, coordinate interaction, and JavaScript execution are documented for MV2 only. M3 workflows should use readable elements where possible; unsupported controls such as some native selects, range sliders, or custom widgets may require showHumanHint.

The HTTP server currently has no authentication. Its default loopback binding limits access to the local device, while binding to a LAN address or 0.0.0.0 can allow anyone who can reach that host and port to control the browser. The project recommends a separate browser profile or dedicated browser instance to reduce the chance of exposing sensitive browser data to AI model providers. Keep the documented ports network-local.

Coordinate actions depend on a recent screenshot and matching dimensions. Tab closing is irreversible, and agents should wait for a newly opened page to load before interacting with it.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Browser Kit

Add `npx @mcp-browser-kit/server@latest` as the MCP client's command, install the compatible browser extension from a release, enable it, and refresh open tabs.

Yes. Start it with `npx @mcp-browser-kit/server@latest --transport http`; the documented default endpoint is `http://127.0.0.1:21082/mcp`.

Chrome supports M3; Brave and Edge support M2 and M3; Firefox and Safari support M2.

Yes, `captureTab` supports screenshots for MV2 tabs. Screenshot-based coordinate tools should not be used with MV3.

Related MCP servers

All in Browser Automation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Browser Kit AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ndthanhdev-mcp-browser-kit?style=directory)](https://allmcps.com/mcp/ndthanhdev-mcp-browser-kit)
HTML Embed
<a href="https://allmcps.com/mcp/ndthanhdev-mcp-browser-kit"><img src="https://allmcps.com/api/badge/ndthanhdev-mcp-browser-kit?style=directory" alt="MCP Browser Kit on AllMCPs" /></a>