Ghost Hands
Browser actions for AI agents that are classified, approved and logged
- 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-handsAdd to claude_desktop_config.json
{
"mcpServers": {
"ghost-hands": {
"command": "uvx",
"args": [
"ghost-hands"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ghost-hands": {
"command": "uvx",
"args": [
"ghost-hands"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP 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

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools
Mantis
MCP serverBrowser MCP server that gives agents numbered text pages instead of screenshots
Runs locally- 1 tool
- Open source
- 5 Hacker News points
- Browser automation