cremote/mcp/LLM_USAGE_GUIDE.md

# Cremote MCP Tools - LLM Usage Guide

Cremote MCP server provides 67 web automation and accessibility testing tools. All tools accept optional `tab` (tab ID) and `timeout` (seconds, default varies) parameters unless otherwise noted.

## 🚀 NEW: Optimized Workflows (Reduce Tool Calls by 50-70%)

### Key Optimizations

1. **web_navigate_cremotemcp** - Now supports cache clearing and data extraction in a single call
2. **Read-only tools** - Many tools now accept optional `url` and `clear_cache` parameters to navigate first
3. **web_accessibility_full_audit_cremotemcp** - NEW master tool: navigate + clear cache + full accessibility audit in one call

### Before vs After Examples

**Before (3 tool calls):**
```
web_navigate_cremotemcp: {url: "https://example.com"}
web_clear_cache_cremotemcp: {}
web_extract_cremotemcp: {type: "source"}
```

**After (1 tool call):**
```
web_navigate_cremotemcp: {
  url: "https://example.com",
  clear_cache: true,
  extract: "source"
}
```

**Before (3 tool calls for accessibility):**
```
web_navigate_cremotemcp: {url: "https://example.com"}
web_clear_cache_cremotemcp: {}
web_page_accessibility_report_cremotemcp: {tests: ["all"]}
```

**After (1 tool call):**
```
web_accessibility_full_audit_cremotemcp: {
  url: "https://example.com",
  clear_cache: true,
  tests: ["all"]
}
```

---

## Tool Categories

**Core Automation (12):** navigate, interact, extract, screenshot, tabs, iframe, console, file operations
**Element Inspection (2):** check state, get attributes
**Data Extraction (4):** multiple selectors, links, tables, text patterns
**Forms (3):** analyze, bulk fill, batch interact
**Page Intelligence (4):** page info, viewport, performance, content check
**Screenshots (3):** basic, element, enhanced with metadata
**File Management (3):** upload, download, bulk operations
**Cache Control (5):** enable/disable/clear cache, cookies, storage, all site data
**Mouse/Keyboard (11):** drag-drop (3 variants), right/double/middle/hover click, mouse move, scroll wheel, key combos, special keys, modifier clicks
**Accessibility Tree (3):** full tree, partial tree, query by role/name
**Accessibility Testing (19):** axe-core, contrast checks, keyboard nav, forms, WCAG compliance, media validation, OCR, animations, cross-page consistency, zoom/reflow tests, **NEW: full audit with navigation**

---

## Core Automation Tools

### web_navigate_cremotemcp
Navigate to URL with optional cache clearing, screenshot, and data extraction in a single call.
- `url` (required): URL to navigate to
- `clear_cache` (optional): boolean, clear cache before navigation (default: false)
- `screenshot` (optional): boolean, take screenshot after navigation
- `extract` (optional): "source", "element", or "javascript" - extract data after navigation
- `extract_selector` (optional): CSS selector for element extraction (required when extract="element")
- `extract_code` (optional): JavaScript code to execute (required when extract="javascript")
- Default timeout: 5s

### web_interact_cremotemcp
Interact with elements: click, fill, submit, upload, select.
- `action` (required): "click", "fill", "submit", "upload", "select"
- `selector` (required): CSS selector
- `value` (optional): for fill/upload/select actions
- Note: upload action auto-transfers files from host to container
- Default timeout: 5s

### web_extract_cremotemcp
Extract page data: source HTML, element content, or execute JavaScript. Optionally navigate to URL first with cache clearing.
- `type` (required): "source", "element", "javascript"
- `selector` (optional): required for "element" type
- `code` (optional): required for "javascript" type
- `url` (optional): navigate to URL before extraction
- `clear_cache` (optional): boolean, clear cache before operation (default: false)
- Default timeout: 5s

### web_screenshot_cremotemcp
Take page screenshots with zoom/viewport options.
- `output` (required): file path for screenshot
- `full_page` (optional): boolean, capture full page (default: false)
- `width` (optional): viewport width in pixels
- `height` (optional): viewport height in pixels
- `zoom_level` (optional): zoom level (e.g., 1.0, 2.0, 4.0)
- Default timeout: 5s

### web_manage_tabs_cremotemcp
Manage browser tabs: open, close, list, switch.
- `action` (required): "open", "close", "list", "switch"
- `tab` (optional): required for "close" and "switch"
- Default timeout: 5s

