BrowserSolver — Claude Code MCP server: features and setup
The BrowserSolver MCP server for Claude Code gives an agent tools to fetch and inspect public websites. It can render pages, capture screenshots, identify bot protection, and detect site technologies.
MIT updated 2026-11-11
claude mcp add mcp -e BROWSERSOLVER_API_KEY=<BROWSERSOLVER_API_KEY> -- npx -y @browsersolver/mcpWhat BrowserSolver does
BrowserSolver exposes tools for fetching public-page HTML, rendering pages, and saving screenshots as PNG, JPEG, WebP, or PDF. Other tools identify bot protection and site technologies, or return account usage and credit balance. API calls consume credits.
A local setup requires Node.js 20 or newer and a BrowserSolver API key. The local process reads the key from BROWSERSOLVER_API_KEY; HTTP clients send it in a request header. website_webunlocker is limited to retail and marketplace hosts on the account whitelist. Images appear inline, while other files are returned as embedded resources up to 4 MB.
The package can run locally through npx, or clients can connect to the hosted server. Local HTTP mode binds to 127.0.0.1 by default; TLS is needed before exposing it publicly.
What it helps with
- fetch HTML from a public page
- save a webpage as a PDF screenshot
- identify a site's bot-protection vendor
- detect a site's CMS and frameworks
- check BrowserSolver credit usage
Example prompts for the agent
- Fetch the HTML from this public page and summarize its contents.
- Capture this page as a PDF.
- Identify the technologies and bot protection used by this site.
How to install BrowserSolver
1Platform CLI
claude mcp add mcp -e BROWSERSOLVER_API_KEY=<BROWSERSOLVER_API_KEY> -- npx -y @browsersolver/mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http browsersolver https://mcp.browsersolver.com/1Platform CLI: remote server
codex mcp add browsersolver --url https://mcp.browsersolver.com/2Platform CLI
codex mcp add browsersolver --env BROWSERSOLVER_API_KEY=<BROWSERSOLVER_API_KEY> -- npx -y @browsersolver/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"browsersolver": {
"url": "https://mcp.browsersolver.com/"
}
}
}{
"mcpServers": {
"browsersolver": {
"command": "npx",
"args": [
"-y",
"@browsersolver/mcp"
],
"env": {
"BROWSERSOLVER_API_KEY": "<BROWSERSOLVER_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"browsersolver": {
"type": "http",
"url": "https://mcp.browsersolver.com/"
}
}
}{
"servers": {
"browsersolver": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@browsersolver/mcp"
],
"env": {
"BROWSERSOLVER_API_KEY": "<BROWSERSOLVER_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http browsersolver https://mcp.browsersolver.com/2Platform CLI
gemini mcp add -e BROWSERSOLVER_API_KEY=<BROWSERSOLVER_API_KEY> browsersolver npx -y @browsersolver/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about BrowserSolver
How do I install BrowserSolver in Claude Code?
For a local connection, run claude mcp add --env BROWSERSOLVER_API_KEY=<BROWSERSOLVER_API_KEY> --transport stdio browsersolver -- npx -y @browsersolver/mcp. This setup requires Node.js 20 or newer and a BrowserSolver API key.
What does BrowserSolver do?
It gives an agent tools to fetch or render HTML, capture public webpages, detect bot protection, and identify site technologies. API calls use credits.
What does BrowserSolver require?
A local installation needs Node.js 20 or newer and a BrowserSolver API key. The website_webunlocker tool works with retail and marketplace hosts on the account whitelist.