Utilities
bl mcp
Start the Model Context Protocol (MCP) server.
Start the Model Context Protocol (MCP) server.
This runs a JSON-RPC 2.0 server over stdin/stdout, designed for integration
with LLM agents like Claude Code.
The server provides browser automation tools:
- browser_start: Launch (or connect to) a browser without navigating
- browser_open: Navigate to a URL (url required)
- browser_click: Click an element
- browser_type: Type into an element
- browser_screenshot: Capture the page
- browser_find: Find element info
- browser_evaluate: Execute JavaScript
- browser_stop: Close the browser / end the session
- browser_get_text: Get page/element text
- browser_get_url: Get current URL
- browser_get_title: Get page title
- browser_get_html: Get page/element HTML
- browser_find_all: Find all matching elements
- browser_wait: Wait for element state
- browser_hover: Hover over an element
- browser_select: Select a dropdown option
- browser_scroll: Scroll the page
- browser_keys: Press keys
- browser_tab_new: Open a new tab
- browser_tab_list: List open tabs
- browser_context_tree: Inspect tabs + nested frames
- browser_tab_switch: Switch tabs
- browser_tab_close: Close a tabUsage
bl mcp [OPTIONS]Options
| Option | Description |
|---|---|
--screenshot-dir <value> | Directory for saving screenshots (default: ~/Pictures/browserlane, use "" to disable) |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl mcp
# Run directly for testing (configure in Claude Code via: claude mcp add ...)
bl mcp --screenshot-dir ./screenshots
# Custom screenshot directory
bl mcp --screenshot-dir ""
# Disable screenshot file saving (inline only)
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"capabilities":{}}}' | bl mcp
# Test with echo