### web_iframe_cremotemcp
Switch iframe context for subsequent operations.
- `action` (required): "enter", "exit"
- `selector` (optional): iframe CSS selector, required for "enter"
- Default timeout: 5s

### console_command_cremotemcp
Execute JavaScript in browser console.
- `command` (required): JavaScript code to execute
- `inject_library` (optional): library name (axe, jquery, lodash, moment, underscore) or URL
- Default timeout: 5s

### console_logs_cremotemcp
Get console logs from browser tab.
- `clear` (optional): boolean, clear logs after retrieval (default: false)
- Default timeout: 5s

### file_upload_cremotemcp
Upload file from client to container. Note: web_interact_cremotemcp with action="upload" now auto-handles transfers.
- `local_path` (required): path on client machine
- `container_path` (optional): path in container (defaults to /tmp/filename)

### file_download_cremotemcp
Download file from container to client.
- `container_path` (required): path in container
- `local_path` (required): path on client machine

### file_operations_bulk_cremotemcp
Bulk upload/download multiple files.
- `operation` (required): "upload" or "download"
- `files` (required): array of {local_path, container_path} objects
- Default timeout: 30s

### file_management_cremotemcp
File management: cleanup, list, get info.
- `operation` (required): "cleanup", "list", "info"
- `pattern` (optional): file pattern for cleanup/list, or file path for info
- `max_age` (optional): max age in hours for cleanup (default: 24)

---

## Element Inspection Tools

### web_element_check_cremotemcp
Check element state: exists, visible, enabled, focused, selected. Optionally navigate to URL first with cache clearing.
- `selector` (required): CSS selector
- `check_type` (optional): "exists", "visible", "enabled", "focused", "selected", "all" (default: "exists")
- `url` (optional): navigate to URL before checking element
- `clear_cache` (optional): boolean, clear cache before operation (default: false)
- Returns: JSON with boolean values for each check + count
- Default timeout: 5s

### web_element_attributes_cremotemcp
Get element attributes, properties, computed styles. Optionally navigate to URL first with cache clearing.
- `selector` (required): CSS selector
- `attributes` (optional): "all" or comma-separated list (default: "all")
- Prefixes: none=HTML attr, `style_`=computed CSS, `prop_`=JS property
- `url` (optional): navigate to URL before getting attributes
- `clear_cache` (optional): boolean, clear cache before operation (default: false)
- Default timeout: 5s

---

## Data Extraction Tools

### web_extract_multiple_cremotemcp
Extract from multiple selectors in one call.
- `selectors` (required): object with label:selector pairs
- Returns: {results: {label: content}, errors: {}}
- Default timeout: 5s

### web_extract_links_cremotemcp
Extract all links with filtering.
- `container_selector` (optional): limit search to container
- `href_pattern` (optional): regex to filter by href
- `text_pattern` (optional): regex to filter by text
- Returns: array of {href, text, title, target} + count
- Default timeout: 5s

### web_extract_table_cremotemcp
Extract table as structured JSON.
- `selector` (required): table CSS selector
- `include_headers` (optional): boolean (default: true)
- Returns: {headers, rows, data (structured), count}
- Default timeout: 5s

### web_extract_text_cremotemcp
Extract text with pattern matching.
- `selector` (required): CSS selector
- `pattern` (optional): regex pattern to match
- `extract_type` (optional): "text", "innerText", "textContent" (default: "textContent")
- Returns: {text, matches, count}
- Default timeout: 5s

---

## Form Tools

### web_form_analyze_cremotemcp
Analyze form structure, fields, requirements.
- `selector` (required): form CSS selector
- Returns: {action, method, fields[], field_count, can_submit, submit_text}
- Default timeout: 5s

### web_form_fill_bulk_cremotemcp
Fill entire form with key-value pairs.
- `fields` (required): object mapping field names/selectors to values
- `form_selector` (optional): form CSS selector
- Returns: {filled_fields[], success_count, error_count, total_count}
- Default timeout: 5s

### web_interact_multiple_cremotemcp
Batch interactions in one call.
- `interactions` (required): array of {selector, action, value} objects
- Actions: "click", "fill", "select", "check", "uncheck"
- Returns: {results[], success_count, error_count, total_count}
- Default timeout: 5s

---

## Page Intelligence Tools

