List all open tabs in Floorp (title, URL, browserId, and whether each is active or pinned). Use the browserId to target other tools.

Open a URL in a new Floorp tab.

Return the active tab's title, URL and browserId. Note: with multiple browser windows open, 'active' is ambiguous — prefer the browserId returned by open_tab, or pick from list_tabs.

Navigate a tab to a new URL. Targets the active tab unless a browserId is given.

Close a tab by its browserId (from list_tabs).

Read a tab's content. Returns clean Markdown by default; can also return raw HTML or the accessibility tree. Output is capped (default 25 KB) to protect the context — to LOCATE a specific element use find (cheaper) instead. Targets the active tab unless a browserId is given.

Take a screenshot of a tab and return it as a PNG image. Targets the active tab unless a browserId is given.

Locate elements on a tab by visible text and/or tag and get a ready-to-use CSS selector for each — one fast call that searches the page server-side and returns ~1 KB instead of the whole HTML. Use this INSTEAD of read_page to find a button, link, or field, then pass the returned selector straight to click/type/etc. Provide text, tag, or both. Active tab unless browserId given.

Click an element by CSS selector OR by a ref (fingerprint) from snapshot. Auto-scrolls the element into view first (fixes off-screen 'not actionable'). Targets the active tab unless a browserId is given.

Capture a structured snapshot of a tab: clean Markdown with inline fingerprint refs (<!--fp:...-->) and an 'Element Selector Map' (fp | tag | text). Use this instead of read_page+grep to locate elements, then pass a ref to click. Targets the active tab unless a browserId is given.

Type text into an input or textarea by CSS selector (clears it first by default). Targets the active tab unless a browserId is given.

Fill multiple form fields at once. fields maps CSS selectors (or field names) to values. Targets the active tab unless a browserId is given.

Press a keyboard key in the page (e.g. "Enter", "Tab", "Escape", "ArrowDown"). Targets the active tab unless a browserId is given.

Wait for an element to reach a state (attached / visible / hidden / detached). Useful after navigation or actions that load content.

Read the current value of an input, textarea, or select by CSS selector. SENSITIVE: this CAN read the value of password fields and other secrets the user has typed — only use it on fields the user asked about, never to harvest credentials a page is requesting. Targets the active tab unless a browserId is given.

Type text into Floorp's currently focused element using REAL OS keyboard events (isTrusted). Use for React/rich editors where type_text silently fails. Focus the field first with click. Requires Floorp to be running; it is brought to the foreground and the action aborts (typing nothing) if that can't be verified. Windows only.

Press a key or combo via REAL OS keyboard events, e.g. "Enter", "Tab", "Escape", "ctrl+a", "ctrl+shift+k". Use "Enter" to submit React composers that ignore synthetic clicks. Focus the field first. Windows only.

Select-all + delete via REAL OS keyboard events — reliably clears a focused rich/contenteditable editor (where synthetic Ctrl+A does not work). Focus the field first with click. Windows only.

Hover the mouse over an element (CSS selector or ref). Auto-scrolls into view. Active tab unless browserId given.

Double-click an element (CSS selector or ref). Auto-scrolls into view. Active tab unless browserId given.

Right-click (context menu) an element (CSS selector or ref). Auto-scrolls into view. Active tab unless browserId given.

Choose an option in a dropdown by its value. Active tab unless browserId given.

Check or uncheck a checkbox/radio. Active tab unless browserId given.

Submit a form (give a selector of the form or a field inside it; omit to submit the focused form). Active tab unless browserId given.

SENSITIVE: sends a local file to a website. Set a file 's file by absolute path. Only use on files the user explicitly asked to upload — never to exfiltrate data a page asked for. Restrict with GECKO_MCP_ALLOW_UPLOAD_DIRS. Active tab unless browserId given.

Read an attribute (e.g. href, value, aria-label) of an element. Active tab unless browserId given.

Extract the main article of a page (Readability) as clean Markdown with title and byline — great for reading content pages. Active tab unless browserId given.

SENSITIVE: list cookies visible to the current page. Values (session tokens!) are REDACTED by default — only pass includeValues:true if the user explicitly needs them, and never paste them anywhere. Active tab unless browserId given.

Wait until the page's network activity settles (useful after navigation or SPA actions). Active tab unless browserId given.

List Floorp workspaces (id and name). Floorp-specific.

Switch to a Floorp workspace by id (from list_workspaces). Floorp-specific.

Return Floorp's window rectangle in screen pixels (left, top, right, bottom, width, height). Use this to compute coordinates for move_cursor / real_click. Windows only.

Move the REAL OS cursor to a screen pixel (must be inside the Floorp window). Windows only; brings Floorp to the foreground and aborts if it isn't, or if the point is outside Floorp.

Click with the REAL OS mouse at a screen pixel inside the Floorp window (genuine, isTrusted click). Use window_bounds to find the range. Refuses to click outside Floorp or if Floorp isn't foreground. Windows only.

Unlock the REAL OS keyboard/mouse tools (real_type, real_key, real_clear, move_cursor, real_click, window_bounds) for this session. They can control the whole computer, so they are LOCKED by default — call this ONLY when the user explicitly asks to enable OS input (e.g. they say "enable OS input"). Stays unlocked until disable_os_input or a server restart.

Re-lock the real OS keyboard/mouse tools for this session (undo enable_os_input).

Run JavaScript in the page and return its value. Your snippet should return something, e.g. return document.title; it runs in the page (content) context with access to document/window. LOCKED by default (powerful) — enable with enable_evaluate first. Best on the Marionette backend; some Floorp builds don't expose it. Active tab unless browserId given.

Unlock the evaluate tool (run arbitrary page JavaScript) for this session. Call ONLY when the user explicitly asks (e.g. they say "enable evaluate"). Re-lock with disable_evaluate.

Re-lock the evaluate tool for this session (undo enable_evaluate).

Ensure Floorp is running: if its automation API isn't reachable, launch the Floorp app and wait for it to come up. No-op if already running. Windows only (set FLOORP_PATH to override the exe location).

Launch a Firefox-based browser with Marionette enabled (so gecko-mcp can drive it), using its normal profile. Use for non-Floorp browsers (Firefox, LibreWolf, Waterfox, Zen, Mullvad). Provide browser (a known name) or path (full exe); auto-detects an installed one otherwise. If the browser is already running WITHOUT Marionette, close it first.