mabl cloud MCP tools
For the full index of agent-friendly pages, see 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_mabl_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 |
— |
| analyze_mabl_results | 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 |
— |
| 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. For non-Xray test case ids (TestRail, Zephyr, the free-form “Test Case ID(s)” field) use edit_mabl_test_metadata with add_test_case_id instead. Supported test types: browser, api, mobile. Any other test type is a capability this tool does not have, not a setting to enable. |
| 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 |
— |
| compare_mabl_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 |
— |
| compare_mabl_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 |
— |
| create_mabl_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_mabl_credentials | Create new login credentials in a workspace. | workspace ID, name, username, and password Optional: description and cloud only |
— |
| create_mabl_data_table | Create a data table in a workspace with one or more rows of data. | workspace ID, name, and rows Optional: description |
— |
| create_mabl_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, labels, credentials ID, http auth credentials ID, schedules, and deployment trigger |
— |
| edit_mabl_plan | Edit a mabl plan: add or remove tests from execution stages, manage recurring schedules and the deployment trigger, 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_metadata | Edit the metadata of a mabl test: rename it, change its description, add or remove labels, link or unlink external test case ids (e. | test ID and operations | — |
| export_mabl_test_playwright | Convert a mabl browser test into a complete Playwright spec file, generated by mabl and returned as file contents ready to write to disk. | workspace ID, test ID, and environment ID Optional: mabl branch |
— |
| get_current_user | Get information about the currently authenticated caller, including the default workspace. | none | — |
| 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_mabl_application_summary | Get the mabl AI-generated summary of what an application does, the same summary shown on the application summary page in the mabl app. | application ID | — |
| get_mabl_authoring_steps | Returns the humanized test steps a cloud authoring session has built so far, read from the session live as the agent works. | session ID Optional: workspace ID, limit, and cursor |
— |
| get_mabl_data_table | Get a single data table by ID, including all of its rows. | data table 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_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_mabl_doc | Retrieve the full content of a mabl help center article as markdown. | article_id | — |
| get_mabl_flow_steps | Reads a single mabl flow and returns its current steps plus the `reusable` flag (true means other tests can reference this flow). | flow_id Optional: branch, detail, step_ids, and step_range |
— |
| get_mabl_plan | Get details of a specific mabl plan by ID. | workspace ID and plan ID | — |
| get_mabl_plan_run | Returns detailed results for a specific plan run by planRunId (-pr). | plan run ID and workspace ID | — |
| get_mabl_test | Get full details of a single mabl test by its test ID. | test ID Optional: workspace ID and include plans |
— |
| get_mabl_test_run | Returns the current status and outcome of a single mabl test run. | test run ID and workspace ID | — |
| get_mabl_test_run_artifact | Retrieve the content of a mabl test run artifact referenced by a gs:// URI. | workspace ID and artifact uri | — |
| get_mabl_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_mabl_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, detail, flow_id, step_ids, and step_range |
— |
| 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_workspace_value_report | Real, measured counts of mabl AI/automation activity in a workspace over a date range (plus peak parallel test-run capacity). | workspace ID Optional: start date, end date, and metric names |
— |
| 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 |
— |
| list_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 |
— |
| list_mabl_applications | Get applications in a workspace with their associated environments and URLs. | workspace ID Optional: limit and cursor |
— |
| list_mabl_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 |
— |
| list_mabl_branches | Lists mabl source-control branches in a workspace. | Optional: workspace_id, test_id, status, limit, and cursor | — |
| list_mabl_credentials | Get credentials available in a workspace. | workspace ID Optional: limit and cursor |
— |
| list_mabl_data_tables | Get the data tables in a workspace. | workspace ID Optional: limit and cursor |
— |
| list_mabl_deployment_events | 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 |
— |
| list_mabl_environments | Get environments in a workspace, such as staging or production. | workspace ID Optional: limit and cursor |
— |
| list_mabl_failure_reasons | Lists failure reason definitions for a workspace: mabl default categories plus any custom reasons. | workspace ID Optional: include disabled |
— |
| list_mabl_file_uploads | Get the file uploads stored in a workspace. | workspace ID Optional: limit and cursor |
— |
| list_mabl_flow_versions | List every version of a mabl flow, newest first, with its branch, creation time, and change description. | flow ID Optional: branch |
— |
| list_mabl_plan_runs | Get recent execution results for a plan by plan ID. | plan ID and workspace ID Optional: limit and cursor |
— |
| list_mabl_plans | Get test plans in a workspace. | workspace ID Optional: test ID, limit, and cursor |
— |
| list_mabl_test_run_summaries | Find recent mabl test runs across a workspace, with optional filters for status, test type, failure category, application, environment, and pagination. | workspace ID Optional: status, test type, labels, application ID, environment ID, test ID, failure category ID, start time ms, end time ms, exclude default tests, limit, and cursor |
— |
| list_mabl_test_runs | Returns recent execution results for a single mabl test by test ID. | test ID and workspace ID Optional: limit, status, since ms, include analysis, and cursor |
— |
| list_mabl_test_versions | List every version of a mabl test, newest first, with its branch, creation time, and change description. | test ID Optional: branch |
— |
| list_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, limit, and cursor |
— |
| list_mabl_tests_using_flow | Returns the tests that reference a given flow, paginated. | flow_id Optional: branch, limit, and cursor |
— |
| list_mabl_users | Resolves a batch of mabl user IDs to their name and email. | workspace ID and user ids | — |
| list_mabl_workspaces | Get all workspaces the current caller has access to. | none | — |
| list_xray_test_cases | Get Xray test cases for a specific Xray project. | workspace ID Optional: xray project ID, limit, cursor, and search |
— |
| list_xray_test_plans | Get Xray test plans for a specific Xray project. | workspace ID Optional: xray project ID, limit, cursor, and search |
— |
| 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_merge | Initiate a cloud test authoring session that merges one branch’s version of a mabl test into another branch. | workspace ID, test ID, target branch, and source branch | — |
| 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 |
— |
| 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, deployment ID, url override, branch, repeat index, scenario ID, and data table ID |
— |
| 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, keep browser open, and branch |
— |
| search_mabl_docs | Search mabl help center articles. | query Optional: per_page |
— |
| search_mabl_flows | Search for mabl flows by what they do, using a natural language query. | query Optional: workspace ID, application_id, flow_type, and limit |
— |
| 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 from the mabl app, CLI, and API.