### web_page_info_cremotemcp
Get page metadata and state. Optionally navigate to URL first with cache clearing.
- `url` (optional): navigate to URL before getting page info
- `clear_cache` (optional): boolean, clear cache before operation (default: false)
- Returns: {title, url, loading_state, ready_state, domain, protocol, charset, cookie_enabled, online_status}
- Default timeout: 5s

### web_viewport_info_cremotemcp
Get viewport and scroll information.
- Returns: {width, height, scroll_x, scroll_y, scroll_width, scroll_height, device_pixel_ratio, orientation}
- Default timeout: 5s

### web_performance_metrics_cremotemcp
Get page performance metrics.
- Returns: {navigation_start, load_event_end, load_time, dom_load_time, resource_count, js_heap_size_used}
- Default timeout: 5s

### web_content_check_cremotemcp
Check content types and loading states.
- `type` (required): "images", "scripts", "styles", "forms", "links", "iframes", "errors"
- Returns: type-specific metrics (e.g., images_loaded, images_total)
- Default timeout: 5s

---

## Screenshot Tools

### web_screenshot_element_cremotemcp
Screenshot specific element.
- `selector` (required): element CSS selector
- `output` (required): file path
- Auto-scrolls element into view
- Default timeout: 5s

### web_screenshot_enhanced_cremotemcp
Screenshot with metadata.
- `output` (required): file path
- `full_page` (optional): boolean (default: false)
- Returns: {timestamp, url, title, viewport_size, full_page, file_path, file_size, resolution}
- Default timeout: 5s

---

## Cache Control Tools

### web_disable_cache_cremotemcp
Disable browser cache for tab. No required parameters. Default timeout: 5s

### web_enable_cache_cremotemcp
Enable browser cache for tab. No required parameters. Default timeout: 5s

### web_clear_cache_cremotemcp
Clear browser cache. No required parameters. Default timeout: 5s

### web_clear_cookies_cremotemcp
Clear cookies. No required parameters. Default timeout: 5s

### web_clear_storage_cremotemcp
Clear web storage (localStorage, sessionStorage, IndexedDB). No required parameters. Default timeout: 5s

### web_clear_all_site_data_cremotemcp
Clear all site data (cookies, storage, cache). No required parameters. Default timeout: 5s

---

## Mouse/Keyboard Tools

### web_drag_and_drop_cremotemcp
Drag element to target element with HTML5 events.
- `source` (required): source element CSS selector
- `target` (required): target element CSS selector
- Default timeout: 5s

### web_drag_and_drop_coordinates_cremotemcp
Drag element to specific coordinates.
- `source` (required): source element CSS selector
- `x` (required): target X coordinate
- `y` (required): target Y coordinate
- Default timeout: 5s

### web_drag_and_drop_offset_cremotemcp
Drag element by relative offset.
- `source` (required): source element CSS selector
- `offset_x` (required): horizontal offset in pixels
- `offset_y` (required): vertical offset in pixels
- Default timeout: 5s

### web_right_click_cremotemcp
Right-click on element to open context menu.
- `selector` (required): element CSS selector
- Default timeout: 5s

### web_double_click_cremotemcp
Double-click on element for file operations or text selection.
- `selector` (required): element CSS selector
- Default timeout: 5s

### web_middle_click_cremotemcp
Middle-click on element (typically opens links in new tabs).
- `selector` (required): element CSS selector
- Default timeout: 5s

### web_hover_cremotemcp
Hover over element to trigger tooltips or dropdowns.
- `selector` (required): element CSS selector
- Default timeout: 5s

### web_mouse_move_cremotemcp
Move mouse to coordinates without clicking.
- `x` (required): X coordinate
- `y` (required): Y coordinate
- Default timeout: 5s

### web_scroll_wheel_cremotemcp
Scroll with mouse wheel at coordinates.
- `x` (required): X coordinate
- `y` (required): Y coordinate
- `delta_y` (required): vertical scroll delta (negative=up, positive=down)
- `delta_x` (optional): horizontal scroll delta (default: 0)
- Default timeout: 5s

### web_key_combination_cremotemcp
Send key combinations (Ctrl+C, Alt+Tab, Shift+Enter, etc).
- `keys` (required): key combination string
- Default timeout: 5s

### web_special_key_cremotemcp
Send special keys (Enter, Escape, Tab, F1-F12, Arrow keys, Home, End, PageUp, PageDown, Delete, Backspace).
- `key` (required): special key name
- Default timeout: 5s

