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.
| Flag | Effect |
|---|---|
--launch, --headed, --profile DIR | start separate Chrome; a headed window or kept profile implies launch |
--foreground, --downloads DIR, --cursor, --no-cursor | fixed for every call |
--cloud-profile ID | every call runs as that cloud profile |
--local, --extension, --extension-browser LABEL | every call runs in your own Chrome through the fastbrowse extension; see Your own Chrome |
--allow-authorize | let a call pass authorize; without it irreversible actions always stop at needs_confirmation |
--secret NAME=ENV_VAR@ORIGIN | typed when a call's start page is on ORIGIN; the model sees NAME only |
--bitwarden ITEM | a vault login a call may name in bitwarden |
--max-steps N, --max-dollars N, --max-seconds N | ceilings per call; unlimited by default |
--max-concurrent N | runs at once, default 1; more calls wait |
--transport http, --host, --port | streamable 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).
Related guides
- MCP browser server with spending limits
fastbrowse-mcp serves one browse tool over MCP with its limits set on the server. What each flag fixes, and what a calling model can and cannot change.
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.