# Vessel Browser

Connects coding agents to an interactive Chromium browser window. It lets you monitor web actions in real time and approve clicks or form inputs manually.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 137
- Author: unmodeled-tyler
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/unmodeled-tyler/vessel-browser
- Updated: 2026-09-15
- HTML: https://affpapa.org/en/nevibecode/mcp/vessel-browser

## What it does

Vessel connects external coding agents to an active Chromium browser interface. Instead of running headless scripts in the background, it renders web pages in a normal window. You can watch the agent follow links, inspect DOM elements, and fill out forms. The supervisor sidebar at `Ctrl+Shift+L` provides a unified run inbox, conversation threads, and change tracking.

Human oversight stays central to the workflow. The assistant asks for permission before executing sensitive actions, allowing one-time approvals, domain-specific rules, or rejections with steering instructions. When an automation run goes off course, you can pause it, revert recent steps, or take manual control of the mouse. A built-in developer tools panel at `F12` logs console events, network traffic, and MCP traces.

Because the runtime is in active development, avoid pointing it at sensitive banking or production credentials. Linux is currently the most mature environment, supported via AppImage and Snap. Running it on macOS requires compiling from source code using Node.js 22.

## Requirements
- Needs: Node.js (commands run via npx)
- Works with: Chrome

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add vessel-browser -- npx -y @quanta-intellect/vessel-browser
```

### Codex

**Platform CLI**
```bash
codex mcp add vessel-browser -- npx -y @quanta-intellect/vessel-browser
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vessel-browser": {
            "command": "npx",
            "args": [
                "-y",
                "@quanta-intellect/vessel-browser"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vessel-browser": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@quanta-intellect/vessel-browser"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add vessel-browser npx -y @quanta-intellect/vessel-browser
```

## When to use it
- watch agent browsing actions inside a visible browser window
- require human confirmation before submitting sensitive web forms
- pause automated tasks and steer the model when it takes a wrong turn
- inspect network traffic and agent MCP logs in the `F12` developer panel

## Example prompts
- Open the pricing page on the current site and extract the tier breakdown.
- Fill out the contact form with sample data, but wait for my approval before submitting.
- Read the active article, summarize the main points, and check the references in new tabs.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 12927

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md