# Ghostlight

> Ghostlight is an open-source MCP server for browser automation. Let an AI agent work visibly in your signed-in Chromium browser, locally, with audit. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, Linux, Chrome extension, CLI
- **Website:** https://sylin.org/ghostlight/
- **Repository:** https://github.com/sylin-org/ghostlight
- **MCP Registry name:** org.sylin/ghostlight
- **Categories:** browser automation
- **Listing updated:** 2026-11-14

## About

Most browser automation launches a fresh, empty browser that knows none of your logins. Ghostlight instead opens a coloured tab group inside the Chromium you already use, so the agent works on pages you are signed in to while you watch, pause, take the wheel or end the session.

The README counts 23 tools: 22 for browsing work, including tabs, navigation, reading pages, screenshots, semantic clicks, form input, file upload, scripts, waits, dialogs and diagnostics, plus one that explains the authority currently in force. Each call returns a single answer saying what happened, what changed, and whether repeating it is safe, and it avoids suggesting a replay that could submit a form twice.

Everything runs on your machine. The README says there is no account, telemetry, activation service or hosted control plane, only a payload-free local record. It needs Chrome, Edge, Brave or Chromium 125 or newer plus the browser extension, installs with npx or a one-line script, and supports Windows and Linux; macOS is not supported yet. Optional policy and audit controls are mentioned in the registry entry.

## Features

- **Visible tab group:** Work happens in a marked tab group inside your own browser.
- **Human control:** You can watch, pause, take over or end a session.
- **Truthful call results:** Each answer states what happened, what changed and whether a retry is safe.
- **Policy tool:** One tool explains the authority in force for the session.
- **Local-only runtime:** No account, telemetry or hosted service; a payload-free local record.
- **Desktop workbench:** A tray window shows the work as it happens.

## Good for

- Fill and review a form on a site you are logged into
- Investigate a failed web workflow across tabs
- Read and summarise pages behind a login
- Upload a file through a web form with oversight
- Test a demo flow while watching the agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add ghostlight -- npx -y ghostlight
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ghostlight": {
      "command": "npx",
      "args": [
        "-y",
        "ghostlight"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ghostlight": {
      "command": "npx",
      "args": [
        "-y",
        "ghostlight"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ghostlight": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ghostlight"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ghostlight": {
      "command": "npx",
      "args": [
        "-y",
        "ghostlight"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ghostlight": {
      "command": "npx",
      "args": [
        "-y",
        "ghostlight"
      ]
    }
  }
}
```

## FAQ

### Which browsers work?

Chrome, Edge, Brave or Chromium 125 and newer, with the Ghostlight extension.

### Which operating systems are supported?

The README says agent setup supports Windows and Linux; macOS is not supported yet.

### Does it send data to a server?

The README says there is no telemetry, account or hosted control plane; only the browsing you asked for uses the network.

### How do I install it?

Run npx -y ghostlight install, or use the PowerShell or shell one-liners.

### Is Ghostlight free?

Yes. Ghostlight is open source, so you can use and self-host it for free.

### How do I add Ghostlight to Claude Code?

Run this command in your terminal: claude mcp add ghostlight -- npx -y ghostlight

### What are the best alternatives to Ghostlight?

The closest alternatives to Ghostlight are Browser Use, Scrapling MCP Server, Oya Browser, Mantis and Auto-building agents.

## Alternatives

- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [Auto-building agents](https://ai-powered.com/mcp/auto-building-agents): Auto-building agents is a paid MCP server for browser automation.
- [pour](https://ai-powered.com/mcp/pour): pour is an open-source MCP server for developer tools.
- [AgentFarm](https://ai-powered.com/mcp/agentfarm): AgentFarm is a freemium MCP server for browser automation.
- [OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved](https://ai-powered.com/mcp/openadapt-your-agent-decides-openadapt-enters-it-and-checks): OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/ghostlight
