Puppeteer Real Browser MCP Server

MCP server for safe, detection-resistant browser automation

Local serverstdio

What is the Puppeteer Real Browser MCP Server?

MCP server for safe, detection-resistant browser automation

The short version

Give an MCP-compatible AI assistant a local Chrome browser that it can open, navigate, read, and control.

  • Opens a visible browser by default, with optional headless mode
  • Navigates pages and reads HTML or text
  • Finds elements, clicks, types, waits, and scrolls
  • Uses rebrowser-puppeteer-core and a small set of anti-detection settings
  • Detects Chrome on Windows, macOS, and Linux
  • Supports a custom Chrome path, proxy, and dedicated automation profile

What it needs from you

  • Node.js 18 or newer - npm and npx (included with the normal Node.js installer) - Google Chrome or Chromium - An MCP client that can start a local stdio server Claude Desktop is available on macOS and Windows. Other MCP clients can use this server on Linux.

Recorded tools

  • browser_init — Start or reuse the managed Chrome session
  • navigate — Open a URL
  • get_content — Read full-page or selected HTML/text
  • find_selector — Find a CSS selector from element text
  • click — Click an element
  • type — Clear and type into an input
  • wait — Wait for a selector, navigation, or time
  • random_scroll — Scroll with varied timing and distance
  • solve_captcha — Return a placeholder attempt result
  • save_content_as_markdown — Save as .md; currently blocked
  • browser_close — Close the managed browser and reset workflow state

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
browser_initStart or reuse the managed Chrome session
navigateOpen a URL
get_contentRead full-page or selected HTML/text
find_selectorFind a CSS selector from element text
clickClick an element
waitWait for a selector, navigation, or time
random_scrollScroll with varied timing and distance
solve_captchaReturn a placeholder attempt result
save_content_as_markdownSave as .md; currently blocked
browser_closeClose the managed browser and reset workflow state

How to install the Puppeteer Real Browser MCP Server

{
  "mcpServers": {
    "puppeteer-real-browser": {
      "command": "npx",
      "args": [
        "-y",
        "puppeteer-real-browser-mcp-server@latest"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js 18 or newer - npm and npx (included with the normal Node.js installer) - Google Chrome or Chromium - An MCP client that can start a local stdio server Claude Desktop is available on macOS and Windows. Other MCP clients can use this server on Linux.

Example prompts to try

  • “Use Puppeteer Real Browser to browser init.”
  • “Use Puppeteer Real Browser to navigate.”
  • “Use Puppeteer Real Browser to get content.”

Frequently asked questions

MCP server for safe, detection-resistant browser automation Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.