Perfecto MCP Server action reference

Read the following information to learn about all actions supported by the Perfecto MCP Server and how you can use them.

User Management

Use these actions to retrieve information about your Perfecto user account.

Get user info

Returns details for the authenticated Perfecto user.

Sample prompt: "Show my Perfecto account info."

Device management

Use these actions to find and inspect the devices available in your Perfecto environment.

Get Selenium grid info

Returns Selenium and Appium endpoint URLs.

Sample prompt: "Show Selenium Grid info."

List real devices

Returns available iOS and Android devices.

Sample prompt: "List available Android devices."

Get real device details

Returns details for a specific device.

Sample prompt: "Get details for device ID 12345."

List virtual devices

Returns available iOS simulators and Android emulators.

Sample prompt: "Show iOS simulators."

List desktop devices

Returns available desktop browser environments.

Sample prompt: "List desktop browser devices."

Test execution

Use these actions to view, control, and filter test executions.

List running executions

Returns all currently running executions.

Sample prompt: "Show all running tests."

Stop executions

Stops one or more executions by ID.

Sample prompt: "Stop execution ID 67890."

List execution history

Returns past executions with filtering support.

Sample prompt: "Filter past runs by failure reason."

List report names

Returns available report types or report names.

Sample prompt: "Show report names."

Discover filter values

Returns OS, browser, device, and other valid filter values.

Sample prompt: "Show valid filter values for executions."

List AI Scriptless tests

Returns AI Scriptless tests available in your repository.

Sample prompt: "List my AI Scriptless tests."

Run AI Scriptless test

Runs a AI Scriptless test by name or ID.

Sample prompt: "Run AI Scriptless test Checkout flow."

AI Scriptless test lifecycle

Use these actions to create, save, copy, move, and delete AI Scriptless tests.

Create empty test

Creates a new empty AI Scriptless test with a default device under test (DUT) parameter.

Sample prompt: "Create a new private AI Scriptless test called Login Flow in My Folder."

Save test

Creates a labeled save point for the current test in snapshot history. Use this action when you want to record a named version with an optional comment.

Sample prompt: "Save my Login Flow test with the comment Added validation steps."

Save test as

Copies a test to a new name and folder.

Sample prompt: "Save a copy of my Login Flow test as Login Flow v2 in MCP Archive."

Move test

Moves a test to a different folder. Returns the new test identifier.

Sample prompt: "Move my Login Flow test to folder MCP Archive."

Delete test

Deletes a AI Scriptless test from the repository.

Sample prompt: "Delete my Old Login Flow test."

AI Scriptless test structure

Use this action to inspect the full layout of a test before editing or reviewing it.

View test structure

Returns the hierarchical structure of a AI Scriptless test, including parameters, commands, steps, loops, conditions, enabled/disabled state, and the step path for each element.

Sample prompt: "Show me the full structure of my Login Flow test."

AI Scriptless command catalog

Use these actions to discover available commands and their argument definitions before adding steps to a test.

List AI Scriptless commands

Returns the available AI Scriptless command catalog, including a command selection policy.

Sample prompt: "List available AI Scriptless commands for test authoring."

Get command definitions

Returns parameter definitions for one or more commands, including mandatory and optional arguments and help text.

Sample prompt: "Get parameter definitions for ai_user_action and ai_validation."

AI Scriptless command operations

Use these actions to add, update, remove, move, and enable or disable commands within a test. Identify steps using the step path values returned by View test structure. All changes persist immediately. Use Save test only when you want to create a labeled snapshot entry.

Add command

Adds a command to a test at the specified position, optionally inside a step, loop, or condition branch.

Sample prompt: "Add an AI User Action to open the browser after step 0 in my Login Flow test."

Modify command

Updates argument values on an existing command.

Sample prompt: "Change the validation on step 2 in my Login Flow test to verify the welcome message is displayed."

Delete command

Removes a command or step from a test.

Sample prompt: "Delete step 3 from my Login Flow test."

Set command enabled

Enables or disables a step without deleting it.

Sample prompt: "Disable step 1 in my Login Flow test."

Move command

Moves a step to a new position within the test.

Sample prompt: "Move step 4 to after step 1 in my Login Flow test."

AI Scriptless structure elements

Use these actions to add control-flow containers to a test.

Add logical step

Adds a group step container.

Sample prompt: "Add a group step labeled Login credentials after step 0 in my Login Flow test."

Add loop

Adds a loop container that repeats its child steps.

Sample prompt: "Add a loop that repeats 3 times after step 2 in my Login Flow test."

Add condition

Adds a condition with Then and Else branches.

Sample prompt: "Add a condition user is logged in after step 1 in my Login Flow test."

Set condition expression

Updates the expression on an existing condition.

Sample prompt: "Set the expression on condition step 5 to page title contains Dashboard."

AI Scriptless snapshots

Use these actions to review saved versions of a test.

List snapshots

Returns snapshot history for a test, including a marker for the current live version and historical versions.

Sample prompt: "List snapshot history for my Login Flow test."

View snapshot

Returns the hierarchical structure of a historical snapshot, in the same format as View test structure.

Sample prompt: "Show me the structure of a previous version of my Login Flow test."

AI Scriptless script variables

Use these actions to manage script variables on a test. Script variables are separate from the DUT parameter configured on the test.

List test variables

Returns all script variables configured on a test.

Sample prompt: "List script variables on my Login Flow test."

Add test variable

Adds a script variable and persists the test.

Sample prompt: "Add a string variable username with value testuser to my Login Flow test."

Modify test variable

Updates an existing script variable.

Sample prompt: "Change the username variable value to admin on my Login Flow test."

Delete test variable

Removes a script variable from a test.

Sample prompt: "Delete the username variable from my Login Flow test."

Project configuration

Use these actions to configure Espresso and XCTest projects for use with Perfecto.

Configure Espresso project

Applies required Perfecto configuration for Espresso.

Sample prompt: "Configure my Espresso project for Perfecto."

Configure XCTest project

Applies required Perfecto configuration for XCTest.

Sample prompt: "Set up my XCTest project for Perfecto."

Help and command reference

Use these actions to view help topics and Perfecto‑specific command details.

List help categories

Returns available help categories and subcategories.

Sample prompt: "Show help categories."

List help topics

Returns help topics within a category or subcategory.

Sample prompt: "Search help for Appium commands."

Read help content

Returns the contents of a help topic.

Sample prompt: "Read help content for Appium setup."

List extended commands

Returns supported Perfecto‑specific WebDriver extension commands.

Sample prompt: "List extended Selenium commands."

Get extended command details

Returns details for a specific extended command.

Sample prompt: "Show details for command XYZ."