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. | 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 |
— |
get_applications |
Get all applications in a workspace with their associated environments and URLs. | workspace ID | — |
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 all credentials available in a workspace. | workspace ID | — |
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 all environments in a workspace, such as staging or production. | workspace ID | — |
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 and deployment ID |
— |
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 |
— |
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_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_recovery_session |
Returns the Test 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_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 |
— |
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 |
— |
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.