Skip to content
MCP server

Ghost Hands

Browser actions for AI agents that are classified, approved and logged

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.16.0
Listing updated
3 days ago

About Ghost Hands

Ghost Hands is an open-source MCP server for browser automation. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add ghost-hands -- uvx ghost-hands

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ghost-hands": {
      "command": "uvx",
      "args": [
        "ghost-hands"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ghost-hands": {
      "command": "uvx",
      "args": [
        "ghost-hands"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • GHOST_HANDS_DRIVERSession body for the MCP server: fake (default), chromium, simphone, or android.
  • GHOST_HANDS_START_URLOptional URL opened on the first perceive call when a real body is selected.
  • GHOST_HANDS_APPROVERSet to phone to route approval asks through the PhoneApprover (requires the Android bridge env vars).

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

hands_verify_trail
Verifies the recorded provenance trail.

What it does

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

Pricing

Open source

MIT licensed; installs from PyPI

Prices change. Check littlestjames82-sys.github.io before you buy.

Ghost Hands 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 to Ghost Hands

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  4. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  5. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  6. Mantis

    MCP server

    Browser MCP server that gives agents numbered text pages instead of screenshots

    Runs locally
    • 1 tool
    • Open source
    • 5 Hacker News points
    • Browser automation