### web_modifier_click_cremotemcp
Click with modifier keys (Ctrl+click, Shift+click, Alt+click).
- `selector` (required): element CSS selector
- `modifiers` (required): modifier keys (e.g., "Ctrl", "Shift", "Alt", "Ctrl+Shift")
- Default timeout: 5s

---

## Accessibility Tree Tools

### get_accessibility_tree_cremotemcp
Get full or depth-limited accessibility tree.
- `depth` (optional): maximum depth to retrieve (omit for full tree)
- `include_contrast` (optional): boolean, include contrast check data (default: false)
- Default timeout: 5s

### get_partial_accessibility_tree_cremotemcp
Get accessibility tree for specific element and relatives.
- `selector` (required): element CSS selector
- `fetch_relatives` (optional): boolean, include ancestors/siblings/children (default: true)
- Default timeout: 5s

### query_accessibility_tree_cremotemcp
Query accessibility tree by role/name.
- `selector` (optional): CSS selector to limit scope
- `accessible_name` (optional): accessible name to match
- `role` (optional): ARIA role to match (e.g., "button", "textbox", "link")
- Default timeout: 5s

---

## Accessibility Testing Tools

### version_cremotemcp
Get MCP server and daemon version information. No parameters required.

### web_inject_axe_cremotemcp
Inject axe-core accessibility testing library. **NOTE**: Auto-injection happens automatically when using web_run_axe_cremotemcp or web_page_accessibility_report_cremotemcp, so manual injection is optional.
- `version` (optional): axe-core version (default: "4.8.0")
- Default timeout: 10s

### web_run_axe_cremotemcp
Run axe-core tests, return violations/passes/incomplete/inapplicable. **Automatically injects axe-core if not already loaded.**
- `run_only` (optional): array of tags (e.g., ["wcag2a", "wcag2aa", "wcag21aa"])
- `rules` (optional): specific rules configuration object
- Returns: {url, timestamp, test_engine, violations[], passes[], incomplete[], inapplicable[]}
- Default timeout: 30s

### web_contrast_check_cremotemcp
Check color contrast ratios for text elements, verify WCAG AA/AAA compliance.
- `selector` (optional): CSS selector for specific elements (defaults to all text)
- Returns: {total_elements, passed_aa, failed_aa, passed_aaa, failed_aaa, unable_to_check, elements[]}
- Default timeout: 10s

### web_contrast_audit_cremotemcp
Smart contrast checking with prioritized failures and pattern detection. Returns only failures, significantly reducing token usage.
- `priority_selectors` (optional): array of CSS selectors to prioritize (e.g., ["button", "a", "nav"])
- `threshold` (optional): "AA" or "AAA" (default: "AA")
- Returns: {pass_rate, critical_failures (top 20), failure_patterns}
- Default timeout: 10s

### web_gradient_contrast_check_cremotemcp
Check contrast for text on gradient backgrounds using ImageMagick. Samples 100 points, reports worst-case ratio.
- `selector` (required): CSS selector for element with gradient background
- Returns: {selector, text_color, darkest_bg_color, lightest_bg_color, worst_contrast, best_contrast, is_large_text, required_aa, required_aaa, passes_aa, passes_aaa, sample_points}
- Default timeout: 10s

### web_keyboard_test_cremotemcp
Test keyboard navigation: tab order, focus indicators, keyboard traps.
- Returns: {total_interactive, focusable, not_focusable, no_focus_indicator, keyboard_traps, issues[], tab_order[]}
- Default timeout: 15s

### web_keyboard_audit_cremotemcp
Keyboard navigation assessment with actionable summary. Reduces token usage by ~80% vs full test.
- `check_focus_indicators` (optional): boolean (default: true)
- `check_tab_order` (optional): boolean (default: true)
- `check_keyboard_traps` (optional): boolean (default: true)
- Returns: summary of issues by type/severity with recommendations
- Default timeout: 15s

### web_enhanced_accessibility_cremotemcp
Enhanced accessibility tree analysis with ARIA validation, role verification, relationship checking (WCAG 1.3.1, 4.1.2).
- Returns: {total_elements, elements_with_issues, aria_violations, role_violations, relationship_issues, landmark_issues, elements[]}
- Default timeout: 10s

