BrowserSolver

com.browsersolverPublished by browsersolver.comOfficial publisherv0.1.0Updated Nov 7, 2026

Unlock, render, crawl and screenshot any website — anti-bot bypass and technology detection through…

Overview

AI-generated overview

BrowserSolver's official MCP server lets an assistant fetch, render, crawl and screenshot public websites, bypassing bot protection, through a paid API.

What you can do
  • Fetch public pages: fast HTTP crawls, managed browser rendering after scripts run, and a top-tier unlocker for hosts on your whitelist
  • Capture pages as PNG, JPEG, WebP or PDF screenshots without running a local browser
  • Inspect sites: detect the bot-protection vendor in front of a URL and map CMS, frameworks, analytics, CDN and security tooling
  • Check account usage, credit balance and engine or endpoint health
When to use it
Useful when an assistant needs page content that plain fetching cannot get, such as JavaScript-heavy pages or sites behind bot challenges, or when you want screenshots, PDFs and technology fingerprints of public URLs without operating your own browser infrastructure.
Requirements
A BrowserSolver account and API key. Hosted option: connect to the remote Streamable HTTP endpoint and send the key in the x-api-key header. Local option: Node.js 20 or newer and the npm package, with the key in BROWSERSOLVER_API_KEY. Network access to the BrowserSolver API.
Before you install
Every API call spends credits from your account, at 1 to 3 credits per call depending on the tool. The API key is a billable secret; keep it out of shared configs. Fetched web content is untrusted and may contain injected instructions. The stats tool is not scoped to your account and may need activation.

Installation

In SourceWeft

  1. Open BrowserSolver in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.browsersolver%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "browsersolver": {
      "type": "http",
      "url": "https://mcp.browsersolver.com/"
    }
  }
}

README

BrowserSolver 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

  • Node.js 20 or newer
  • a BrowserSolver API key — sign up, then copy it from the dashboard

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.

sh
claude mcp add --transport http browsersolver https://mcp.browsersolver.com/ --header "x-api-key: YOUR_API_KEY"
json
{  "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

sh
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…):

json
{  "mcpServers": {    "browsersolver": {      "command": "npx",      "args": ["-y", "@browsersolver/mcp"],      "env": {        "BROWSERSOLVER_API_KEY": "YOUR_API_KEY"      }    }  }}

VS Code

json
{  "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

sh
docker build -t browsersolver-mcp .docker run -i --rm -e BROWSERSOLVER_API_KEY=YOUR_API_KEY browsersolver-mcp

Tools

ToolDescription
statsInfrastructure 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.
usageRetrieve real-time usage statistics and credit balance for your BrowserSolver account.
website_antibotSingle-pass scan that names the bot-protection vendor in front of a URL so you can choose the right BrowserSolver fetch tier next.
website_crawlerFast HTTP pull of public HTML with no browser session. Ideal when the first response already contains the content you need.
website_renderingRun 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_screenshotTurn any public URL into a PNG, JPEG, WebP, or PDF asset rendered by BrowserSolver. No local Chromium fleet to operate.
website_technologyMap CMS, frameworks, analytics, CDN, and security tooling exposed by a public URL. Choose simple lists or expert metadata with confidence scores.
website_webunlockerBrowserSolver'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

sh
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):

ts
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

sh
npm installnpm testnpm run buildnpx @modelcontextprotocol/inspector node dist/stdio.js

Built on the SDK

The server uses the official Node.js SDK (@browsersolver/sdk).

All BrowserSolver SDKs

SDKPackageInstall
Node.js@browsersolver/sdknpm install @browsersolver/sdk
Pythonbrowsersolverpip install browsersolver
Gobrowsersolver-gogo get github.com/browsersolver/browsersolver-go
.NETBrowserSolverdotnet add package BrowserSolver
Rubybrowsersolvergem install browsersolver
PHPbrowsersolver/sdkcomposer require browsersolver/sdk
Javabrowsersolver-javabuild from source, see its README
CLI@browsersolver/clinpm install -g @browsersolver/cli
MCP server@browsersolver/mcpnpx -y @browsersolver/mcp

License

MIT — see LICENSE.

Source: README.md at commit ca8a0fc

Tools

8

stats

Stats

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.

Parameterspathengine

usage

Usage

Usage. Retrieve real-time usage statistics and credit balance for your BrowserSolver account.

Takes no parameters.

website_antibot

Website Antibot

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. Credit cost: 1 credit per call.

Parametersqueryrequiredfieldstimeout

website_crawler

Website Crawler

Website Crawler. Fast HTTP pull of public HTML with no browser session. Ideal when the first response already contains the content you need. Credit cost: 1 credit per call.

Parametersqueryrequiredfieldsallow_redirectsreturn_page_source

website_rendering

Website Rendering

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 persist. Credit cost: 2 credits per call.

Parametersqueryrequiredfieldstimeoutwait_forblock_adswait_in_seconds

website_screenshot

Website Screenshot

Website Screenshot. Turn any public URL into a PNG, JPEG, WebP, or PDF asset rendered by BrowserSolver. No local Chromium fleet to operate. Credit cost: 2 credits per call.

Parametersurlrequiredcachedelayproxydevicefieldsformats3_urlselectorcache_ttlfull_pages3_bucket+18 more

website_technology

Website Technology

Website Technology. Map CMS, frameworks, analytics, CDN, and security tooling exposed by a public URL. Choose simple lists or expert metadata with confidence scores. Credit cost: 1 credit per call.

Parametersmodequeryrequiredfields

website_webunlocker

Website WebUnlocker

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. Credit cost: 3 credits per call.

Parametersqueryrequiredfieldsallow_redirectsreturn_page_source

Version history

1
  1. v0.1.0LatestNov 7, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts