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 tab

Usage

bl mcp [OPTIONS]

Options

OptionDescription
--screenshot-dir <value>Directory for saving screenshots (default: ~/Pictures/browserlane, use "" to disable)

Global options

OptionDescription
-v, --verboseEnable 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

On this page