### web_form_accessibility_audit_cremotemcp
Comprehensive form accessibility check: labels, ARIA, keyboard, contrast.
- `form_selector` (optional): CSS selector for specific form (defaults to all forms)
- Returns: summarized form analysis with issues by category
- Default timeout: 10s

### web_page_accessibility_report_cremotemcp
Comprehensive page assessment combining axe-core, contrast, keyboard, forms. Token-efficient format (~4k tokens vs ~80k). **Automatically injects axe-core if not already loaded.**
- `tests` (optional): array of test types (e.g., ["wcag", "contrast", "keyboard", "forms"]) or ["all"]
- `standard` (optional): WCAG standard (default: "WCAG21AA")
- `include_screenshots` (optional): boolean (default: false)
- Returns: {compliance_status, overall_score, legal_risk, issues by severity, contrast_summary, keyboard_summary, form_summary, estimated_remediation_hours}
- Default timeout: 30s

### web_accessibility_full_audit_cremotemcp ⭐ NEW
**Master accessibility tool**: Navigate to URL, clear cache, and run comprehensive accessibility assessment in a single call. Combines navigation, cache clearing, and all accessibility tests. **Automatically injects axe-core if not already loaded.**
- `url` (required): URL to navigate to and test
- `clear_cache` (optional): boolean, clear cache before navigation (default: true)
- `tests` (optional): array of test types (e.g., ["wcag", "contrast", "keyboard", "forms"]) or ["all"]
- `standard` (optional): WCAG standard (default: "WCAG21AA")
- `include_screenshots` (optional): boolean (default: false)
- Returns: {compliance_status, overall_score, legal_risk, issues by severity, contrast_summary, keyboard_summary, form_summary, estimated_remediation_hours}
- Default timeout: 30s
- **Use this tool for single-call accessibility audits with navigation**

### web_media_validation_cremotemcp
Validate video/audio for WCAG compliance: captions, audio descriptions, transcripts, controls, autoplay.
- Returns: {videos[], audios[], embedded_players[], transcript_links[], critical_violations, total_violations, warnings}
- Default timeout: 10s

### web_hover_focus_test_cremotemcp
Test WCAG 1.4.13 compliance for hover/focus content: dismissibility, hoverability, persistence.
- Returns: {total_elements, elements_with_issues, passed_elements, issues[], tested_elements[]}
- Default timeout: 10s

### web_text_in_images_cremotemcp
Detect text in images using Tesseract OCR, flag WCAG 1.4.5/1.4.9 violations.
- Returns: {total_images, images_with_text, images_without_text, violations, warnings, images[]}
- Default timeout: 30s (OCR processing)

### web_animation_flash_cremotemcp
Detect animations and flashing content that may trigger seizures (WCAG 2.3.1, 2.2.2).
- Returns: {total_animations, flashing_content, rapid_animations, autoplay_animations, violations, warnings, elements[]}
- Default timeout: 10s

### web_cross_page_consistency_cremotemcp
Check consistency of navigation, headers, footers, landmarks across pages (WCAG 3.2.3, 3.2.4).
- `urls` (required): array of URLs to check
- Returns: {pages_checked, consistency_issues, navigation_issues, structure_issues, pages[]}
- Default timeout: 10s per page

### web_zoom_test_cremotemcp
Test page at zoom levels (100%, 200%, 400%), verify WCAG 1.4.4 and 1.4.10 compliance.
- `zoom_levels` (optional): array of zoom levels (default: [1.0, 2.0, 4.0])
- Returns: {zoom_levels[], issues[]}
- Default timeout: 10s per level

### web_reflow_test_cremotemcp
Test responsive design at WCAG breakpoints (320px, 1280px), verify WCAG 1.4.10 reflow compliance.
- `widths` (optional): array of viewport widths in pixels (default: [320, 1280])
- Returns: {breakpoints[], issues[]}
- Default timeout: 10s per width

---

## Common Patterns

### Basic Navigation
```
web_navigate_cremotemcp: {url: "https://example.com", screenshot: true}
```

### Form Completion
```
# Analyze form structure
web_form_analyze_cremotemcp: {selector: "#contact-form"}

# Fill all fields
web_form_fill_bulk_cremotemcp: {
  form_selector: "#contact-form",
  fields: {name: "John Doe", email: "john@example.com", message: "Test"}
}

# Submit
web_interact_cremotemcp: {action: "click", selector: "button[type='submit']"}
```

