---
title: "mabl cloud MCP tools"
description: "This article provides a reference for all tools available in the mabl cloud MCP server. All tools require authentication, which is handled..."
last_updated: "2026-07-16"
source_url: "https://help.mabl.com/hc/en-us/articles/47047431915284-mabl-cloud-MCP-tools"
---
# mabl cloud MCP tools
> For the full index of agent-friendly pages, see [llms.txt](/llms.txt).
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_plan | Assign an Xray test plan to a mabl plan. | mabl plan ID, xray test plan, xray project ID, and workspace ID
*Optional: overwrite* | — |
| 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 |
| check_release_readiness | Generate a release readiness report for a set of mabl tests, plans, and deployments. | workspace ID and entity ids
*Optional: release context* | — |
| 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* | — |
| create_mabl_plan | Create a new mabl plan that runs a set of tests against an application in an environment. | workspace ID, name, application ID, environment ID, and test ids
*Optional: concurrency, description, credentials ID, and http auth credentials ID* | — |
| edit_mabl_plan | Edit a mabl plan: add or remove tests from execution stages, add or remove plan labels, update the plan name and description, enable/disable the plan, or attach login and HTTP-auth credentials. | plan ID and operations | — |
| edit_mabl_test | Edit the metadata of a mabl test: rename it, change its description, add or remove labels, or enable/disable it. | test 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_failure_category_report | Returns categorized failure counts over a time window as a reporting roll-up. | workspace ID
*Optional: scope, history days, start time ms, end time ms, environment ID, application ID, test name, test labels, and timezone* | — |
| get_failure_reasons | Lists failure reason definitions for a workspace: mabl default categories plus any custom reasons. | workspace ID
*Optional: include disabled* | — |
| get_latest_authored_tests | Get the most recent tests in a workspace, newest first, optionally filtered by test type and author. | workspace ID
*Optional: test type, author ID, and 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
*Optional: limit, status, since ms, and include analysis* | — |
| 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_flow_versions | List every version of a mabl flow, newest first, with its branch, creation time, and change description. | flow ID
*Optional: branch* | — |
| 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_test_versions | List every version of a mabl test, newest first, with its branch, creation time, and change description. | test ID
*Optional: branch* | — |
| get_mabl_tests | Get mabl tests by exact metadata filters such as label, author, type, and branch. | workspace ID
*Optional: labels, exclude labels, branch, branch changes only, author ID, application ID, test type, and limit* | — |
| get_mabl_users | Resolves a batch of mabl user IDs to their name and email. | workspace ID and user ids | — |
| get_plan_run_result | Returns detailed results for a specific plan run by planRunId (-pr). | 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, label, repository, start time, limit, summary only, 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_authoring_sessions | Returns the test authoring agent (TAA) sessions that created or edited mabl tests, filtered by test id and/or by the mabl branch the session worked on. | workspace ID
*Optional: test ID, branch ID, 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_run | Returns the current status and outcome of a single mabl test run. | test run ID and workspace 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_test_run_failure_reason | Returns the structured failure categorization assigned to a single test run: category id, summary text, suggested category, and manual vs auto assignment. | workspace ID and test run ID | — |
| get_workspace_test_run_summaries | Find recent mabl test runs across a workspace, with optional filters for status, test type, failure category, and pagination. | workspace ID
*Optional: status, test type, labels, test ID, failure category ID, start time ms, end time ms, exclude default tests, limit, and cursor* | — |
| get_workspace_value_report | Real, measured counts of mabl AI/automation activity in a workspace over a date range. | workspace ID
*Optional: start date, end date, and metric names* | — |
| 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* | — |
| get_xray_test_plans | Get Xray test plans 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_answer | Answers the pending question on a paused cloud test authoring session and resumes it in a single synchronous call. | session ID, text, and expected loop number | — |
| 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_list | Lists the cloud test authoring sessions in your workspace, by default the ones paused and awaiting an answer. | *Optional: status, limit, and cursor* | — |
| 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 | Checks the status of a cloud test authoring session, including the pending question when it is paused awaiting an answer. | session ID
*Optional: workspace ID, instance ID, and verbose* | — |
| mabl_compare_flow_versions | Diffs the steps of two mabl flows — or two versions of the same flow — at step granularity, the same diff the web app shows. | source_flow_id and target_flow_id
*Optional: branch* | — |
| mabl_compare_test_versions | Diffs the steps of two mabl tests — or two versions of the same test — at step granularity, the same diff the web app Compare tab shows. | source_test_id and target_test_id
*Optional: branch* | — |
| 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, labels, 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 | Search for mabl flows by what they do, using a natural language query. | query
*Optional: application_id, flow_type, 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* | — |
| rerun_mabl_plan | Re-run a previously executed mabl plan run, creating a new plan run with the same configuration as the original. | plan run ID and workspace ID
*Optional: scope* | — |
| rerun_mabl_test | Re-run a previously executed mabl test run, creating a new ad-hoc test run using the same configuration as the original run. | test run ID and workspace ID | — |
| restore_mabl_test | Restore a mabl test to a previous version, creating a new latest version whose content matches the chosen version. | test ID and version | — |
| 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* | — |
| search_mabl_tests | Search for mabl tests by what they do, using a natural language query. | query and workspace ID
*Optional: application ID and limit* | — |
| 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](https://help.mabl.com/hc/en-us/articles/17782745983636-mabl-resource-IDs) from the mabl app, CLI, and API.