Allows AI clients to unlock, render, crawl, and screenshot websites while bypassing anti-bot protections.
Also known as browsersolver/browsersolver-mcp, browsersolver-mcp, @browsersolver/mcp
- Stars
- 0
- Tools
- 8
- Downloads, 30 days
- 307
- Latest version
- 0.1.0
- Last commit
- Nov 11, 2026
- License
- MIT
What is BrowserSolver MCP?
BrowserSolver allows AI clients to unlock, render, crawl, and screenshot websites while bypassing anti-bot protections. It exposes 8 tools, such as stats, usage, website_antibot.
Summary generated from the project's README
About BrowserSolver MCP server
Bypassing anti-bot protections to access web content is what BrowserSolver enables for AI clients like Claude, Cursor, and Windsurf. This MCP server connects your local or remote environment to the BrowserSolver API, allowing models to interact with websites that typically block automated access. It provides a suite of specialized tools for crawling, rendering, and capturing visual data from the web.
Developers can deploy this server locally using stdio via npx or host it remotely using Streamable HTTP. Setting up the connection requires a BrowserSolver API key provided through environment variables or HTTP headers. The server offers diverse capabilities including website_webunlocker for difficult retail sites, website_screenshot for generating visual assets like PNG or PDF, and website_technology to identify CMS or security frameworks. It also includes management tools like usage to monitor credit balances and stats to check infrastructure health.
What you can do with it
- 1Bypass website bot protectionsIdentify the specific security vendor protecting a URL to select the appropriate fetching tier.
- 2Capture website visualsConvert a public web address into a visual file format like a JPEG or PDF.
- 3Analyze web technology stacksMap out the frameworks, analytics, and CDNs used by a specific website.
- 4Monitor API account statusCheck your current credit balance and real-time usage statistics.
Written from the project's README. Every use case is checked against a quote from it.
How to install BrowserSolver MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall BrowserSolver MCP in Claude Code
$ claude mcp add --env 'BROWSERSOLVER_API_KEY=<YOUR_BROWSERSOLVER_API_KEY>' browsersolver-mcp -- npx -y @browsersolver/mcpInstall BrowserSolver MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"browsersolver-mcp": {
"command": "npx",
"args": [
"-y",
"@browsersolver/mcp"
],
"env": {
"BROWSERSOLVER_API_KEY": "<YOUR_BROWSERSOLVER_API_KEY>"
}
}
}
}Install BrowserSolver MCP in VS Code
.vscode/mcp.json
{
"servers": {
"browsersolver-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@browsersolver/mcp"
],
"env": {
"BROWSERSOLVER_API_KEY": "<YOUR_BROWSERSOLVER_API_KEY>"
}
}
}
}Install BrowserSolver MCP in VS Code CLI
$ code --add-mcp '{"name":"browsersolver-mcp","type":"stdio","command":"npx","args":["-y","@browsersolver/mcp"],"env":{"BROWSERSOLVER_API_KEY":"<YOUR_BROWSERSOLVER_API_KEY>"}}'Install BrowserSolver MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"browsersolver-mcp": {
"command": "npx",
"args": [
"-y",
"@browsersolver/mcp"
],
"env": {
"BROWSERSOLVER_API_KEY": "<YOUR_BROWSERSOLVER_API_KEY>"
}
}
}
}Install BrowserSolver MCP in Codex
$ codex mcp add browsersolver-mcp --env 'BROWSERSOLVER_API_KEY=<YOUR_BROWSERSOLVER_API_KEY>' -- npx -y @browsersolver/mcpInstall BrowserSolver MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.browsersolver-mcp] command = "npx" args = ["-y", "@browsersolver/mcp"] [mcp_servers.browsersolver-mcp.env] BROWSERSOLVER_API_KEY = "<YOUR_BROWSERSOLVER_API_KEY>"
Install BrowserSolver MCP in Gemini CLI
$ gemini mcp add -s user -e 'BROWSERSOLVER_API_KEY=<YOUR_BROWSERSOLVER_API_KEY>' browsersolver-mcp npx -- -y @browsersolver/mcpInstall BrowserSolver MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"browsersolver-mcp": {
"command": "npx",
"args": [
"-y",
"@browsersolver/mcp"
],
"env": {
"BROWSERSOLVER_API_KEY": "<YOUR_BROWSERSOLVER_API_KEY>"
}
}
}
}BrowserSolver MCP tools 8
Detected from the READMEstatsusagewebsite_antibotwebsite_crawlerwebsite_renderingwebsite_screenshotwebsite_technologywebsite_webunlocker
| stats | — | |
| usage | — | |
| website_antibot | — | |
| website_crawler | — | |
| website_rendering | — | |
| website_screenshot | — | |
| website_technology | — | |
| website_webunlocker | — |
Configuration
BROWSERSOLVER_API_KEYRequiredSecretBrowserSolver API key.
| Name | Description | |
|---|---|---|
| BROWSERSOLVER_API_KEY | BrowserSolver API key. | RequiredSecret |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubBrowserSolver MCP Server
Official Model Context Protocol server for the BrowserSolver web unlocker API.
Unlock, render, crawl and screenshot any website — anti-bot bypass and technology detection through one API.
It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).
Requirements
Hosted server (recommended)
BrowserSolver runs this server for you at https://mcp.browsersolver.com/ (Streamable HTTP). Send your API key in the x-api-key header; nothing to install.
claude mcp add --transport http browsersolver https://mcp.browsersolver.com/ --header "x-api-key: YOUR_API_KEY"
{
"mcpServers": {
"browsersolver": {
"url": "https://mcp.browsersolver.com/",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}
The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.
Run it locally
Claude Code
claude mcp add browsersolver --env BROWSERSOLVER_API_KEY=YOUR_API_KEY -- npx -y @browsersolver/mcp
Claude Desktop, Cursor, Windsurf and other clients
Add the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):
{
"mcpServers": {
"browsersolver": {
"command": "npx",
"args": ["-y", "@browsersolver/mcp"],
"env": {
"BROWSERSOLVER_API_KEY": "YOUR_API_KEY"
}
}
}
}
VS Code
{
"servers": {
"browsersolver": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@browsersolver/mcp"],
"env": {
"BROWSERSOLVER_API_KEY": "${input:browsersolver-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "browsersolver-api-key",
"description": "BrowserSolver API key",
"password": true
}
]
}
Claude Desktop extension
Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.
Docker
docker build -t browsersolver-mcp .
docker run -i --rm -e BROWSERSOLVER_API_KEY=YOUR_API_KEY browsersolver-mcp
Tools
| Tool | Description |
|---|---|
stats |
Infrastructure health for an engine or endpoint over the last hour. Not scoped to your account or tenant. Enabled per account: HTTP 403 means contact support to activate it. |
usage |
Retrieve real-time usage statistics and credit balance for your BrowserSolver account. |
website_antibot |
Single-pass scan that names the bot-protection vendor in front of a URL so you can choose the right BrowserSolver fetch tier next. |
website_crawler |
Fast HTTP pull of public HTML with no browser session. Ideal when the first response already contains the content you need. |
website_rendering |
Run a managed browser session against a public URL and collect the HTML after client-side scripts finish. Prefer Crawler for static markup; escalate to WebUnlocker on approved hosts when challenges p… |
website_screenshot |
Turn any public URL into a PNG, JPEG, WebP, or PDF asset rendered by BrowserSolver. No local Chromium fleet to operate. |
website_technology |
Map CMS, frameworks, analytics, CDN, and security tooling exposed by a public URL. Choose simple lists or expert metadata with confidence scores. |
website_webunlocker |
BrowserSolver's highest HTML fetch tier for retail and marketplace hosts on your account whitelist. Solves persistent bot challenges that still block Rendering. |
Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.
Streamable HTTP
npx @browsersolver/mcp --http --port 3000
The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.
createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):
import { createHttpHandler } from "@browsersolver/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };
Security
- The API key is read from
BROWSERSOLVER_API_KEY(stdio) or the request headers (HTTP) and removed from error messages. - Content fetched from websites is untrusted: the server instructions tell the model to treat it as data, not instructions.
- See SECURITY.md to report a vulnerability.
Development
npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js
Built on the SDK
The server uses the official Node.js SDK (@browsersolver/sdk).
All BrowserSolver SDKs
| SDK | Package | Install |
|---|---|---|
| Node.js | @browsersolver/sdk |
npm install @browsersolver/sdk |
| Python | browsersolver |
pip install browsersolver |
| Go | browsersolver-go |
go get github.com/browsersolver/browsersolver-go |
| .NET | BrowserSolver |
dotnet add package BrowserSolver |
| Ruby | browsersolver |
gem install browsersolver |
| PHP | browsersolver/sdk |
composer require browsersolver/sdk |
| Java | browsersolver-java |
build from source, see its README |
| CLI | @browsersolver/cli |
npm install -g @browsersolver/cli |
| MCP server | @browsersolver/mcp |
npx -y @browsersolver/mcp |
License
MIT — see LICENSE.
BrowserSolver MCP questions
How do I add BrowserSolver MCP to Claude Code?
Run claude mcp add --env 'BROWSERSOLVER_API_KEY=<YOUR_BROWSERSOLVER_API_KEY>' browsersolver-mcp -- npx -y @browsersolver/mcp in your terminal. Add --scope user to make it available in every project.
How do I add BrowserSolver MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does BrowserSolver MCP provide?
It exposes 8 tools, including stats, usage, website_antibot, website_crawler, website_rendering.
What can I do with BrowserSolver?
You can unlock, render, crawl, and screenshot any website, including bypassing anti-bot protections and detecting web technologies.
How do I run the server?
You can use the hosted version via Streamable HTTP or run it locally using stdio via npx.
Does using the tools cost anything?
Yes, every tool call that interacts with the API consumes credits.