### Batch Operations
```
web_interact_multiple_cremotemcp: {
  interactions: [
    {selector: "#agree", action: "check"},
    {selector: "#country", action: "select", value: "US"},
    {selector: "#submit", action: "click"}
  ]
}
```

### File Upload (Auto-Transfer)
```
# Modern approach - auto-transfers from host
web_interact_cremotemcp: {
  action: "upload",
  selector: "input[type='file']",
  value: "/home/user/document.pdf"
}
```

### Accessibility Assessment
```
# Comprehensive report (~4k tokens)
web_page_accessibility_report_cremotemcp: {
  tests: ["all"],
  standard: "WCAG21AA",
  timeout: 30
}

# Or individual tests
web_contrast_audit_cremotemcp: {priority_selectors: ["button", "a", "nav"]}
web_keyboard_audit_cremotemcp: {}
web_form_accessibility_audit_cremotemcp: {form_selector: "form"}
```

### Data Extraction
```
# Extract multiple elements
web_extract_multiple_cremotemcp: {
  selectors: {
    title: "h1",
    price: ".price",
    description: ".description"
  }
}

# Extract table
web_extract_table_cremotemcp: {selector: "#data-table", include_headers: true}

# Extract links
web_extract_links_cremotemcp: {container_selector: "nav", href_pattern: "https://.*"}
```

---

## Best Practices

1. **Use optimized workflows**: Combine navigation, cache clearing, and operations in single calls to reduce tool usage by 50-70%
2. **Use specific CSS selectors**: Prefer `input[name='email']` over `input`
3. **Batch operations**: Use `web_interact_multiple_cremotemcp` or `web_form_fill_bulk_cremotemcp` for efficiency
4. **Accessibility testing**: Use `web_accessibility_full_audit_cremotemcp` for single-call audits with navigation, or `web_page_accessibility_report_cremotemcp` for current page assessment
5. **File uploads**: Use `web_interact_cremotemcp` with action="upload" - auto-handles host-to-container transfer
6. **Timeouts**: Increase for slow pages or complex operations
7. **Screenshots**: Use `web_screenshot_enhanced_cremotemcp` for metadata, `web_screenshot_element_cremotemcp` for specific elements

---

## Optimized Workflow Examples

### Single-Call Accessibility Audit
```
# Before (3 calls):
web_navigate_cremotemcp: {url: "https://example.com"}
web_clear_cache_cremotemcp: {}
web_page_accessibility_report_cremotemcp: {tests: ["all"]}

# After (1 call):
web_accessibility_full_audit_cremotemcp: {
  url: "https://example.com",
  clear_cache: true,
  tests: ["all"],
  standard: "WCAG21AA"
}
```

### Navigate and Extract
```
# Before (2 calls):
web_navigate_cremotemcp: {url: "https://example.com"}
web_extract_cremotemcp: {type: "source"}

# After (1 call):
web_navigate_cremotemcp: {
  url: "https://example.com",
  extract: "source"
}
```

### Navigate, Clear Cache, and Check Element
```
# Before (3 calls):
web_navigate_cremotemcp: {url: "https://example.com"}
web_clear_cache_cremotemcp: {}
web_element_check_cremotemcp: {selector: "#login-button", check_type: "visible"}

# After (1 call):
web_element_check_cremotemcp: {
  url: "https://example.com",
  clear_cache: true,
  selector: "#login-button",
  check_type: "visible"
}
```

### Navigate, Clear Cache, and Get Page Info
```
# Before (3 calls):
web_navigate_cremotemcp: {url: "https://example.com"}
web_clear_cache_cremotemcp: {}
web_page_info_cremotemcp: {}

# After (1 call):
web_page_info_cremotemcp: {
  url: "https://example.com",
  clear_cache: true
}
```

---

## Error Handling

Common errors:
- **Element not found**: Verify selector with browser dev tools
- **Timeout**: Increase timeout parameter for slow-loading content
- **Navigation failed**: Check URL accessibility
- **File not found**: Verify file paths for upload/download operations

---

## Notes

- All tools return structured JSON responses
- Tab management is automatic if no tab ID specified
- File upload operations now auto-detect host paths and transfer to container
- Accessibility tools follow WCAG 2.1 Level AA/AAA standards
- Screenshot tools automatically copy files from container to host
- Default timeouts vary by tool complexity (5-30 seconds)