tabz-browser

TabzChrome Browser Automation

Control Chrome via MCP tools for screenshots, interaction, debugging, and notifications.

Quick Start

Use mcp-cli to discover and call tools:

# Get tool schema (REQUIRED before calling)
mcp-cli info tabz/tabz_screenshot

# Call tool
mcp-cli call tabz/tabz_screenshot '{}'

Core Workflows

Screenshot a Page

# Get current tab info
mcp-cli call tabz/tabz_get_page_info '{}'

# Take screenshot
mcp-cli call tabz/tabz_screenshot '{}'
# Returns file path - use Read tool to view

Debug Network/API Issues

# 1. Enable capture BEFORE triggering action
mcp-cli call tabz/tabz_enable_network_capture '{}'

# 2. Trigger the action on page

# 3. Get failed requests (status >= 400)
mcp-cli call tabz/tabz_get_network_requests '{"statusMin": 400}'

# 4. Check console for JS errors
mcp-cli call tabz/tabz_get_console_logs '{"level": "error"}'

Test Responsive Design

# Emulate device
mcp-cli call tabz/tabz_emulate_device '{"device": "iPhone 14"}'

# Take screenshot
mcp-cli call tabz/tabz_screenshot '{}'

# Clear emulation
mcp-cli call tabz/tabz_emulate_clear '{}'

Fill and Submit Form

mcp-cli call tabz/tabz_fill '{"selector": "#email", "value": "test@example.com"}'
mcp-cli call tabz/tabz_click '{"selector": "button[type=submit]"}'

Notify User (TTS)

mcp-cli call tabz/tabz_speak '{"text": "Task complete"}'

Performance Profiling

mcp-cli call tabz/tabz_profile_performance '{}'
# Returns: DOM nodes, JS heap, event listeners, timing

DOM Tree Inspection

mcp-cli call tabz/tabz_get_dom_tree '{"maxDepth": 3}'

Tool Categories

Important Notes

• Always run mcp-cli info tabz/<tool> before calling
• Use explicit tabId when possible - don't rely on "active" tab
• Tab IDs are large integers (e.g., 1762561083)
• tabz_screenshot cannot capture Chrome sidebar

References

See references/ for detailed workflows:

• screenshot-workflows.md - Viewport vs full page
• network-debugging.md - API request inspection
• form-automation.md - Clicks, fills, selectors
• tts-notifications.md - Audio feedback patterns