Tool reference

Use this page as the detailed reference for Momentic MCP tools while setting up or iterating from your IDE. For setup instructions, see MCP Setup.

Project Tools

momentic_test_environment_list

List tests and environments in your project.Usage: Returns JSON with the following shape:

{
  "tests": [
    {
      "id": "test-id",
      "name": "test-name",
      "description": "optional description",
      "fullFilePath": "tests/example.test.yaml",
      "labels": []
    }
  ],
  "environments": []
}

Parameters: NoneExample: momentic_test_environment_list - Returns tests and environments.

Module Tools

momentic_module_list
momentic_module_get
momentic_module_recommend

List all modules in your project.Usage: Returns basic metadata for each module (ID, name, description, and paths). Use this to discover available modules.Parameters: NoneExample: momentic_module_list - Returns all project modulesNote: Parameters are not included in this list. Use momentic_module_get to inspect parameter requirements before inserting modules into a test.

Get a single fully loaded module by ID, exact name, or file path.Usage: Retrieves complete module details including parameters (required inputs), default parameters, parameter enums, and the full step list. Required before inserting a module step so you can provide the right inputs.Parameters:

id (optional): Module ID
name (optional): Exact module name
path (optional): File path

Note: Exactly one selector must be provided.Example: momentic_module_get --name "login-flow" - Returns the login flow module

Use AI to recommend modules that match your request and context.Usage: Returns a list of recommended modules with IDs and reasoning.Parameters:

userRequest (required): Natural-language description of what you want to build or edit

Example: momentic_module_recommend --userRequest "Add login with email and OTP, then verify dashboard loads"Note: After selecting a module, use momentic_module_get to inspect its parameters before inserting it into a test.

Session Tools

momentic_session_start
momentic_session_terminate

Start a granular browser session for a specific test.Usage: Creates a session bound to a test and returns session metadata.Parameters:

testId (required): Test ID to target
envName (optional): Environment override (matches CLI --env)
projectConfigPath (optional): Path to momentic.config.yaml
projectNameFilter (optional): Project name filter for workspace configs
headfulBrowser (optional): Launch a headful browser (defaults to true)

Response highlights:

sessionId, testId, createdAt, expiresAt, idleTimeoutMs, envName, baseUrl: Session metadata for the started session.
viewport: Viewport dimensions in pixels (width and height), or null if unavailable.

Example: momentic_session_start --testId "test-uuid"

Terminate a granular browser session by session ID.Usage: Kills the session and returns available session IDs if none match.Parameters:

sessionId (required): Session ID to terminate

Example: momentic_session_terminate --sessionId "session-uuid"

Test Tools

momentic_test_get
momentic_test_create

Get a single fully loaded test by ID, exact name, or file path.Usage: Retrieves complete test definition with resolved configurations.Parameters:

id (optional): Test ID
name (optional): Exact test name
path (optional): File path

Note: Exactly one selector must be provided.Example: momentic_test_get --path "tests/login.test.yaml" - Returns the login test

Create a new test using AI assistance.Usage: Creates a test file with specified parameters and AI-generated content.Parameters:

name: Test name (required)
baseUrl or environment: Base URL or environment reference (required)
description: Optional test description
browserType: Browser type (Chromium, Chrome for Testing)
viewport: Viewport dimensions

Example:

momentic_test_create --name "user-registration" --baseUrl "https://app.example.com" --description "Test user registration flow"

Test Session Interaction Tools (Granular)

momentic_preview_step
momentic_get_browser_state
momentic_get_environment_variables
momentic_run_step
momentic_test_splice_steps

Execute a step without adding it to the test.Usage: Runs a single step in the current session without modifying the test.Parameters:

sessionId (required): Session ID to use
step (required): Step definition to execute

Response:

Returns tool content parts directly:
- Markdown text sections such as ### Successful Result or ### Error
- Screenshot image content part (base64)
- ### Screenshot Path text section with a file path handle
- ### Environment Variables text section with a file path to saved JSON

Example: momentic_preview_step --sessionId "session-uuid" --step { ... }

Get the current browser state for a granular session.Usage: Returns a11y tree data plus a screenshot for the session. By default it returns file-based text artifacts plus inline screenshot content and a screenshot path handle.Parameters:

sessionId (required): Session ID to query
returnBrowserState (optional): Include serialized accessibility snapshot
returnScreenshot (optional): Include screenshot output when true

Response:

Returns the tool content parts directly:
- ### Page State text section with a file path to the saved browser-state artifact
- Screenshot image content part (base64) when returnScreenshot=true
- ### Screenshot Path text section with a file path handle when returnScreenshot=true

Example: momentic_get_browser_state --sessionId "session-uuid"

Get the current environment variables for a session.Usage: Returns environment variables available to the active session.Parameters:

sessionId (required): Session ID to query

Response:

Returns a ### Environment Variables text section with a file path to the saved JSON artifact.

Example: momentic_get_environment_variables --sessionId "session-uuid"

Run one or more steps from the test bound to an active session.Usage: Executes a range of steps from the test by step id.Parameters:

sessionId (required): Session ID to use
fromStep (required): { fromStepId, parentStepIdChain }
toStep (optional): { toStepId, parentStepIdChain }
targetSection (optional): Test section (main, setup, teardown)
resetSession (optional): Whether to restart the session before running steps

Response:

Returns tool content parts directly:
- Markdown text sections such as ### Result or ### Error
- ### Result Data text section when step data is present
- Screenshot image content part (base64)
- ### Screenshot Path text section with a file path handle
- ### Environment Variables text section with a file path to saved JSON

Example:

momentic_run_step --sessionId "session-uuid" --fromStep { "fromStepId": "step-1", "parentStepIdChain": [] } --toStep { "toStepId": "step-2", "parentStepIdChain": [] }

Insert, delete, or replace steps in a test within an active session.Usage: Splices steps by index for the test bound to the session.Parameters:

sessionId (required): Session ID to use
startIndex (required): Index to begin splicing
deleteCount (required): Steps to remove (0 insert, 1 replace, N delete)
steps (required): Step definitions to insert
targetSection (optional): Test section (main, setup, teardown)
returnTest (optional): Return the full test after splicing

Example: momentic_test_splice_steps --sessionId "session-uuid" --startIndex 1 --deleteCount 0 --steps [ ... ]

Getting Started

Core concepts

Features

CLI

Mobile CLI

CI/CD

Resources

Project Tools

Module Tools

Session Tools

Test Tools

Test Session Interaction Tools (Granular)

Getting Started

Core concepts

Features

CLI

Mobile CLI

CI/CD

Resources

​Project Tools

​Module Tools

​Session Tools

​Test Tools

​Test Session Interaction Tools (Granular)

Project Tools

Module Tools

Session Tools

Test Tools

Test Session Interaction Tools (Granular)