Skip to main content

Documentation Index

Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.
npx momentic mcp
CLI flags override environment variables.

Common flags

--api-key <key>
string
Authenticates the MCP server with Momentic APIs. Env: MOMENTIC_API_KEY.
-c, --config <path>
string
Path to the momentic.config.yaml file used to load project tests, modules, and environments.

Browser

--headful-browser [true|false]
string
Whether browser sessions launch with a visible UI (true) or headless (false). Defaults to true. Env: MOMENTIC_HEADFUL_BROWSER.
--pixel-ratio <n>
string
Override the viewport device pixel ratio used for browser rendering. Defaults to 2 on macOS Retina and 1 elsewhere.
--video [true|false]
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

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

Session

--session-idle-timeout-minutes <minutes>
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.
--daemon
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:
npx momentic mcp
Run headless with a five-minute idle timeout:
npx momentic mcp --headful-browser false --session-idle-timeout-minutes 5