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. 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 save no caches.

​
Session

​
string
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.
​
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: