# Scout

Controls a browser directly over Chrome DevTools Protocol without Node.js or Python. Helps agents inspect pages, submit forms, capture screenshots, and extract Markdown.

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

## What it does

The server links AI agents directly to a browser via the Chrome DevTools Protocol. Node.js is not needed. A single binary handles actions over a raw WebSocket connection.

Inside are tools for interacting with forms and switching tabs. It distills page contents into dense Markdown and calculates DOM differences to reduce prompt token usage. Agents can also toggle between headless and visible windows mid-session.

Loopback access is blocked out of the box. Without setting `allow_private_ips` or running with `SCOUT_ALLOW_PRIVATE_IPS=1`, the agent cannot reach a local development server.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add scout -- docker run -i --rm ghcr.io/felixgeelhaar/scout:1.10.0
```

### Codex

**Platform CLI**
```bash
codex mcp add scout -- docker run -i --rm ghcr.io/felixgeelhaar/scout:1.10.0
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "scout": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/felixgeelhaar/scout:1.10.0"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "scout": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/felixgeelhaar/scout:1.10.0"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add scout docker run -i --rm ghcr.io/felixgeelhaar/scout:1.10.0
```

## When to use it
- Automate form submission and UI interactions in a browser
- Extract clean page content as compact Markdown to conserve tokens
- Record screen sessions or capture screenshots across page transitions
- Inspect broken network requests and browser console errors

## Example prompts
- Open `https://example.com`, fill out the signup form, and submit it
- Take a screenshot of `https://react.dev` and check for console errors
- Convert `https://news.ycombinator.com` into compact Markdown

## Similar
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [openbrowser-ai](https://affpapa.org/en/nevibecode/mcp/openbrowser-ai.md) — MCP server · ★ 279
- [crawlio-browser](https://affpapa.org/en/nevibecode/mcp/crawlio-browser.md) — MCP server · ★ 8
- [agent-browser](https://affpapa.org/en/nevibecode/skills/vercel-labs-agent-browser.md) — skill · 1200000 installs
- [cloud](https://affpapa.org/en/nevibecode/skills/browser-use-cloud.md) — skill · 3200 installs
- [chrome-cdp-live-browser](https://affpapa.org/en/nevibecode/skills/chrome-cdp-live-browser.md) — skill · 1500 installs

---
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