Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
START_URLNoOpen this URL on start
FIREFOX_HEADLESSNoRun without UI
ACCEPT_INSECURE_CERTSNoIgnore TLS errors

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Browse and debug the web with Firefox. Use this for any browser or web page task: opening a URL, automating a web flow, or debugging a page (console errors, network requests, DOM state). The task does not need to name Firefox, reach for these tools unless another browser is explicitly requested. Chrome-only browser tools do not control Firefox, do not assume they cover this.

Enabled capabilities:

  • pages: Open, navigate, select, and close pages.

  • snapshot: Capture accessibility/DOM snapshots and resolve UIDs.

  • input: Interact with the page via UID-based clicks, typing, key presses, drag, and uploads.

  • screenshot: Capture screenshots of the page or specific elements.

  • print: Print the page to PDF.

  • downloads: Monitor and manage file downloads.

  • utilities: Handle dialogs, history navigation, and viewport sizing.

  • management: Inspect Firefox options and logs, and close the browser.

  • webextension: Install, uninstall, and list web extensions.

  • screencast: Record screencasts of the page viewport (Firefox 154+).

  • script: Evaluate arbitrary JavaScript in the page context.

When these tools are deferred, load the core set in one search rather than one at a time: list_pages, new_page, navigate_page, take_snapshot, get_page_text. Add task-specific tools to the same search: click_by_uid / fill_by_uid / hover_by_uid for interaction, screenshot_page / screenshot_by_uid for visuals, evaluate_script for one-off JS.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_pagesA

List open tabs (index, title, URL). Selected tab is marked.

new_pageB

Open new tab at URL. Returns tab index.

navigate_pageB

Navigate selected tab to URL.

select_pageA

Select active tab by index, URL, or title. Index takes precedence.

close_pageA

Close tab by index.

get_page_textA

Get the visible text of the page (document.body.innerText). Caps at maxLength (default 20000 chars); saveTo saves the full text to a file.

take_snapshotA

Capture DOM snapshot with stable UIDs. A UID stays valid across snapshots until its element is removed or the page navigates. Output caps at maxLines (default 100); scope with selector or dump the full tree with saveTo.

resolve_uid_to_selectorA

Resolve UID to CSS selector. Fails if the element is gone.

clear_snapshotC

Clear snapshot UIDs. Usually not needed.

click_by_uidA

Click element by UID. Set dblClick for double-click.

hover_by_uidB

Hover over element by UID.

fill_by_uidA

Fill text input/textarea or pick a select option by UID.

drag_by_uid_to_uidB

Drag element to another (HTML5 drag events).

fill_form_by_uidA

Fill multiple form fields at once.

upload_file_by_uidB

Upload file to file input by UID.

press_keyA

Press a single key, optionally with modifiers, to submit, dismiss, navigate or trigger a shortcut. Not for entering text: use fill_by_uid instead.

type_textA

Type text key by key into the focused element, optionally followed by a key such as Enter. Use fill_by_uid to set the value of a known input; use this for elements that only react to real typing, such as autocomplete fields and rich text editors.

screenshot_pageB

Capture viewport screenshot as base64 PNG. Set fullPage for the whole scrollable document.

screenshot_by_uidB

Capture element screenshot by UID as base64 PNG.

print_pageA

Print the current page to a PDF file using print CSS. Returns the saved file path.

list_downloadsA

List downloads tracked since startup, including status and saved file path.

clear_downloadsA

Clear the tracked downloads buffer.

set_download_behaviorA

Control how downloads are handled: allow (save to a destination folder), deny (cancel), or reset to default. Avoids the native save-file dialog. Requires a recent Firefox.

accept_dialogA

Accept browser dialog. Provide promptText for prompts.

dismiss_dialogA

Dismiss browser dialog.

navigate_historyA

Navigate history back/forward. UIDs become stale.

set_viewport_sizeA

Set viewport dimensions in pixels. Applies to the selected tab only.

get_firefox_outputA

Retrieve Firefox output (stdout/stderr including MOZ_LOG, warnings, crashes, stack traces). Returns recent output from the capture file. Use filters to focus on specific content.

get_firefox_infoA

Get information about the current Firefox instance configuration, including binary path, environment variables, and output file location.

close_firefox_sessionA

Ends the browser session. If the server connected to your existing Firefox, this releases the connection and leaves Firefox running. If the server started Firefox itself, this closes it. Call this when the browser task is complete and no further browser interaction is expected.

install_extensionA

Install a Firefox extension using WebDriver BiDi webExtension.install command. Supports installing from archive (.xpi/.zip), base64-encoded data, or unpacked directory.

uninstall_extensionA

Uninstall a Firefox extension using WebDriver BiDi webExtension.uninstall command. Requires the extension ID returned by install_extension or obtained from list_extensions.

list_extensionsB

List installed Firefox extensions using the WebDriver BiDi webExtension.moz:listExtensions command.

screencast_startA

Start recording a screencast (video) of the current page viewport, saving the output to a file in the downloads directory. Returns a screencast id to pass to screencast_stop. Multiple recordings can run at once.

screencast_stopA

Stop an in-progress screencast recording started with screencast_start and finalize the video file. Returns the path to the saved file.

evaluate_scriptA

Run a JS function in the page and return its result. Prefer this for targeted reads (a value, text, computed style, whether an element exists) instead of a full take_snapshot. Use the UID interaction tools for clicking, typing, and filling.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.3/5.0

Scored across 36 tools

Disambiguation4/5

Most tools target a distinct resource+action, and the descriptions actively steer between near-neighbors (fill_by_uid vs type_text vs press_key, screenshot_page vs screenshot_by_uid, take_snapshot vs get_page_text vs evaluate_script). The only real overlaps are the fill family (fill_by_uid, fill_form_by_uid, type_text) and the three 'read the page' tools, but each carries explicit guidance on when to use it.

Naming Consistency3/5

The majority follow verb_noun (click_by_uid, list_pages, take_snapshot, install_extension), but there are deviations: noun-first forms like screencast_start/screencast_stop (vs the otherwise dominant verb_noun, cf. navigate_history), set_download_behavior/set_viewport_size, and noun-as-verb names like screenshot_by_uid, screenshot_page, drag_by_uid_to_uid. Still readable and predictable in spirit, but not a single consistent convention.

Tool Count2/5

36 tools is heavy for a browser automation surface; most earn their place, but there is clear consolidation headroom (clear_snapshot, resolve_uid_to_selector, clear_downloads, get_firefox_info are marginal, and the fill/type/screenshot variants could be merged). The count pushes well past the 15-tool comfort zone into territory where selection cost is real.

Completeness3/5

Core lifecycle is well covered: tabs, navigation, history, viewport, UID-based interaction, forms, uploads, dialogs, downloads, extensions, screenshots, PDF printing, screencast, and session teardown. Notable devtools gaps remain: no console message retrieval distinct from raw Firefox stdout/stderr, no network request inspection/interception, no explicit wait-for-element/condition, and no frame/iframe or cookie/storage management.

Maintenance

ActivityActive
ResponsivenessNo recent community issues