Web & SearchMCP Registrynpm80 toolsA · 85

crawlio-browser MCP server

Name: crawlio-browser
Author: crawlio.app

app.crawlio · Updated 2mo ago

Bridge a live Chrome browser to your agent: 150 tools for capture, extraction, and observation.

At a glance

crawlio-browser is an MCP server in the Web & Search category. It runs locally over stdio via `npx -y crawlio-browser`, and declares no required credentials. It exposes 80 tools, including search, execute and observe. It scores A (85/100) on the MCP Skills Hub health score as of Oct 28, 2026.

Source 8

One-click install

VS Code VS Code Insiders Cursor

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install crawlio-browser in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install crawlio-browser in Claude CodeAnthropic's agentic CLI

Add the server

bash

claude mcp add crawlio-browser -- npx -y crawlio-browser

2
Verify it's connected
bash
```
claude mcp list
```
Sharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. search, execute, observe). It discovers them automatically.

How to install crawlio-browser in Claude DesktopDesktop app (MCP config)

Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this server

json

{
  "mcpServers": {
    "crawlio-browser": {
      "command": "npx",
      "args": [
        "-y",
        "crawlio-browser"
      ]
    }
  }
}

Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.

How to install crawlio-browser in CursorAI-first code editor

Create / edit .cursor/mcp.json in your project

json

{
  "mcpServers": {
    "crawlio-browser": {
      "command": "npx",
      "args": [
        "-y",
        "crawlio-browser"
      ]
    }
  }
}

Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

How to install crawlio-browser in Codex CLIOpenAI coding agent

Add to ~/.codex/config.toml

toml

[mcp_servers.crawlio-browser]
command = "npx"
args = ["-y", "crawlio-browser"]

Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

How to install crawlio-browser in WindsurfCodeium's agentic IDE

Edit ~/.codeium/windsurf/mcp_config.json

json

{
  "mcpServers": {
    "crawlio-browser": {
      "command": "npx",
      "args": [
        "-y",
        "crawlio-browser"
      ]
    }
  }
}

Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

How to install crawlio-browser in ClineVS Code autonomous agent

Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.

Add the server

json

{
  "mcpServers": {
    "crawlio-browser": {
      "command": "npx",
      "args": [
        "-y",
        "crawlio-browser"
      ]
    }
  }
}

How to install crawlio-browser in VS CodeCopilot / MCP support

Create .vscode/mcp.json

json

{
  "servers": {
    "crawlio-browser": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "crawlio-browser"
      ]
    }
  }
}

Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

What tools does crawlio-browser expose? (80)

Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.

searchDiscover available commands by keyword
executeRun async JS with `bridge`, `crawlio`, `smart`, `sleep`, and `compileRecording` in scope
observeStart/query/stop extension-resident training, recording, and page monitors
connect_tabConnect to a browser tab
disconnect_tabDisconnect from the current tab
list_tabsList all open tabs with IDs and URLs
get_connection_statusCheck CDP connection state
reconnect_tabForce reconnect to fix stale connections
get_capabilitiesReport live browser-bridge availability by tab, CDP domain, and permission state
capture_pageFull capture: framework + network + console + DOM
detect_frameworkDetect JS framework and version
start_network_captureStart recording network requests
stop_network_captureStop recording and return captured requests
get_console_logsGet console logs (errors, warnings, info)
get_cookiesGet cookies (sensitive values redacted)
get_dom_snapshotSimplified DOM tree with shadow DOM and iframe support
take_screenshotViewport/full-page/element image (JPEG default, PNG on request)
get_response_bodyGet response body for a captured network request
browser_navigateNavigate to a URL (auto-settle)
browser_clickClick element by CSS selector (auto-settle, left/right/middle, modifiers)
browser_double_clickDouble-click element
browser_typeType text into element (auto-settle)
browser_press_keyPress keyboard key (Enter, Tab, Escape, shortcuts)
browser_hoverHover over element
browser_select_optionSelect `` by value (auto-settle)
browser_scrollScroll page or element
browser_dragDrag from one element to another
browser_file_uploadUpload files to ``
browser_waitWait N milliseconds
browser_wait_forWait for element state (visible, hidden, attached, detached)
browser_interceptBlock, modify headers, or mock responses for URL patterns
emulate_networkThrottle network (offline, 3G, 4G, WiFi presets)
set_cache_disabledDisable/enable browser cache
set_extra_headersAdd custom headers to all requests
get_websocket_connectionsList active WebSocket connections
get_websocket_messagesGet WebSocket message history
get_frame_treeGet frame hierarchy (main + iframes)
switch_to_frameSwitch execution context to iframe
switch_to_main_frameSwitch back to main frame
create_tabCreate new tab with URL
close_tabClose tab by ID
switch_tabFocus a tab by ID
set_cookieSet cookie (supports httpOnly via CDP)
delete_cookiesDelete cookies by name/domain/path
get_storageRead localStorage or sessionStorage
set_storageWrite storage item
clear_storageClear all storage items
get_databasesList IndexedDB databases
query_object_storeQuery IndexedDB object store
clear_databaseClear or delete IndexedDB database
get_dialogGet pending JS dialog (alert/confirm/prompt)
handle_dialogAccept or dismiss dialog
set_viewportSet viewport dimensions
set_user_agentOverride User-Agent string
emulate_deviceEmulate device (iPhone, iPad, Pixel, Galaxy, Desktop)
set_geolocationOverride geolocation coordinates
set_stealth_modeAnti-detection mode (opt-in, patches webdriver fingerprint)
get_security_stateTLS certificate details, protocol, cipher
ignore_certificate_errorsIgnore cert errors for staging environments
list_service_workersList all service worker registrations
stop_service_workerStop/unregister a service worker
bypass_service_workerBypass service workers for network requests
set_outer_htmlReplace element's HTML
set_attributeSet element attribute
remove_attributeRemove element attribute
remove_nodeRemove element from DOM
start_css_coverageTrack which CSS rules are used
start_js_coverageTrack which JS code is executed
get_computed_styleGet resolved CSS properties for element
force_pseudo_stateForce :hover, :focus, :active states
get_performance_metricsChrome metrics + Web Vitals (LCP, CLS, FID)
get_dom_countersCount DOM nodes, documents, event listeners
force_gcForce garbage collection
take_heap_snapshotV8 heap snapshot summary
print_to_pdfGenerate PDF (custom paper, margins, orientation)
get_accessibility_treeAccessibility tree for screen-reader audit
get_targetsList all Chrome targets (pages, workers, extensions)
attach_to_targetAttach CDP session to any target
create_browser_contextCreate isolated (incognito-like) context
highlight_elementHighlight element with colored overlay

