Install the open MCP
Needs Node.js 22 or newer and Google Chrome (or another Chromium browser). No account and no key.
Your client
claude mcp add pilotfish -- npx -y @gaiventures/pilotfish-mcpOn Windows (not WSL), put cmd /c before npx.
[mcp_servers.pilotfish]
command = "npx"
args = ["-y", "@gaiventures/pilotfish-mcp"]
# browser_resume waits up to 300 s for you; Codex's default limit is 60 s.
tool_timeout_sec = 330{
"mcpServers": {
"pilotfish": {
"command": "npx",
"args": [
"-y",
"@gaiventures/pilotfish-mcp"
]
}
}
}The same entry works in Cursor, Claude Desktop, Windsurf and most other clients.
npx -y @gaiventures/pilotfish-mcp --http --port 8931
claude mcp add --transport http pilotfish http://127.0.0.1:8931/mcpOne browser for several clients at once. Set PILOTFISH_MCP_TOKEN to require a bearer token.
When a page needs you
The browser opens in its own window. When a page needs a person (a sign-in, a code, a CAPTCHA), the result says NEEDS A PERSON: do it in that window, and the agent carries on with browser_resume.
Tasks that name no site
Your agent searches the web first, with its own search tool, to pick the site, or answers from the search when that is enough. It opens a site with browser_navigate when the task needs one: a price for your dates, a form, an account. The search is your agent's, not pilotfish's.