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 |
— |
| analyze_test_impact | Finds the existing mabl tests relevant to a described code change and flags any user-facing areas with no apparent test coverage. | change description and application ID Optional: guidance, include plans, references, revision, and branch |
— |
| 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_agent_instruction | Create a new agent instruction in a workspace. | workspace ID, name, and instruction text Optional: capabilities, application ids, environment ids, and disabled |
— |
| 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, and environment ID Optional: deployment ID, test ids, concurrency, stages, description, labels, credentials ID, http auth credentials ID, schedules, and deployment trigger |
— |
| edit_mabl_agent_instruction | Edit an agent instruction: rename it, replace its text, switch it off or back on, or change which capabilities, applications and environments it applies to. | instruction ID and operations | — |
| edit_mabl_data_table | Edit an existing data table’s rows or name and description by applying a list of operations. | data table ID and operations | — |
| edit_mabl_environment | Edit a mabl environment: set or remove an environment variable, rename it, or change its description. | environment ID and operations | — |
| 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_agent_instruction | Get a single agent instruction by ID, including its full text, its scope, and whether it is switched on. | instruction ID | — |
| 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_branch_merge_status | Reports whether merging one mabl source-control branch into another would land any changes, and whether the target branch has moved on since the source branch was cut. | workspace ID and from Optional: to |
— |
| 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_environment | Get one mabl environment by ID, including the names of the environment variables it defines. | environment 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_run_performance | Returns the results of a mabl performance test run, including response times, error rates, and pass or fail for each failure criterion. | test run ID and workspace ID Optional: include endpoints and include browser steps |
— |
| 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, jira issue ID, and branch |
— |
| list_authoring_sessions | Returns the authoring agent sessions that created or edited mabl tests or reusable flows, 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_activity | Returns the workspace activity feed: who created, updated, deleted, or restored a mabl entity, and when. | workspace ID Optional: action type, entity type, entity name, actor ID, actor is mabl employee, start time ms, end time ms, is automator event, include entity json, limit, and cursor |
— |
| list_mabl_agent_instructions | List the agent instructions in a workspace, with the full text, scope and on/off state of each. | workspace ID Optional: capability, application ID, environment ID, test type, 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, limit, and cursor |
— |
| 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, cursor, name, and labels |
— |
| list_mabl_test_run_artifacts | Lists the artifacts a mabl test run captured, with one entry per step holding the gs:// URIs of that step’s screenshots, DOM snapshot, HAR, console log, and Chrome trace. | test run ID Optional: workspace ID, limit, and cursor |
— |
| list_mabl_test_run_summaries | Find recently finished 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 name, label, test case ID, author, type, and branch. | workspace ID Optional: labels, exclude labels, test case ids, branch, branch changes only, author ID, application ID, test type, limit, cursor, and name |
— |
| 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_workspace_users | Lists the people who are members of a mabl workspace. | workspace ID Optional: limit and cursor |
— |
| 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 cloud test authoring session, resuming it when paused. | 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 Optional: impact session ID and objective |
— |
| 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, api spec, impact session ID, and objective |
— |
| 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, api spec, and objective |
— |
| mabl_authoring_list | Lists the cloud test and flow 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, requested changes, and attach files |
— |
| mabl_authoring_status | Checks the status of a cloud test or flow authoring session, including the pending question when it is paused awaiting an answer. | session ID Optional: workspace ID, instance ID, and verbose |
— |
| mabl_flow_authoring_edit | Starts a cloud agent session that changes an existing reusable mabl flow by exploring the live application. | workspace ID, flow ID, and intent Optional: branch, source branch, credentials ID, and url override |
— |
| mabl_flow_authoring_initiate | Starts a cloud agent session that authors a new reusable mabl flow by exploring the live application. | workspace ID, name, intent, application ID, and environment ID Optional: url override, credentials ID, and branch |
— |
| 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_deleted_entity | Restores a mabl entity that was deleted, bringing it back with its contents intact. | workspace ID, entity type, and entity 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_batch_cloud | Trigger one cloud run that executes a set of mabl tests together and reports them on a single results page. | test ids, workspace ID, environment ID, application ID, and browsers Optional: credentials ID, test credentials, deployment ID, url override, branch, concurrency, concurrency limit, http headers, impact session ID, and revision |
— |
| 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, data table ID, and http headers |
— |
| 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 that runs the plans matching an application or environment, an explicit set of tests you name, or a re-run of a prior deployment. | Optional: deployment ID, workspace ID, application ID, environment ID, plan labels, revision, branch, properties, debug, url override, api url override, browsers, credentials ID, http auth credentials ID, test ids, impact session ID, selection name, selection source, and test credentials | — |
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.