cremote/mcp/QUICK_REFERENCE.md

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

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"

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.