What the code can do

Read from the published package source — never executed. Parsed 27 of 27 source files.

This server can run other programs on your machine, read and write files and make network requests.

Some of this package is bundled— its dependencies are compiled into the published files. The capabilities below are really in what runs on your machine, but they may come from a bundled library rather than the author's own source.

How it was published

No provenance attestation — there is nothing linking this published artifact to a specific source commit.
1 npm maintainer — a single point of compromise · last published by rashidazarang.

Maintainer of this package and think something here is wrong? Tell us and we'll correct it.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
Downloads at launch — The package is fetched from its registry each run unless you pin a version.

Last commit 2 months ago — Actively maintained.
Repository created 2 months ago — Very new project with little track record yet.
8 GitHub stars — Very little community usage so far.
70 weekly downloads — Very few installs — you would be an early user.

Client compatibility

Claude Code: NativeClaude Desktop: NativeCursor: NativeCodex CLI: NativeWindsurf: NativeCline: NativeVS Code: Native

Health score

A · 85

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

Maintenance30%93%
Last commit 80 days ago.
Adoption20%36%
8 stars, 70 weekly downloads.
Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
Provenance15%100%
Package and registry entry point at the same repository.
Packaging15%100%
Publishes a pinned version (1.11.0).

Documentation

Full README

Crawlio Browser

Documentation | API Reference | Chrome Extension

MCP server that gives AI full control of a live Chrome browser via CDP. 150 tools with framework-aware intelligence, typed evidence infrastructure, tracking pixel analysis, technographic fingerprinting, SEO auditing, and confidence-tracked findings — captures what static crawlers can't see.

When to use Crawlio Browser

Use Crawlio Browser when your AI needs to interact with a real browser — SPAs, authenticated pages, dynamic content, JS-rendered frameworks. Unlike headless browser tools, Crawlio Browser connects to your actual Chrome via a lightweight extension, giving the AI access to your logged-in sessions, cookies, and full browser state.

Crawlio Browser vs headless browser tools: Headless tools launch a separate browser process. Crawlio Browser connects to your existing Chrome — no separate browser, no login flows, full access to your tabs and sessions.

[!WARNING] This is the trade-off, stated plainly: connecting your own Chrome is the feature, and it means an AI agent can act as you on every site you are logged into. It attaches Chrome's debugger to the tab you connect, so it can read cookies, storage, and page content for that session. Review what you connect it to. Prefer a dedicated Chrome profile for agent work. Nothing is captured until you connect a tab, and you can see the exact tool surface before configuring anything by running npx crawlio-browser tools. Sites can opt out with <meta name="crawlio-agent" content="disable">, which the extension honors.

Quick Start

Install the Chrome Extension
Run the init wizard:

bash

   npx crawlio-browser init

That's it. Auto-detects and configures 14 MCP clients: Claude Code, Cursor, VS Code, Codex, Gemini CLI, Claude Desktop, ChatGPT Desktop, Windsurf, Cline, Zed, Goose, OpenCode, MCPorter, and Cline CLI.

Init wizard options

bash

npx crawlio-browser init              # Default: code mode, stdio transport
npx crawlio-browser init --full       # Full mode (every tool exposed individually)
npx crawlio-browser init --portal     # Portal mode (persistent HTTP server)
npx crawlio-browser init --cloudflare # Add Cloudflare MCP (89 tools, no wrangler)
npx crawlio-browser init --dry-run    # Show what would happen
npx crawlio-browser init --yes        # Skip prompts (CI / scripted installs)
npx crawlio-browser init -a claude    # Target specific MCP client

As an Agent Plugin

Excerpt — the full document is on GitHub.

Alternatives to crawlio-browser

Maintain crawlio-browser? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown

[![crawlio-browser on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/app-crawlio-crawlio-browser)](https://mcp-skills-hub.vercel.app/mcps/app-crawlio-crawlio-browser)

Catalog data refreshed Oct 28, 2026. Something wrong? Report it.