This article provides a reference for all tools available in the mabl cloud MCP server. All tools except authentication tools require a valid access token, which is obtained automatically through the login flow.
| Tool | Description | Input | Sample prompt |
|---|---|---|---|
analyze_failure |
Get a GenAI analysis of why a test or plan execution failed. | run ID, test or plan, and workspace ID | Tell me why the this test/plan failed |
assign_xray_to_mabl_test |
Assign an Xray test case to a mabl test. | mabl test ID, xray test case, xray project ID, and workspace ID Optional: overwrite |
Assign the Xray test case 123 to the mabl test 456 |
get_applications |
Get all mabl applications with their associated environments. | workspace ID | Get my mabl applications |
get_credentials |
Get all mabl credentials and specify if they are cloud only. | workspace ID | Get my mabl credentials |
get_current_user_info |
Get information about the currently authenticated user, including their userId and default workspace. Call this tool early after authentication to obtain the userId and defaultWorkspaceId, which are required by many other tools. | none | — |
get_environments |
Get all mabl environments. | workspace ID | Get my mabl environments |
get_latest_authored_tests |
Get latest tests created by the current user. | workspace ID and user ID Optional: limit |
What mabl tests have I created recently? |
get_latest_plan_runs |
Get the latest mabl plan results for a planId. | plan ID and workspace ID | Get the latest results for the mabl plan "App - Feature: Labels". |
get_latest_test_runs |
Get the recent execution results for a mabl test by testId. | test ID and workspace ID | Can you fetch the latest results for the test "Mabl login"? |
get_mabl_deployment |
Get mabl deployment result for last commit. This tools is usefull to know if the last commit broke the tests or not and what test failed. | commit hash, deployment ID, and workspace ID | Get mabl deployment result for last commit |
get_mabl_test_details |
Get the details of a mabl test based on a testId. | test ID | Get the details of mabl test 123 |
get_mabl_tests |
Get an array of mabl tests based on a query. | query and workspace ID Optional: application ID |
Get mabl datatable tests |
get_plan_run_result |
Get a mabl plan run result for a given planRunId. Useful for debugging a single plan run. | plan run ID and workspace ID | Get mabl plan run result for the last run of the plan "App - Feature: Labels" |
get_plans |
Get all mabl plans. | workspace ID | Get my mabl plans |
get_workspaces |
Get all of the workspaces that the user has access to. After calling this tool, present the list of workspaces to the user and ask which one they want to use. If the user does not select a workspace, use the defaultWorkspaceId from the get_current_user_info tool. A workspaceId is required for all subsequent tool calls. | user ID Optional: limit |
— |
get_xray_test_cases |
Get all Xray test cases for a specific Xray project. | workspace ID Optional: xray project ID, limit, and offset |
Get my Xray test cases for project 123 |
run_mabl_test_cloud |
Trigger a cloud execution of a mabl test (browser, API, or performance). The test type is determined by the test itself — the same parameters apply to all supported types. Mobile tests are not yet supported. Returns a list of individual test run links. | test ID, workspace ID, environment ID, application ID, and browsers Optional: credentials ID |
— |
Obtaining IDs
In many cases, you can obtain the IDs directly from the AI agent by including it in a prompt. For example: "Get recent plan runs for the plan 'App - a11y tests' and include the plan run IDs, please."
If you can't get a specific ID directly from the mabl MCP, check out our article on obtaining mabl resource IDs from the mabl app, CLI, and API.