Bridge a live Chrome browser to your agent: 147 CDP tools for capture, extraction, and recording.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag β we're steadily working through the catalog.
π‘ Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Crawlio Browser.
connect_tabConnect to a browser tab by URL, tab ID, or active 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
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.
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.
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.
The package is also an Agent Plugins v1 plugin, so a conformant client
can load it directly instead of running the wizard β plugin.json at the root, the eleven skills
under skills/, and the MCP server declared in mcp.json.
The product-facing crawlio-* workflows are folded into the eleven shipped skills. The similarly
named definitions in agents/ remain repo-local development fixtures: they import src/evidence/*
and loops/*, neither of which is part of the npm runtime. They are excluded from package.json
instead of advertising a second, non-executable product surface.
Point the client at the installed package:
mcp.json resolves the server through ${PLUGIN_ROOT}/dist/mcp-server/index.js, which is why the
plugin has to be an installed package rather than an unpacked tarball β the server imports its
dependencies at runtime, so a bare extract starts and then dies without answering.
Both are read-only and run without a browser, an extension, or a network connection β you can see the whole surface before you configure any client. The numbers come from the same builders the server registers, so they cannot disagree with what your client receives.
| Mode | Command / URL | Protocol | Best For |
|---|---|---|---|
| stdio | npx crawlio-browser | JSON-RPC over stdin/stdout | Claude Desktop, Cursor, Windsurf β client manages process lifecycle |
| Portal (HTTP) | POST http://127.0.0.1:3001/mcp | MCP Streamable HTTP | Claude Code, ChatGPT Desktop β server survives session restarts |
| Portal (SSE) | GET /sse + POST /message | Server-Sent Events | Legacy clients needing SSE transport |
Portal mode is recommended for Claude Code β the server persists across context compaction and session restarts. On macOS, --portal installs a launchd agent for auto-start on login.
Claude Desktop β add to claude_desktop_config.json:
Claude Code (Portal Mode) β start npx crawlio-browser --portal, then add to .mcp.json:
Claude Code (stdio):
Cursor β add to .cursor/mcp.json:
Windsurf β add to Windsurf Settings > MCP:
Cline (VS Code) β add to settings.json:
ChatGPT Desktop β Settings > Integrations > MCP:
URL: http://127.0.0.1:3001/mcp | Type: Streamable HTTP
The MCP server communicates with the Chrome extension via WebSocket. The extension controls the browser through Chrome DevTools Protocol (CDP).
Every execute call probes the browser for framework signatures and injects a shape-shifting smart object with framework-native accessors. React state, Vue reactivity, Next.js routing, Shopify cart data β 17 framework namespaces across 4 tiers, detected at runtime and rebuilt on every navigation. The AI doesn't query a generic DOM; it queries the framework's own data structures.
Method Mode adds higher-order methods and a typed evidence system on top of Code Mode. smart.extractPage() runs 7 parallel operations in a single call β page capture, performance metrics, security state, font detection, meta extraction, accessibility audit, and mobile-readiness check. Failed operations produce typed CoverageGap records instead of silent nulls. Findings created with smart.finding() get their confidence automatically adjusted when supporting data is missing. The result: structured, auditable research output with gap tracking and confidence propagation.
Record browser interactions as structured data, then compile them into reusable SKILL.md automations. 12 interaction tools are automatically intercepted during recording β clicks, typing, navigation, scrolling β each capturing args, result, timing, and page URL. One compileRecording() call converts the session into a deterministic automation script.
Capture human-guided browser demonstrations as replayable robot-training bundles. The default-mode
observe lifecycle starts an event-driven recorder inside the extension; collection keeps running
if the MCP process disconnects or restarts. On reconnection, training_stop exports the retained
run and materializes the complete 13-file RecordingBundle for replay and API synthesis. Full mode
keeps the existing robot_training_* names as compatibility aliases.
Page monitoring is resident for the same reason: an extension-owned background tab and Chrome alarm collect bounded ARIA snapshots while no MCP server is present. Training and monitor history share a 25 MiB local budget, with 20 completed training runs, 50 monitor jobs, 200 snapshots total, and 50 snapshots per monitor as count caps. Old completed data is evicted first; active work is never silently evicted. Work starts only through explicit MCP lifecycle actions; the same actions report status, stop collection, clear monitor snapshots, andβwith an exact id plus explicit confirmationβdelete a stopped training/recording record from Chrome while preserving its materialized files. The extension popup remains a connection and browser-access status surface. Storage values are keys-only unless the caller explicitly opts in. Monitor snapshots intentionally retain compact ARIA page text locally; starting a monitor should therefore be treated as consent to retain the visible content of that URL until it is cleared.
Every mutative action (click, type, navigate, select_option) runs actionability checks before acting β polling visibility, dimensions, enabled state, and overlay detection. After the action, a progressive backoff settle delay ([0, 20, 100, 100, 500]ms) waits for DOM mutations to quiesce. The AI doesn't need manual sleep() calls between actions.
Any command that acts on a page takes an optional tabId from list_tabs. Omit it and the command runs on the connected tab, exactly as before; supply one and it runs on that tab instead, with the whole command surface available on each. Commands overlap, so two tabs can be driven at the same time:
Targeting a tab never changes which tab connect_tab points at, so an agent working several tabs cannot reassign the one a human is watching. Frame selection, coverage sessions, and framework detection are per tab. Network capture is the exception β it records one tab at a time and says which tab holds it rather than interleaving two.
An extension instance is confined to its own Chrome profile and cannot see any other, so with Crawlio enabled in more than one, commands land in whichever profile connected first. list_profiles shows the profiles that have connected and which is being driven; switch_profile moves the connection to another. One profile is driven at a time β the released extension reconnects in the background, so switching back is immediate.
Profiles identify themselves with a UUID minted into their own extension storage. It distinguishes a profile without describing it: no account, no email, no path, and no additional permission.
Selecting a profile keeps cooperating extensions out of each other's way β it is not a security boundary, since the id is asserted by the extension rather than proved. The bridge's existing protections are unchanged: one extension at a time, and each must prove the server holds the real bridge token before anything executes.
A layered execution architecture where each layer absorbs a category of complexity that would otherwise fall on the model. The model sees four primary tools and a clean SDK. Everything beneath that surface is the runtime absorbing reality.
The layer worth understanding is the one that assembles itself. Detection runs against the live page on first use, and the smart object is built to match what that page turned out to be β smart.react.* exists only where React does. Nothing about the target is known at startup, so the surface is composed per tab rather than declared up front.
| Layer | Without It | With It |
|---|---|---|
| Tethered IPC Bridge | Script crashes on tab refresh, pending commands lost on reconnect, port conflicts on startup | Resilient WebSocket with message queue (100-msg capacity), heartbeat stale detection (15s intervals), auto-reconnect with drain |
| Actionability Engine | click('#btn') fires before the button renders, during CSS transitions, or while an overlay covers it | Progressive polling (exists β has dimensions β visible β not disabled β not obscured) with [0, 20, 100, 100, 500]ms backoff |
| Polymorphic Context | Model sees minified <div> elements; reading React state requires knowing exact hook paths, renderer maps, and fiber root API | Runtime probes live JS environment, recognizes 64 frameworks and attaches up to 17 matching namespaces (smart.react.getVersion(), smart.nextjs.getData()) |
| Method Mode | Model composes primitives ad-hoc β inconsistent scroll loops, missed edge cases, varying return shapes | 18 tested methods encode correct patterns; behavioral protocol constrains workflow |
search("page capture performance") and gets documentation for relevant commandssmart object with appropriate namespacesbridge (the browser command channel), crawlio (HTTP client), sleep, TIMEOUTS, smart (7 core + 18 higher-order methods + up to 17 framework namespaces), compileRecordingextractPage() fires 7 parallel bridge.send() calls; click() runs the actionability engine; react.getVersion() evaluates framework-specific expressionsexecute again. Framework cache persists β no re-detection unless URL changedCode Mode is Cloudflare's idea and a good one: present tools as a typed API and let the model write code against it, because models have seen far more code than tool calls. Crawlio Browser applies that pattern to a target it was not built for β a live browser holding your session. This is an MCP server, not an alternative to MCP.
| Dimension | Standard MCP | Cloudflare Code Mode | Crawlio Browser |
|---|---|---|---|
| Tools in context | 50-100+ schemas | 2 (search, execute) | 7 (4 primary + 3 async job tools) |
| Execution environment | N/A (tool calls) | V8 isolate (stateless) | Local async sandbox, tethered to a live browser |
| DOM access | Via individual tool calls | None | Live, persistent, framework-aware |
| Framework awareness | None | None | up to 17 namespaces, attached per page |
| Action resilience | Model must handle timing | N/A (no DOM) | Built-in actionability polling + settle delays |
| Error recovery | Re-call individual tool | Re-create isolate | Re-run against the state that produced the error |
| Multi-step patterns | Model improvises | Model writes loops | 18 tested higher-order methods + behavioral protocol |
The row that matters is error recovery. An isolate is disposable by design β that is what makes it safe to run untrusted code, and it means a failure discards the state that caused it. Here execution is tethered to a real tab, so when code fails the browser is still sitting in exactly the situation that broke it: same scroll position, same modal, same half-filled form. The model reads the error and runs again against that. Neither approach is better in general; they are answers to different problems, and the sandboxing guarantees Cloudflare gets from V8 isolates are genuinely stronger than what a local async sandbox provides.
Read the full architecture guide β
Collapses 150 tools into four high-level tools, plus get_job_result,
list_jobs, and cancel_job for async execution β so tools/list reports
That makes the tools/list payload 85% smaller, measured by
serializing the result each mode actually returns rather than estimated from a tool count. Code
mode is not free: execute and search carry long descriptions, so the measured reduction is
smaller than a naive tools-only ratio suggests. Check it yourself β npx crawlio-browser tools --json prints both surfaces without connecting to anything.
| Tool | Description |
|---|---|
search | Discover available commands by keyword |
execute | Run async JS with bridge, crawlio, smart, sleep, and compileRecording in scope |
observe | Start/query/stop extension-resident training, recording, and page monitors |
connect_tab | Connect to a browser tab |
Every tool exposed directly to the LLM. Enable with --full:
In Code Mode, the smart object provides framework-aware helpers with auto-waiting and actionability checks.
| Method | Description |
|---|---|
smart.evaluate(expression) | Execute JS in the page via CDP |
smart.click(selector, opts?) | Auto-waiting click with 500ms settle |
smart.type(selector, text, opts?) | Auto-waiting type with 300ms settle |
smart.navigate(url, opts?) | Navigate with 1000ms settle |
smart.waitFor(selector, timeout?) | Poll until element is actionable |
smart.snapshot() | Accessibility tree snapshot |
smart.rebuild() | Re-detect frameworks and reattach namespaces for the current page |
| Method | Description |
|---|---|
smart.scrollCapture(opts?) | Scroll to bottom, capturing screenshots at each position. Handles stuck-scroll detection, bottom detection, section capping, and scroll reset. |
smart.waitForIdle(timeout?) | MutationObserver-based idle detection β waits for 500ms quiet window. Timeout hard-capped at 15s. Replaces blind sleep() calls. |
smart.extractPage(opts?) | 7 parallel operations in one call β page capture, performance, security, fonts, meta, accessibility, mobile-readiness. Returns typed PageEvidence with CoverageGap[] for anything that failed. |
smart.comparePages(urlA, urlB) | Navigates to both URLs, runs extractPage() on each, returns a ComparisonScaffold with 11 dimensions, shared/missing fields, and comparable metrics. |
Methods for structured analysis findings with confidence propagation:
| Method | Description |
|---|---|
smart.finding(data) | Create a validated Finding with claim, evidence, sourceUrl, confidence, and method. Rejects malformed input with specific errors. |
smart.findings() | Get all session-accumulated findings (returns a copy) |
smart.clearFindings() | Reset session findings and coverage gaps |
When a finding's dimension matches an active coverage gap, confidence is automatically capped:
| Input Confidence | Active Gap | Output |
|---|---|---|
high | reducesConfidence: true | medium + confidenceCapped: true |
medium | reducesConfidence: true | low + confidenceCapped: true |
low | any | low (floor) |
| any | no matching gap | unchanged |
When a framework is detected, the smart object exposes framework-specific helpers:
smart.react| Method | Returns |
|---|---|
getVersion() | Version string and bundle type |
getRootCount() | Number of React root components |
hasProfiler() | Whether profiler is available |
isHookInstalled() | Whether DevTools hook is installed |
smart.vue| Method | Returns |
|---|---|
getVersion() | Vue version string |
getAppCount() | Number of Vue app instances |
getConfig() | App config object |
isDevMode() | Whether DevTools is enabled |
smart.angular| Method | Returns |
|---|---|
getVersion() | ng-version attribute value |
isDebugMode() | Whether debug APIs available |
isIvy() | Whether Ivy compiler is active |
getRootCount() | Number of Angular root elements |
getState() | Full state object |
smart.svelte| Method | Returns |
|---|---|
getVersion() | Svelte version string |
getMeta() | Svelte metadata object |
isDetected() | Whether Svelte is detected |
smart.redux| Method | Returns |
|---|---|
isInstalled() | Whether Redux DevTools is installed |
getStoreState() | Full store state |
smart.alpine| Method | Returns |
|---|---|
getVersion() | Alpine version string |
getStoreKeys() | Store object keys |
getComponentCount() | Count of [x-data] components |
smart.nextjs| Method | Returns |
|---|---|
getData() | __NEXT_DATA__ object |
getRouter() | Router state (pathname, query, asPath) |
getSSRMode() | SSR mode (hybrid, app-router, static) |
getRouteManifest() | Current page data |
smart.nuxt| Method | Returns |
|---|---|
getData() | __NUXT__ object |
getConfig() | App config |
isSSR() | Whether server-rendered |
smart.remix| Method | Returns |
|---|---|
getContext() | __remixContext object |
getRouteData() | Loader data from state |
smart.shopify| Method | Returns |
|---|---|
getShop() | Shop metadata (theme, locale, currency) |
getCart() | Shopping cart object |
smart.wordpress| Method | Returns |
|---|---|
isWP() | Whether WordPress is present |
getRestUrl() | REST API endpoint |
getPlugins() | List of active plugins |
| Namespace | Methods |
|---|---|
smart.gatsby | getData(), getPageData() |
smart.woocommerce | getParams() |
smart.laravel | getCSRF() |
smart.django | getCSRF() |
smart.drupal | getSettings() |
smart.jquery | getVersion() |
Code Mode asks the model to write code. Method Mode gives that code a tested vocabulary:
18 higher-order methods that encode the multi-step patterns a modelwould otherwise improvise.
It is a domain layer over Code Mode, not a replacement: the tool surface does not change, the
model still sees the same four primary tools, and the same 182-command
catalog sits underneath. What changes is what happens inside execute.
The surface is assembled per page. Detection recognizes 64
frameworks and attaches up to 17 matching namespaces, so smart.react.*
exists only where React does β the model never has to ask what the page is built with, or guess
at hook paths and fiber internals to find out.
And because execution is tethered to a live tab rather than a disposable isolate, a failure leaves the browser in the exact state that produced it. The model reads the structured error and runs again against that state, rather than rebuilding the situation from scratch.
| Layer | Optimizes For | Behavioral Variance | Evidence Quality |
|---|---|---|---|
| Raw MCP (150 tools) | Completeness | High β flat tool list, no composition guidance | None β unstructured text |
| Code Mode (7 tools) | Token efficiency | Medium β right primitives, ad-hoc composition | None β model-defined shapes |
| Method Mode (+ 18 methods + protocol) | Consistency | Low β proper methods, protocol constraints | Convention β { finding, evidence, url } |
| + typed evidence (gaps + confidence) | Correctness | Minimal β typed schemas, tool-enforced findings | Structural β typed records, gap tracking, confidence propagation |
Each layer up encodes more domain knowledge. bridge.send({ type: "capture_page" }) captures a page. smart.extractPage() captures a page AND runs performance metrics, security state, font detection, accessibility analysis, and mobile-readiness checks in parallel β seven operations, one call, graceful failure on supplementary data, typed gaps for anything that fails.
Coverage Gaps β When supplementary operations in extractPage() fail, they don't silently return null. A typed gap is recorded with the dimension, reason, impact, and whether it reduces confidence on related findings:
Tool-Enforced Findings β smart.finding() validates every field at the tool level. The model cannot produce a finding without meeting the schema β it either returns a valid Finding or gets a clear error. Findings accumulate across execute calls within a session via smart.findings().
Session Aggregation β Findings and coverage gaps persist across execute calls. A model can make findings across multiple calls, then retrieve the full set with smart.findings(). Reset with smart.clearFindings().
Record browser sessions as structured data, then compile them into reusable automation skills. 12 interaction tools are automatically intercepted during recording (click, type, navigate, scroll, etc.), capturing args, result, timing, and page URL.
In full mode, recording is available as 4 individual tools: start_recording, stop_recording, get_recording_status, and compile_recording.
Mutative tools (browser_click, browser_type, browser_navigate, browser_select_option) use actionability checks:
[0, 20, 100, 100, 500]msThis means the AI doesn't need to manually add sleep() or waitFor() calls between actions β the tools handle SPA rendering delays automatically.
Detects 64 technologies across 4 tiers using globals, DOM markers, meta tags, HTTP headers, and script URLs:
| Tier | Frameworks | Signal Strength |
|---|---|---|
| Meta-frameworks | Next.js, Nuxt, SvelteKit, Remix, Gatsby | Unique globals + parent detection |
| Core | React, Vue.js, Angular, Svelte, Astro, Qwik, SolidJS, Lit, Preact | Globals + DOM markers |
| CMS & Platforms | WordPress, Shopify, Webflow, Squarespace, Wix, Drupal, Magento, Ghost, Bubble | Meta tags + globals |
| Libraries & Tools | jQuery, Bootstrap, Tailwind CSS, Alpine.js, HTMX, Turbo, Stencil, Redux, Ember.js, Backbone.js | DOM + globals |
Multi-framework detection returns a primary framework (meta-framework takes priority) plus a subFrameworks array for the full stack.
The table below is a hand-written guide to the commonly used tools, not the complete set. For
the full, current surface β all 150 of them, read from the server itself β
run npx crawlio-browser tools --full.
| Tool | Description |
|---|---|
connect_tab | Connect to a browser tab by URL, tab ID, or active tab |
disconnect_tab | Disconnect from the current tab |
list_tabs | List all open tabs with IDs and URLs |
get_connection_status | Check CDP connection state |
reconnect_tab | Force reconnect to fix stale connections |
get_capabilities | Report live browser-bridge availability by tab, CDP domain, and permission state |
| Tool | Description |
|---|---|
capture_page | Full capture: framework + network + console + DOM |
detect_framework | Detect JS framework and version |
start_network_capture | Start recording network requests |
stop_network_capture | Stop recording and return captured requests |
get_console_logs | Get console logs (errors, warnings, info) |
get_cookies | Get cookies (sensitive values redacted) |
get_dom_snapshot | Simplified DOM tree with shadow DOM and iframe support |
take_screenshot | Viewport/full-page/element image (JPEG default, PNG on request) |
get_response_body | Get response body for a captured network request |
| Tool | Description |
|---|---|
browser_navigate | Navigate to a URL (auto-settle) |
browser_click | Click element by CSS selector (auto-settle, left/right/middle, modifiers) |
browser_double_click | Double-click element |
browser_type | Type text into element (auto-settle) |
browser_press_key | Press keyboard key (Enter, Tab, Escape, shortcuts) |
browser_hover | Hover over element |
browser_select_option | Select <option> by value (auto-settle) |
browser_scroll | Scroll page or element |
browser_drag | Drag from one element to another |
browser_file_upload | Upload files to <input type="file"> |
browser_wait | Wait N milliseconds |
browser_wait_for | Wait for element state (visible, hidden, attached, detached) |
| Tool | Description |
|---|---|
browser_intercept | Block, modify headers, or mock responses for URL patterns |
emulate_network | Throttle network (offline, 3G, 4G, WiFi presets) |
set_cache_disabled | Disable/enable browser cache |
set_extra_headers | Add custom headers to all requests |
get_websocket_connections | List active WebSocket connections |
get_websocket_messages | Get WebSocket message history |
| Tool | Description |
|---|---|
get_frame_tree | Get frame hierarchy (main + iframes) |
switch_to_frame | Switch execution context to iframe |
switch_to_main_frame | Switch back to main frame |
create_tab | Create new tab with URL |
close_tab | Close tab by ID |
switch_tab | Focus a tab by ID |
| Tool | Description |
|---|---|
set_cookie | Set cookie (supports httpOnly via CDP) |
delete_cookies | Delete cookies by name/domain/path |
get_storage | Read localStorage or sessionStorage |
set_storage | Write storage item |
clear_storage | Clear all storage items |
get_databases | List IndexedDB databases |
query_object_store | Query IndexedDB object store |
clear_database | Clear or delete IndexedDB database |
| Tool | Description |
|---|---|
get_dialog | Get pending JS dialog (alert/confirm/prompt) |
handle_dialog | Accept or dismiss dialog |
| Tool | Description |
|---|---|
set_viewport | Set viewport dimensions |
set_user_agent | Override User-Agent string |
emulate_device | Emulate device (iPhone, iPad, Pixel, Galaxy, Desktop) |
set_geolocation | Override geolocation coordinates |
set_stealth_mode | Anti-detection mode (opt-in, patches webdriver fingerprint) |
| Tool | Description |
|---|---|
get_security_state | TLS certificate details, protocol, cipher |
ignore_certificate_errors | Ignore cert errors for staging environments |
| Tool | Description |
|---|---|
list_service_workers | List all service worker registrations |
stop_service_worker | Stop/unregister a service worker |
bypass_service_worker | Bypass service workers for network requests |
| Tool | Description |
|---|---|
set_outer_html | Replace element's HTML |
set_attribute | Set element attribute |
remove_attribute | Remove element attribute |
remove_node | Remove element from DOM |
| Tool | Description |
|---|---|
start_css_coverage / stop_css_coverage | Track which CSS rules are used |
start_js_coverage / stop_js_coverage | Track which JS code is executed |
get_computed_style | Get resolved CSS properties for element |
force_pseudo_state | Force :hover, :focus, :active states |
| Tool | Description |
|---|---|
get_performance_metrics | Chrome metrics + Web Vitals (LCP, CLS, FID) |
get_dom_counters | Count DOM nodes, documents, event listeners |
force_gc | Force garbage collection |
take_heap_snapshot | V8 heap snapshot summary |
| Tool | Description |
|---|---|
print_to_pdf | Generate PDF (custom paper, margins, orientation) |
get_accessibility_tree | Accessibility tree for screen-reader audit |
| Tool | Description |
|---|---|
get_targets | List all Chrome targets (pages, workers, extensions) |
attach_to_target | Attach CDP session to any target |
create_browser_context | Create isolated (incognito-like) context |
| Tool | Description |
|---|---|
highlight_element | Highlight element with colored overlay |
show_layout_shifts | Visualize CLS regions |
show_paint_rects | Visualize paint/repaint areas |
| Tool | Description |
|---|---|
start_recording | Begin recording browser session |
stop_recording | Stop recording and return session data |
get_recording_status | Check recording state |
compile_recording | Compile session into SKILL.md automation |
| Tool | Description |
|---|---|
robot_training_start | Start a fresh monitored demonstration run |
robot_training_status | Query extension-retained runs and recording state |
robot_training_stop | Stop/export a resident run and persist all bundle artifacts |
robot_training_clear | Confirm deletion of one stopped extension-retained run; preserve artifact files |
robot_training_artifacts | List files in a robot-training artifact directory |
monitor_page | Start/query/stop extension-resident recurring page monitors |
Optional β requires Crawlio.app running locally.
ControlServer authentication is automatic and local-only: the MCP reads CRAWLIO_MCP_TOKEN when
explicitly set, otherwise Crawlio.app's mode-0600 ~/Library/Logs/Crawlio/mcp.token, and sends it
only to the discovered 127.0.0.1 ControlServer. The value is never returned in MCP results or
written to logs.
| Tool | Description |
|---|---|
extract_site | Start a Crawlio crawl of the active tab's URL |
get_crawl_status | Get crawl progress and status |
get_enrichment | Get browser enrichment data |
get_crawled_urls | Get crawled URLs with status and pagination |
enrich_url | Navigate + capture + submit enrichment in one call |
The production extension has no standing host access. Its required permissions are debugger
(the CDP control plane), storage (bridge/session settings and durable resident metadata), and
alarms (reconnect, idle-release, and resident monitor wakeups). The dedicated onboarding page
asks once for every optional capability declared by the active build. In production that is tabs,
nativeMessaging, and http://127.0.0.1/*, covering tab discovery/adoption, authenticated local
token provisioning, and loopback bridge discovery.
Onboarding is the only surface that can open Chrome's permission prompt. The extension popup and
MCP tools only report missing access and route the user back to onboarding. connect_tab({url}),
agent-owned tabs, robot training, and resident monitoring can still create and control their own
tabs if the tabs metadata grant is denied. Crawlio does not request <all_urls>, activeTab,
tabGroups, or unlimitedStorage.
Build output lands in dist/mcp-server/ (ESM bundle) and dist/extension/ (the
unpacked MV3 extension).
To develop against the extension, build the dev variant and load it unpacked:
Then open chrome://extensions, enable Developer mode, choose Load unpacked,
and select dist/extension-dev. Reload the extension there after each rebuild.
Contributions are welcome β see CONTRIBUTING.md for the build and development loop, and CODE_OF_CONDUCT.md for community expectations. Please report security vulnerabilities privately via SECURITY.md rather than in a public issue.
Apache-2.0 β see LICENSE.
The selector kernel in packages/selectors is MIT-licensed:
it contains code ported from Selector Forge (MIT) and Chromium DevTools
(BSD-3-Clause). See packages/selectors/LICENSE and
THIRD_PARTY_NOTICES.md for full attributions.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/crawlio-browser)<a href="https://allmcps.com/mcp/crawlio-browser"><img src="https://allmcps.com/api/badge/crawlio-browser?style=directory" alt="Crawlio Browser on AllMCPs" /></a>