CLI referenceAgent & MCP
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: Start a browser session
- browser_navigate: Go to a URL
- 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: Stop the browser
- 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_new_page: Open a new page
- browser_list_pages: List open pages
- browser_switch_page: Switch pages
- browser_close_page: Close a pageUsage
bl mcp [flags]Flags
| Flag | Description |
|---|---|
--screenshot-dir string | Directory for saving screenshots (default: ~/Pictures/browserlane, use "" to disable) |
Global flags
| Flag | Description |
|---|---|
--headless | Hide browser window (visible by default) |
--json | Output as JSON |
-v, --verbose | Enable debug logging |
Examples
# Run directly (for testing)
bl mcp
# Configure in Claude Code
claude mcp add bl -- bl mcp
# Custom screenshot directory
bl mcp --screenshot-dir ./screenshots
# Disable screenshot file saving (inline only)
bl mcp --screenshot-dir ""
# Test with echo
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"capabilities":{}}}' | bl mcp