Skip to main content
Starts the Momentic MCP server over stdio. For setup in Cursor, Claude Code, Codex, and other agents, see the MCP integration guide. 
npx momentic mcp [options]

​
Options

CLI flags override environment variables.
​
--api-key <key>
string
Authenticates the MCP server with Momentic APIs. Env: MOMENTIC_API_KEY.
​
-c, --config <path>
string
Points to the momentic.config.yaml file used to load project tests, modules, and environments.
​
--headful-browser [true|false]
string
Whether browser sessions launch with a visible UI (true) or in headless mode (false). Defaults to true. Env: MOMENTIC_HEADFUL_BROWSER.
​
--pixel-ratio <n>
string
Overrides viewport DPR used for browser rendering. Defaults to 2 on macOS Retina and 1 on other setups.
​
--video [true|false]
string
Record video of browser sessions by default. Defaults to false. When a session ends, the video output directory path is returned. Can be overridden per session. Env: MOMENTIC_VIDEO.
​
--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
Creates a persistent local daemon so web sessions can be shared across multiple MCP server invocations.