unbrowser by Unchained

by protostatis

Not rated yet

GitHub Website

About

Lightweight MCP browser for LLM agents: no Chrome, low-token BlockMaps, stateful sessions, JavaScript execution, forms, cookies, and escalation hints.

Explore

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 unbrowser by Unchained

Command (node, npx, python, etc.)

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": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

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": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

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": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

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": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

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": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "unbrowser by unchained": {
            "server": {
                "command": "uvx",
                "args": [
                    "pyunbrowser",
                    "--mcp"
                ]
            }
        }
    }
}

McpServers

{
    "server": {
        "command": "uvx",
        "args": [
            "pyunbrowser",
            "--mcp"
        ]
    }
}

Transport

"stdio"

Package

"pyunbrowser"

Registry

"pypi"

Official MCP Registry identity:mcp-name: io.github.protostatis/unbrowser

Defaultnavigateis a fast static/SSR pass.Setexec_scripts: trueonly when you need bounded QuickJS execution. Heavy SPAs, pixels, V8 fidelity, extensions, and interactive anti-bot challenges belong in a real Chrome tier.

Useunbrowserwhen HTTP alone is too dumb and a full browser is too expensive. When the page needs Chrome, the output tells the agent to escalate rather than pretending compatibility it does not have.

Docker — Linux amd64/arm64, ~13 MiB pull

docker pull ghcr.io/protostatis/unbrowser:latest # One-shot navigation docker run --rm ghcr.io/protostatis/unbrowser:latest \ navigate https://example.com --json # Default mode: MCP over stdio docker run --rm -i ghcr.io/protostatis/unbrowser:latest

The image is distroless and runs as non-root: no shell, package manager, or persistent state. Pin:vX.Y.Zor an image digest in production.

pipx install pyunbrowser # recommended on macOS / modern Linux # or, inside a Python 3.10+ virtual environment: pip install pyunbrowser

from unbrowser import Client with Client() as ub: ub.navigate("https://news.ycombinator.com") for link in ub.query(".titleline > a")[:3]: print(link["text"], link["attrs"]["href"])

On macOS,/usr/bin/python3is 3.9 and cannot install the wheel; usepipxor a Homebrew Python. The PyPI distribution ispyunbrowser, while the import and executable remainunbrowser.

{ "mcpServers": { "unbrowser": { "command": "unbrowser", "args": ["--mcp"] } } }

{ "mcpServers": { "unbrowser": { "command": "docker", "args": [ "run", "--rm", "-i", "ghcr.io/protostatis/unbrowser:latest" ] } } }

Seeinstallation and interface referencefor Cargo, release archives, source builds, persistent shell sessions, raw JSON-RPC, and all MCP options.

{"id":1,"method":"navigate","params":{"url":"https://example.com","exec_scripts":true}}

Withexec_scripts: true, inline and external scripts run in QuickJS under a bounded watchdog. This can materialize light hydration and fetch-visible data; it is not V8 or a rendering engine. Heavy React/Vue/Ember apps may still leave an empty shell.

MCP server for browser automation via Vercel agent-browser CLI

Convert any URL to LLM-ready Markdown via real Chrome browsers. 3 tools: scrape, crawl, search. Free via MCP, pay-per-use via x402.

An MCP server that allows AI agents to control a web browser using the browser-use library.

Exposes Chrome browser functionality to AI assistants for automation, content analysis, and semantic search via a Chrome extension.

Control a Chrome browser through the Chrome DevTools Protocol (CDP) from MCP clients for browsing, inspection, and automation workflows.

Stealthy, LLM-drivable browser engine — a Python library + 85-tool MCP server on stealth Chromium with full Chrome DevTools Protocol.

Multi-session browser MCP for AI agents — stealth mode, session pooling, humanization, 10x fewer tokens than Playwright

A Go-based MCP server for interacting with the Lightpanda Browser using the Chrome DevTools Protocol (CDP).

A browser automation agent using the Model Context Protocol (MCP) to enable browser interactions.

A browser automation service for capturing console output, useful for tasks like public sentiment analysis.

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

Claude Desktop / Cursor

McpServers

Transport

Package

Registry

Docker — Linux amd64/arm64, ~13 MiB pull

More like this

@mendableai/firecrawl Mcp Server

Playwright

Sequential Thinking

Filesystem