freema/firefox-devtools-mcp

• promptTextstring

  Text for prompt dialogs

Без параметров.

Без параметров.

• dblClickboolean

  Double-click (default: false)

• uidstringобязательный

  Element UID from snapshot

• pageIdxnumberобязательный

  Tab index to close

Без параметров.

• fromUidstringобязательный

  Source element UID

• toUidstringобязательный

  Target element UID

• argsobject[]

  UIDs to pass as function arguments

• functionstringобязательный

  JS function string, e.g. () => document.title

• previewnumber

  Number of characters of the saved result to return inline as a preview when saveTo is used. Omit for no preview.

• sandboxstring

  Evaluate in an isolated sandbox realm with this name instead of the page realm. The sandbox shares the page DOM and keeps the native built-ins even where the page overrode them. Page-defined globals and expandos are invisible from the sandbox, and vice-versa. The same name reuses the same sandbox across calls; omit to evaluate in the page realm.

• saveToboolean | string

  Save the result to a file as JSON instead of returning it inline. Pass a file path, an existing directory (generated file inside), or true (generated file under ~/.firefox-devtools-mcp/output/). Relative paths resolve against the current working directory.

• timeoutnumber

  Timeout in ms (default: 5000)

• uidstringобязательный

  Input element UID from snapshot

• valuestringобязательный

  Text to fill

• elementsobject[]обязательный

  Array of {uid, value} pairs

Без параметров.

• grepstring

  Filter log lines containing this string (case-insensitive)

• linesnumber

  Number of recent log lines to return (default: 100, max: 10000)

• sincenumber

  Only show logs written in the last N seconds

• maxLengthnumber

  Max characters to return inline (default: 20000). Ignored when saveTo is used.

• previewnumber

  Number of characters of the saved text to return inline as a preview when saveTo is used. Omit for no preview.

• saveToboolean | string

  Save the full untruncated text to a file instead of returning it inline. Pass a file path, an existing directory (generated file inside), or true (generated file under ~/.firefox-devtools-mcp/output/). Relative paths resolve against the current working directory.

• uidstringобязательный

  Element UID from snapshot

• pathstring

  File path (for archivePath or path types)

• permanentboolean

  Firefox-specific: Install permanently (requires signed extension). Default: false (temporary install)

• typeenumобязательный

  Extension data type: "archivePath" for .xpi/.zip, "base64" for encoded data, "path" for unpacked directory

• valuestring

  Base64-encoded extension data (for base64 type)

• formatenum

  Output format (default: text)

• limitnumber

  Max downloads (default: 50)

• statusenum

  Filter by status

• urlContainsstring

  URL filter (case-insensitive)

Без параметров.

• directionenumобязательный

  back or forward

• urlstringобязательный

  Target URL

• waitenum

  When to return: 'none' (navigation started), 'interactive' (DOMContentLoaded), 'complete' (load event fired, including subresources). Omit for the default: 'interactive' for http/https/data/blob/file, 'none' for other schemes. Use 'complete' when the page must be fully loaded, e.g. before stopping a performance recording.

• urlstringобязательный

  Target URL

• waitenum

  When to return: 'none' (navigation started), 'interactive' (DOMContentLoaded), 'complete' (load event fired, including subresources). Omit for the default: 'interactive' for http/https/data/blob/file, 'none' for other schemes. Use 'complete' when the page must be fully loaded, e.g. before stopping a performance recording.

• keystringобязательный

  One key, optionally preceded by "+"-separated modifiers, such as "Escape", "Enter" or "ctrl+shift+t". Modifiers: ctrl, alt, shift, meta. Named keys: Enter, Return, NumpadEnter, Tab, Backspace, Delete, Insert, Space, Escape, Home, End, PageUp, PageDown, ArrowUp, ArrowDown, ArrowLeft, ArrowRight, F1-F12, Numpad0-Numpad9, Clear, Pause, Help, Cancel, Semicolon, Equals, Add, Subtract, Multiply, Divide, Decimal, Separator. Anything else must be a single character. Any number of modifiers, but only one key.

• uidstring

  Focusable element UID from snapshot to focus before pressing (default: the already focused element)

• uidstringобязательный

  UID from snapshot

• envstring[]

  New environment variables in KEY=VALUE format (optional, e.g., ["MOZ_LOG=HTMLMediaElement:5", "MOZ_LOG_FILE=/tmp/ff.log"])

• firefoxPathstring

  New Firefox binary path (optional, keeps current if not specified)

• headlessboolean

  Run in headless mode (optional, keeps current if not specified)

• prefsobject

  Firefox preferences to set at startup. Values are auto-typed: true/false become booleans, integers become numbers, everything else is a string. Requires MOZ_REMOTE_ALLOW_SYSTEM_ACCESS=1.

• profilePathstring

  Firefox profile path (optional, keeps current if not specified)

• startUrlstring

  URL to navigate to after restart (optional, uses about:blank if not specified)

• contextstring

  Id of the top-level browsing context to record. Defaults to the currently selected page.

• frameRateinteger

  Target frame rate of the recording, in frames per second.

• heightinteger

  Height of the recorded video in pixels. Defaults to the viewport height.

• mimeTypestring

  MIME type of the output file. Defaults to "video/webm".

• widthinteger

  Width of the recorded video in pixels. Defaults to the viewport width.

• screencaststring

  Id of the screencast to stop, as returned by screencast_start. Optional when exactly one recording is active.

• saveToboolean | string

  Save the screenshot to a file instead of returning it as image data in the response. Pass a file path, an existing directory (generated file inside), or true (generated file under ~/.firefox-devtools-mcp/output/). Relative paths resolve against the current working directory.

• uidstringобязательный

  Element UID from snapshot

• saveToboolean | string

  Save the screenshot to a file instead of returning it as image data in the response. Pass a file path, an existing directory (generated file inside), or true (generated file under ~/.firefox-devtools-mcp/output/). Relative paths resolve against the current working directory.

• pageIdxnumber

  Tab index (0-based, most reliable)

• titlestring

  Title substring (case-insensitive)

• urlstring

  URL substring (case-insensitive)

• behaviorenumобязательный

  'allowed' saves downloads automatically, 'denied' cancels them, 'default' resets to the browser default

• heightnumberобязательный

  Height in pixels

• widthnumberобязательный

  Width in pixels

• includeAllboolean

  Include all visible elements without relevance filtering. Useful for Vue/Livewire apps (default: false)

• includeAttributesboolean

  Include ARIA attributes (default: false)

• includeTextboolean

  Include text (default: true)

• maxDepthnumber

  Max tree depth

• maxLinesnumber

  Max lines (default: 100)

• previewnumber

  Number of characters of the saved output to return inline as a preview when saveTo is used. Omit for no preview.

• saveToboolean | string

  Save the complete snapshot text to a file (ignores maxLines) instead of returning it inline. Pass a file path, an existing directory (generated file inside), or true (generated file under ~/.firefox-devtools-mcp/output/). Relative paths resolve against the current working directory.

• selectorstring

  CSS selector to scope snapshot to specific element (e.g., "#app")

• submitKeystring

  Key to press after the text, such as "Enter" or "Tab". Same syntax as press_key.

• textstringобязательный

  Text to type

• uidstring

  Focusable element UID from snapshot to focus before typing (default: the already focused element)

• idstringобязательный

  Extension ID (e.g., "addon@example.com")

• filePathstringобязательный

  Local file path

• uidstringобязательный

  File input UID from snapshot