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_data_table |
Create a data table in a workspace with one or more rows of data. | workspace ID, name, and rows Optional: description |
— |
create_environment |
Create a new environment in a workspace. | workspace ID and name Optional: description and page load wait |
— |
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_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_data_table |
Get a single data table by ID, including all of its rows. | data table ID | — |
get_data_tables |
Get the data tables in a workspace. | workspace ID Optional: limit and cursor |
— |
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 Optional: limit and cursor |
— |
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, branch name, 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_authoring_edit |
Initiate a cloud test authoring session that edits an existing mabl test. | workspace ID and test information | — |
mabl_authoring_initiate |
Initiate a cloud test authoring session that creates a new mabl test. | workspace ID Optional: test type, planning session ID, test information, plan, and api spec |
— |
mabl_authoring_initiate_local |
Start a local test authoring session that opens the mabl desktop trainer pre-loaded with a test plan. | workspace ID Optional: test type, planning session ID, test information, plan, and api spec |
— |
mabl_authoring_plan |
Start or continue a conversational test planning session with the mabl AI planning agent. | workspace ID Optional: intent, planning session ID, and requested changes |
— |
mabl_authoring_status |
Check the status of a test authoring session initiated by mabl_authoring_initiate. | workspace ID and session ID Optional: instance ID and verbose |
— |
mabl_create_flow |
Creates a new standalone reusable mabl flow that other tests can include. | workspace ID, type, and description Optional: steps, parameters, branch, and agent_session_id |
— |
mabl_create_test |
Creates a new mabl test envelope and, optionally, its first structural flow with steps. | workspace ID, name, test type, application ID, and environment ID Optional: url, description, credentials ID, initial_flow, branch, and agent_session_id |
— |
mabl_find_tests_using_flow |
Returns the tests that reference a given flow, paginated. | flow_id Optional: branch, limit, and cursor |
— |
mabl_get_authoring_guide |
Fetch reference material for hand-authoring a mabl test directly via mabl_create_test / mabl_create_flow / mabl_save_flow_steps / mabl_save_test_steps. | uri | — |
mabl_get_flow_steps |
Reads a single mabl flow and returns its current json_steps array plus the `reusable` flag (true means the flow is referenced by multiple tests). | flow_id Optional: branch |
— |
mabl_get_schema_resource |
Returns the JSON Schema for a layer of the mabl test model, addressed by a mabl-schema:// URI. | uri Optional: test type |
— |
mabl_get_test_steps |
Reads a mabl test and returns every flow inside it tagged as 'structural' (non-reusable, owned by this test) or 'reusable' (shared across multiple tests). | test_id Optional: branch |
— |
mabl_list_branches |
Lists mabl source-control branches in a workspace. | Optional: workspace_id, test_id, status, limit, and cursor | — |
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 |
— |
mabl_save_flow_steps |
Saves edits to a single mabl flow with pre-validation and three-way persistence verification. | flow_id Optional: mode, steps, edits, branch, acknowledge_shared, parameters, description, and agent_session_id |
— |
mabl_save_test_steps |
Saves edits at the test level — the natural authoring boundary for steps that live in structural (non-reusable) flows. | test_id and mode Optional: flows, edits, branch, and agent_session_id |
— |
mabl_search_flows |
Returns workspace flows ranked by semantic similarity to a natural-language task description. | task_description Optional: application_id, flow_type, reusable, and limit |
— |
mabl_validate |
Validates a mabl json_steps array and returns structural, semantic, and cross-step errors with educational suggestions. | steps Optional: test type and strict |
— |
run_mabl_plan |
Trigger a cloud execution of an existing mabl plan, optionally applying ad-hoc overrides (URLs, branch, browsers, credentials) for this single run. | plan ID and workspace ID Optional: url override, api url override, branch, browsers, credentials ID, and http auth credentials 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 |
— |
trigger_mabl_deployment |
Triggers a mabl deployment event to run matching plans, or re-triggers a prior deployment by id. | Optional: deployment ID, workspace ID, application ID, environment ID, plan labels, revision, branch, properties, debug, url override, api url override, browsers, credentials ID, and http auth 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.