# browserless/browserless-mcp [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/browserless/browserless-mcp  
**GitHub Stars:** 7  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/browserless-browserless-mcp

## Description
Headless browser automation and web scraping infrastructure. Exposes the Browserless smart scraper API to LLM clients over MCP.

## Tools
Capabilities this server exposes over MCP:

- **browserless_smartscraper** — Scrape a single webpage and return its content as markdown or HTML. Handles JavaScript-heavy pages and anti-bot measures automatically. For content across multiple pages, use `browserless_crawl`; to list a site's URLs, use `browserless_map`.
- **browserless_search** — Search the web using Browserless and optionally scrape each result. Supports web, news, and image search with geo-targeting and time filters.
- **browserless_map** — Discover and map all URLs on a website. Scans via sitemaps and link extraction. Returns URLs with optional titles and descriptions. Useful for site audits and content discovery.
- **browserless_crawl** — Crawl a website and scrape every discovered page. Supports depth control, path filtering, sitemap strategies, and configurable scrape options. Returns scraped content and metadata for each page.
- **browserless_performance** — Run Lighthouse audits on any URL. Returns scores and metrics for accessibility, best practices, performance, PWA, and SEO. Optionally filter by category or supply performance budgets.
- **browserless_function** — Execute custom Puppeteer JavaScript on the Browserless cloud. The function receives a `page` object and optional `context`; return `{ data, type }` to control the payload and Content-Type.
- **browserless_export** — Export a webpage via the Browserless `/export` API. Fetches the URL and returns its native content (HTML, PDF, image, etc.) with automatic content-type detection.
- **browserless_agent** — Drive a persistent browser session via a ReAct loop: snapshot the page, plan, batch interactions (click, type, scroll, evaluate, etc.), and re-snapshot. Uses ref-based selectors derived from snapshots, supports multi-tab workflows, screenshots, captcha solving, live URLs, and file upload/download (…
- **browserless_skill** — Load an on-demand recipe for a non-trivial page mechanic (shadow DOM, cookie consent, modals, captchas, dynamic content, snapshot misses, screenshots, tabs). Companion to `browserless_agent`.
- **browserless_profiles** — List the authentication profiles saved for the current token, with cookie and origin counts. Pass a profile's name as `profile` to another tool to reuse its logged-in state.
- **browserless_account** — Read the account behind the current token: plan, unit balance, billing period, and API key names. Never returns API token values.
- **browserless_usage** — Read request and unit consumption: successes, errors, timeouts, queueing, peak concurrency, captchas, proxy bytes and units. Optionally scoped to specific API keys.
- **browserless_sessions** — Inspect the account's sessions — browsers running now, persistent sessions on dedicated workers, recorded session replays, and 1Password credential integrations. Also downloads a replay as a fully self-contained rrweb player page (`action: "replay"`) that needs no network to render: opened in your…
- **browserless_logs** — Read Browserless's own record of recent requests: what was attempted, whether it failed, why it stopped, how long it took and what it cost. The tool for diagnosing a run that failed on the Browserless side. Available window is plan-dependent.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "browserless-mcp": {
    "command": "npx",
    "args": ["-y","browserless-browserless-mcp"]
  }
}
```

## Documentation

## What browserless/browserless-mcp does

The browserless/browserless-mcp MCP server exposes Browserless.io capabilities to MCP clients. It is intended for agents that need to retrieve content from modern websites, search the web, inspect site structure, automate browser interactions, or review Browserless activity.

The server covers both direct data collection and interactive workflows. Single-page scraping can return Markdown or HTML, while mapping and crawling support broader site discovery. Browser sessions can be driven through snapshots and ref-based actions, including clicks, typing, scrolling, evaluation, screenshots, multiple tabs, captcha handling, and file transfers.

## How it works

The client sends MCP tool calls to Browserless through the hosted endpoint. Browserless executes the browser or API operation and returns the resulting content, metadata, metrics, session information, or account data to the client.

For interactive pages, `browserless_agent` uses a repeated snapshot, planning, action, and re-snapshot process. `browserless_skill` supplies recipes for page mechanics such as shadow DOM, cookie notices, modal dialogs, captchas, dynamic content, screenshots, and tabs. Authentication profiles can be listed and then passed to other tools to reuse saved cookies and origins.

## Setup and configuration

The browserless/browserless-mcp MCP server is configured with a Browserless API token. Create or obtain the token from Browserless.io, then add the hosted MCP URL to the client configuration:

```json
{
  "mcpServers": {
    "browserless": {
      "url": "https://mcp.browserless.io/mcp?token=your-token-here"
    }
  }
}
```

The documented setup runs remotely and does not require a local installation. The README names Claude Desktop, Cursor, VS Code, and Windsurf as supported MCP clients. A free Browserless tier is available, according to the supplied material.

## Tools and capabilities

- `browserless_smartscraper` extracts one webpage as Markdown or HTML, including JavaScript-heavy pages and pages requiring anti-bot handling.
- `browserless_search` performs web, news, or image searches, with optional result scraping, geographic targeting, and time filters.
- `browserless_map` discovers URLs through sitemaps and link extraction, optionally returning titles and descriptions.
- `browserless_crawl` scrapes discovered pages with controls for depth, path filters, sitemap strategy, and scrape options.
- `browserless_performance` runs Lighthouse audits for accessibility, best practices, performance, PWA, and SEO, with optional category filters and performance budgets.
- `browserless_function` runs custom Puppeteer JavaScript with a `page` object and optional context. The returned `{ data, type }` controls the payload and content type.
- `browserless_export` retrieves a page through the Browserless export API and detects native output such as HTML, PDF, or images.
- `browserless_agent` operates persistent browser sessions and supports multi-tab work, screenshots, captcha solving, live URLs, and upload or download workflows.
- `browserless_profiles`, `browserless_account`, and `browserless_usage` expose saved authentication profiles, account details, and consumption data.
- `browserless_sessions` inspects active, persistent, and recorded sessions and can download a self-contained replay page. `browserless_logs` reports recent request outcomes, timing, stopping reasons, and cost.

## Limitations and notes

The browserless/browserless-mcp MCP server depends on a Browserless API token and the hosted Browserless service. Log history availability depends on the account plan. Account inspection does not return API token values. Browserless usage and session information reflects the account associated with the current token, and authentication profiles must already be saved there before another tool can reuse them.

For multi-page content, use crawling rather than the single-page scraper. Use mapping when the goal is to enumerate URLs without scraping every page. Custom browser behavior requires Puppeteer JavaScript, while more complex interactive page mechanics may require loading a matching skill before or during agent operation.

_Full upstream README: https://allmcps.com/mcp/browserless-browserless-mcp/readme_