# Ghost Hands

> Ghost Hands is an open-source MCP server for browser automation. Browser actions for AI agents that are classified, approved and logged. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://littlestjames82-sys.github.io/ghost-hands/
- **Repository:** https://github.com/littlestjames82-sys/ghost-hands
- **MCP Registry name:** io.github.littlestjames82-sys/ghost-hands
- **Categories:** browser automation, security
- **Listing updated:** 2026-11-14

## About

Ghost Hands puts a governor in front of a browser agent. Every action is classified before it runs, checked against a policy and written to a provenance trail, and consequential ones such as placing an order wait for human approval. With no approver attached, an action that needs asking is denied.

The browser driver is its own stdlib Chrome DevTools Protocol client, not Playwright or Selenium. The MCP server takes a `GHOST_HANDS_DRIVER` setting with fake as the default, plus chromium, simphone or android, and can route approvals to a phone. Finished runs can graduate into deterministic, model-free scripts you re-run for free. Other features named include audit reports from the trail, a seatbelt policy pack that denies prompt-injection-shaped targets, and a `hands_verify_trail` tool.

The code is MIT licensed and installs from PyPI.

## Features

- **Classify before acting:** Each action is judged against a policy first.
- **Human approvals:** Consequential actions stop for approval; no approver means denied.
- **Provenance trail:** JSONL record of each perceive, decide and execute step.
- **Replayable scripts:** Turn a finished run into a model-free script.
- **Several bodies:** Fake, Chromium, simulated phone or Android drivers.

## Good for

- Let an agent browse but stop before payments
- Produce an audit report of what an agent did
- Re-run a successful browser task without model costs
- Test a policy against prompt-injection-shaped links

## Install

### Claude Code (Terminal)

```sh
claude mcp add ghost-hands -- uvx ghost-hands
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ghost-hands": {
      "command": "uvx",
      "args": [
        "ghost-hands"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ghost-hands": {
      "command": "uvx",
      "args": [
        "ghost-hands"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "ghost-hands": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ghost-hands"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ghost-hands": {
      "command": "uvx",
      "args": [
        "ghost-hands"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ghost-hands": {
      "command": "uvx",
      "args": [
        "ghost-hands"
      ]
    }
  }
}
```

## Tools

- `hands_verify_trail`: Verifies the recorded provenance trail.

## FAQ

### What is the default driver?

The environment variable defaults to fake; set it to chromium for a real browser.

### What happens without an approver?

The site says 'ask' means denied.

### Does it use Playwright?

No. It ships its own zero-dependency CDP client.

### What licence?

MIT.

### Is Ghost Hands free?

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

### How do I add Ghost Hands to Claude Code?

Run this command in your terminal: claude mcp add ghost-hands -- uvx ghost-hands

### What are the best alternatives to Ghost Hands?

The closest alternatives to Ghost Hands are REA, Browser Use, Scrapling MCP Server, Oya Browser and Agent Roast.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.

---
Source: https://ai-powered.com/mcp/ghost-hands
