Common flags
Browser
Whether browser sessions launch with a visible UI (
true) or headless
(false). Defaults to true. Env: MOMENTIC_HEADFUL_BROWSER. The legacy
--headful-browser flag remains an alias. Pass headful when starting a
session to override this default. The legacy headfulBrowser parameter
remains supported; headful takes precedence if both are provided.Override the viewport device pixel ratio used for browser rendering. Defaults
to
2 on macOS Retina and 1 elsewhere.Record video of browser sessions. Defaults to
false. The output directory
path is returned when a session ends. Env: MOMENTIC_VIDEO.Caching
Session
Idle timeout for MCP sessions in minutes. Defaults to
5. The server ends
sessions that stay inactive for this duration. Env:
MOMENTIC_SESSION_IDLE_TIMEOUT_MINUTES.Create a persistent local daemon so browser sessions can be shared across
multiple MCP server invocations. The daemon’s working directory is set to the
parent of the config file, so MCP servers launched from different directories
share the same project home.
Examples
Start the MCP server using the project’smomentic.config.yaml: