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. 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. The daemon’s working directory is set to the parent of the config file path, enabling multiple MCP servers launched from different directories to resolve to the same project home and share browser sessions and other state through a single long-lived process.