Skip to main content
Starts the Momentic MCP server over stdio so coding agents can author, run, and triage web tests. See the MCP integration guide for editor-specific setup.
CLI flags override environment variables.

​
Common flags

​
string
Authenticates the MCP server with Momentic APIs. Env: MOMENTIC_API_KEY.
​
string
Path to the momentic.config.yaml file used to load project tests, modules, and environments.

​
Browser

​
string
Whether browser sessions launch with a visible UI (true) or headless (false). Defaults to true. Env: MOMENTIC_HEADFUL_BROWSER.
​
string
Override the viewport device pixel ratio used for browser rendering. Defaults to 2 on macOS Retina and 1 elsewhere.
​
string
Record video of browser sessions by default. Defaults to false. The output directory path is returned when a session ends. Env: MOMENTIC_VIDEO.

​
Caching

​
boolean
Always save updated step caches after successful sessions, even on protected Git branches.
​
boolean
Disable step caches entirely. Sessions run without cached data and no caches are saved.

​
Session

​
string
Idle timeout for MCP sessions in minutes. Defaults to 5. Sessions inactive for this duration are terminated automatically. Env: MOMENTIC_SESSION_IDLE_TIMEOUT_MINUTES.
​
boolean
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’s momentic.config.yaml:
Run headless with a five-minute idle timeout: