Skip to content
MCP server

pilotfish (local)

Give any MCP agent a real Chrome on your own computer. Free, no account, no API key.

Runs locallyStatus and history
Install
Runs
Locally
Version
0.1.60
Listing updated
1 day ago

About pilotfish (local)

pilotfish (local) is an MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add pilotfish --env PILOTFISH_SECRETS='<PILOTFISH_SECRETS>' -- npx -y @gaiventures/pilotfish-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pilotfish": {
      "command": "npx",
      "args": [
        "-y",
        "@gaiventures/pilotfish-mcp"
      ],
      "env": {
        "PILOTFISH_SECRETS": "<PILOTFISH_SECRETS>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pilotfish": {
      "command": "npx",
      "args": [
        "-y",
        "@gaiventures/pilotfish-mcp"
      ],
      "env": {
        "PILOTFISH_SECRETS": "<PILOTFISH_SECRETS>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "pilotfish": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@gaiventures/pilotfish-mcp"
      ],
      "env": {
        "PILOTFISH_SECRETS": "<PILOTFISH_SECRETS>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "pilotfish": {
      "command": "npx",
      "args": [
        "-y",
        "@gaiventures/pilotfish-mcp"
      ],
      "env": {
        "PILOTFISH_SECRETS": "<PILOTFISH_SECRETS>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "pilotfish": {
      "command": "npx",
      "args": [
        "-y",
        "@gaiventures/pilotfish-mcp"
      ],
      "env": {
        "PILOTFISH_SECRETS": "<PILOTFISH_SECRETS>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PILOTFISH_HEADLESS1 hides the browser window (sign-ins and CAPTCHAs then cannot be done by hand)
  • PILOTFISH_ALLOWED_HOSTSComma-separated hostname globs the browser may visit (default: any public host)
  • PILOTFISH_SECRETSJSON of values typed as {{name}} placeholders, never shown to the model, e.g. {"pw": "..."}

pilotfish (local) FAQ

How do I add pilotfish (local) to Claude Code?

Run this command in your terminal: claude mcp add pilotfish --env PILOTFISH_SECRETS='<PILOTFISH_SECRETS>' -- npx -y @gaiventures/pilotfish-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers