cremote/mcp/QUICK_REFERENCE.md

2.8 KiB

Cremote MCP Tools - Quick Reference

Tool Names

  • web_navigate_cremotemcp - Navigate to URLs
  • web_interact_cremotemcp - Interact with elements
  • web_extract_cremotemcp - Extract page data
  • web_screenshot_cremotemcp - Take screenshots
  • web_manage_tabs_cremotemcp - Manage browser tabs
  • web_iframe_cremotemcp - Switch iframe context
  • file_upload_cremotemcp - Upload files to container
  • file_download_cremotemcp - Download files from container
  • console_logs_cremotemcp - Get browser console logs
  • console_command_cremotemcp - Execute console commands

Essential Parameters

web_navigate_cremotemcp

url: "https://example.com"        # Required
screenshot: true                  # Optional, default false
timeout: 10                      # Optional, default 5 seconds

web_interact_cremotemcp

action: "click"                  # Required: click|fill|submit|upload
selector: "button.submit"        # Required: CSS selector
value: "text to fill"           # Required for fill/upload actions
timeout: 10                     # Optional, default 5 seconds

Common Patterns

Navigate + Screenshot

web_navigate_cremotemcp:
  url: "https://example.com"
  screenshot: true

Fill Form Field

web_interact_cremotemcp:
  action: "fill"
  selector: "input[name='email']"
  value: "user@example.com"

Click Button

web_interact_cremotemcp:
  action: "click"
  selector: "button#submit"

Submit Form

web_interact_cremotemcp:
  action: "submit"
  selector: "form"

Upload File

web_interact_cremotemcp:
  action: "upload"
  selector: "input[type='file']"
  value: "/path/to/file.pdf"

Upload File to Container

file_upload_cremotemcp:
  local_path: "/home/user/document.pdf"
  container_path: "/tmp/upload.pdf"

Download File from Container

file_download_cremotemcp:
  container_path: "/tmp/downloaded.pdf"
  local_path: "/home/user/Downloads/file.pdf"

Get Console Logs

console_logs_cremotemcp:
  clear: true

Execute Console Command

console_command_cremotemcp:
  command: "document.title"
  timeout: 10

Best CSS Selectors

Good:

  • #unique-id
  • input[name='fieldname']
  • button.primary-submit
  • form#login-form

Avoid:

  • div (too generic)
  • input (too broad)
  • :nth-child(3) (fragile)

Typical Workflow

  1. Navigate to target page
  2. Fill required form fields
  3. Click submit buttons
  4. Take screenshots for verification
  5. Navigate to next page if needed

Error Handling

  • Element not found: Check CSS selector
  • Timeout: Increase timeout parameter
  • Navigation failed: Verify URL accessibility

Screenshots

Screenshots are automatically saved to /tmp/navigate-{timestamp}.png when requested.