This article provides a reference for all tools available in the mabl cloud MCP server. All tools require authentication, which is handled automatically through the OAuth login flow.
| Tool | Description | Input | Sample prompt |
|---|---|---|---|
analyze_failure |
Returns mabl AI failure analysis for a failed test run or plan run: synopsis, Root cause and Next steps markdown, optional evidence details, timing metadata. | run ID, test or plan, and workspace ID Optional: include evidence |
— |
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 |
create_application |
Create a new application in a workspace and bind it to an environment with a URL. | workspace ID, name, environment ID, url, and application type Optional: description |
— |
create_credentials |
Create new login credentials in a workspace. | workspace ID, name, username, and password Optional: description and cloud only |
— |
create_environment |
Create a new environment in a workspace. | workspace ID and name Optional: description and page load wait |
— |
create_mabl_test_cloud |
Create a new browser or API test that runs entirely in the mabl cloud, without needing a local browser. | workspace ID, application ID, environment ID, url, name, intent, and is api test Optional: steps and api spec |
— |
create_mabl_test_local |
Prepare a new browser or API test for authoring in the local mabl desktop trainer and return a launcher URL the user clicks to open it. | workspace ID, application ID, environment ID, url, name, intent, and is api test Optional: steps, credentials ID, without credentials, and api spec |
— |
edit_mabl_plan |
Edit a mabl plan: add or remove tests from execution stages, or update the plan name and description. | plan ID and operations | — |
get_applications |
Get applications in a workspace with their associated environments and URLs. | workspace ID Optional: limit and cursor |
— |
get_cloud_test_gen_status |
Check the status of a cloud test generation initiated by create_mabl_test_cloud. | workspace ID and session ID Optional: instance ID |
— |
get_credentials |
Get credentials available in a workspace. | workspace ID Optional: limit and cursor |
— |
get_current_user_info |
Get information about the currently authenticated caller, including the default workspace. | none | — |
get_deployment_status |
Returns a snapshot of a mabl deployment's current state — running or terminal, test metrics, and failed test runs so far. | workspace ID Optional: deployment ID, environment ID, application ID, revision, and lookback ms |
— |
get_doc |
Retrieve the full content of a mabl help center article as markdown. | article_id | — |
get_environments |
Get environments in a workspace, such as staging or production. | workspace ID Optional: limit and cursor |
— |
get_latest_authored_tests |
Get the most recent tests in a workspace, optionally filtered by author. | workspace ID Optional: limit |
— |
get_latest_plan_runs |
Get recent execution results for a plan by plan ID. | plan ID and workspace ID | — |
get_latest_test_runs |
Returns recent execution results for a single mabl test by test ID. | test ID and workspace ID | — |
get_mabl_deployment |
Get mabl deployment results by commit hash or deployment ID. | workspace ID Optional: commit hash, deployment ID, and fails only |
— |
get_mabl_plan |
Get details of a specific mabl plan by ID. | workspace ID and plan ID | — |
get_mabl_test_details |
Get full details of a single mabl test by its test ID. | workspace ID and test ID Optional: include plans |
— |
get_mabl_tests |
Search for mabl tests using a natural language query. | query and workspace ID Optional: application ID and limit |
— |
get_plan_run_result |
Get detailed results for a specific plan run by plan run ID. | plan run ID and workspace ID | — |
get_plans |
Get test plans in a workspace. | workspace ID Optional: limit and cursor |
— |
get_recent_deployments |
Find recent mabl deployment events in a workspace, optionally scoped to a single environment or application and/or a time window. | workspace ID Optional: environment ID, application ID, start time, limit, and cursor |
— |
get_runtime_recovery_session |
Returns the Runtime Recovery Agent session that healed or tried to heal a failing test step mid-run. | workspace ID Optional: recovery session ID and test run ID |
— |
get_test_quality_report |
Retrieve mabl's in-product test-quality metrics over a time range. | workspace ID, start time, and end time Optional: application ID, plan ID, environment ID, test ID, min plan runs, limit, and cursor |
— |
get_test_run_artifact |
Retrieve the content of a mabl test run artifact referenced by a gs:// URI. | workspace ID and artifact uri | — |
get_workspace_test_run_summaries |
Find recent mabl test runs across a workspace, with optional filters for status, test type, and pagination. | workspace ID Optional: status, test type, exclude default tests, limit, and cursor |
— |
get_workspaces |
Get all workspaces the current caller has access to. | none | — |
get_xray_test_cases |
Get Xray test cases for a specific Xray project. | workspace ID Optional: xray project ID, limit, cursor, and search |
— |
identify_coverage_gaps |
Run the mabl Coverage Gap Agent to compare a mabl test against a requirement and return a structured coverage report. | workspace ID and test ID Optional: requirement description and jira issue ID |
— |
mabl_result_analysis_chat |
Starts or continues conversational results analysis for a test run, plan run, or deployment event. | workspace ID Optional: results analysis session ID, entity, target ID, initial user message, and message |
— |
rerun_mabl_deployment |
Re-runs a previous mabl deployment, triggering the same plans against the same revision, application, and environment. | deployment ID | — |
run_mabl_test_cloud |
Trigger a cloud execution of a mabl test (browser, API, or performance). | test ID, workspace ID, environment ID, application ID, and browsers Optional: credentials ID and url override |
— |
run_mabl_test_local |
Returns a link the user can click to run an existing mabl test locally in the mabl desktop app. | test ID and workspace ID Optional: environment ID, credentials ID, browser, url override, scenario ID, headless, and keep browser open |
— |
search_docs |
Search mabl help center articles. | query Optional: per_page |
— |
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.