Skip to main content
Start the MCP (Model Context Protocol) server over stdio so coding assistants can create, edit, and run Momentic tests. For full setup instructions see MCP. All options below can be passed as flags or, where noted, set via environment variables. CLI flags override environment variables. 
npx momentic mcp [options]

​
Options

SettingFlagEnvironment variableDescription
Momentic API key--api-key <key>MOMENTIC_API_KEYAuthenticates the MCP server with Momentic APIs.
Config file path-c, --config <path>—Points to the momentic.config.yaml file used to load project tests, modules, and environments.
Headful browser (default: true)--headful-browser [true or false]MOMENTIC_HEADFUL_BROWSERSets whether browser sessions launch with a visible UI (true) or in headless mode (false).
Device pixel ratio--pixel-ratio <n>—Overrides viewport DPR used for browser rendering. Defaults to 2 on macOS Retina and 1 on other setups.

​
--api-key <key>

Momentic API key. 
npx momentic mcp --api-key your-api-key

​
-c, --config <path>

Path to the momentic.config.yaml file. Required when run from an MCP client; use an absolute path so the server can resolve it correctly. 
npx momentic mcp --config /absolute/path/to/momentic.config.yaml

​
--headful-browser [true|false]

Whether to launch MCP session browsers with a visible UI (true) or in headless mode (false). Defaults to true. 
npx momentic mcp --headful-browser false

​
--pixel-ratio <n>

Device pixel ratio for browser rendering. Defaults to 2 on macOS Retina and 1 elsewhere. 
npx momentic mcp --pixel-ratio 2