Skip to content
fastbrowsefastbrowse

docs

Use it from an MCP client

Serve the browse tool over MCP, with server-side limits, fixed browser choices and HTTP authorization.

Raw Markdown·Source at the pinned commit

fastbrowse-mcp serves one browse tool over MCP to Claude Code, Claude Desktop, Cursor or any MCP client. It returns the answer with numbered citation links, typed fields if asked for, the quotes behind them, the status and what to do next, and reports progress every step.

claude mcp add fastbrowse -e OPENROUTER_API_KEY=... -e BROWSER_USE_API_KEY=... \
  -- uvx --from fastbrowse fastbrowse-mcp --max-dollars 0.25

For a client configured by JSON, such as Claude Desktop:

{
  "mcpServers": {
    "fastbrowse": {
      "command": "uvx",
      "args": ["--from", "fastbrowse", "fastbrowse-mcp"],
      "env": { "OPENROUTER_API_KEY": "...", "BROWSER_USE_API_KEY": "..." }
    }
  }
}

The server's flags set what a calling model may do; a call can ask for less, never more.

FlagEffect
--launch, --headed, --profile DIRstart separate Chrome; a headed window or kept profile implies launch
--foreground, --downloads DIR, --cursor, --no-cursorfixed for every call
--cloud-profile IDevery call runs as that cloud profile
--local, --extension, --extension-browser LABELevery call runs in your own Chrome through the fastbrowse extension; see Your own Chrome
--allow-authorizelet a call pass authorize; without it irreversible actions always stop at needs_confirmation
--secret NAME=ENV_VAR@ORIGINtyped when a call's start page is on ORIGIN; the model sees NAME only
--bitwarden ITEMa vault login a call may name in bitwarden
--max-steps N, --max-dollars N, --max-seconds Nceilings per call; unlimited by default
--max-concurrent Nruns at once, default 1; more calls wait
--transport http, --host, --portstreamable HTTP at /mcp instead of stdio

Over HTTP, set FASTBROWSE_MCP_TOKEN and every request but /healthz needs Authorization: Bearer <token>; the server refuses to bind beyond loopback without one. A run takes seconds to minutes, so raise the client's tool timeout if it has one (MCP_TOOL_TIMEOUT in Claude Code).

hosted

Run fastbrowse over an API

The same agent behind an API. Keys, secrets, run history and spend limits live in the console. Free to start.

create an account·plans and pricing