add_host_list_to_deploy_group
[application delivery] Add host list to deploy group
Take a change from a Codeup branch to a deployed machine without leaving the assistant — raise the merge request, link its work items, run the pipeline, read the job log.
LABSCO SUMMARY
A change request can carry its reviewers and its work items from the moment it is created, then run through a pipeline whose per-step logs you read back call by call. The size is the thing to plan for: at 197 tools, ask for the toolsets that match the job rather than loading everything, and take the hosted endpoint if you would rather not run the process at all.
Alibaba Cloud's Yunxiao platform as 197 tools, grouped by what they act on: Codeup repositories and change requests, projects with work items and sprints, pipelines and their jobs, VM deploy orders, application delivery, artifact repositories and test management.
A Yunxiao organization and a personal access token, granted read and write across the API groups you intend to use. Yunxiao runs it hosted at https://openapi-rdc.aliyuncs.com/ai/mcp — Bearer token, nothing installed — or on a region-edition domain of the form https://<YOUR_ORG>.devops.aliyuncs.com/ai/mcp. Self-hosting instead needs Node 18 or newer and YUNXIAO_ACCESS_TOKEN, plus YUNXIAO_API_BASE_URL when you are on a region edition. Because the catalogue is large, both the hosted endpoint and the container build let you ask for only the toolsets you need.
One command plus a key — npx -y alibabacloud-devops-mcp-server, then supply credentials
USE CASES
Open the change request with its reviewers and work items already attached, then read and answer review comments — global ones and the inline ones tied to a file and line — from the same conversation the code was written in.
Find the run by asking for pipelines from 'today' or 'this week', walk into the failing job's steps, pull the log for the step that broke, and retry that job once the cause is clear.
Search the backlog by assignee, status and priority, see which sprints exist, open the next one with dates and a capacity, and move the chosen items into it.
Effort has its own calls because Yunxiao locks those fields: actual and estimated hours are controlled, so the ordinary work-item update will not set them however the request is shaped.
Read the deploy order, pull the log for the machine that is stuck, then retry that machine or skip it so the rest of the rollout continues.
Progress comes back already counted as passed, failed, postponed and pending, so the status update is a read rather than a tally, and a result can be corrected in the same pass.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
add_host_list_to_deploy_group[application delivery] Add host list to deploy group
add_host_list_to_host_group[application delivery] Add host list to host group
cancel_app_release_stage_executionCancel a running release workflow stage.
cancel_appstack_change_request[application delivery] Cancel a change request
close_appstack_change_request[application delivery] Close a change request
compare[Code Management] Query code to compare content
create_app_orchestration[application delivery] Create an application orchestration
create_app_tag[application delivery] Create an application tag
create_application[application delivery] Create a new application
create_appstack_change_request[application delivery] Create a change request
create_branch[Code Management] Create a new branch in a Codeup repository
create_change_orderCreate a deployment order.
create_change_request[Code Management] Create a new change request (merge request). Supports specifying source/target branches, reviewers, associated work items, and optional AI review trigger.
create_change_request_comment[Code Management] Create a comment on a change request. Supports two types: GLOBAL_COMMENT (global comment on the entire merge request) and INLINE_COMMENT (inline comment on specific code lines). For INLINE_COMMENT, you must provide file_path, line_number, from_patchset_biz_id, and to_patchset_biz_id parameters.
create_commit_comment[Code Management] Create a comment on a commit
create_effort_recordLog actual hours against a work item. Actual effort (fieldId 101587) is a controlled field, so update_work_item's customFieldValues cannot set it.
create_estimated_effortLog estimated hours against a work item. Estimated effort (fieldId 101586) is a controlled field, so update_work_item's customFieldValues cannot set it.
create_file[Code Management] Create a new file in a Codeup repository
create_flow_variable_group[Pipeline Management] Create an organization-level variable group for Flow (pipeline).
create_global_var[application delivery] Create a global variable group
create_pipeline_from_description[Pipeline Management] Create a pipeline from structured parameters.
Workflow: take the parameters the user stated explicitly, fill the rest by inspecting the local project (each parameter's description says which file or git command to read), then call this tool.
Guidelines:
create_pipeline_run[Pipeline Management] Run a pipeline.
Use the simplified parameters (branch, tag, branches, repositories, environmentVariables). Do NOT hand-craft the 'params' JSON — it is only for a raw JSON string the user supplies verbatim, and it overrides everything else.
Behavior: passing branch or tag alone resolves the repository URLs from the pipeline config automatically; passing branches enables branch mode.
create_repository[Code Management] Create a new Codeup repository.
Creates an empty code repository that can then be pushed to via git.
Use Cases:
Create a new repository for a project
create_resource_member[Resource Member Management] Create a resource member
create_sprint[Project Management] Create a new sprint
create_test_plan_testcase_commentComment on a test case inside a test plan, replying through parentId; separate from comments on the case in its repository.
create_testcaseCreate a test case, with preconditions, steps, labels and an assignee.
create_testcase_commentComment on a test case, replying to another comment through parentId.
create_testcase_directoryCreate a test case directory.
create_variable_group[application delivery] Create a variable group
create_version[Project Management] Create a new version in a Yunxiao Project. Versions are used to manage release plans and track delivery progress.
Use Cases:
Create a new release version Plan project milestones Set version owners and dates
create_work_itemCreate a work item. The description takes Markdown or rich text, set with formatType; to embed an image, create the item first, upload through create_workitem_attachment for its embedMarkdown or embedHtml value, then write the description back with update_work_item — the url it returns is a signed link that expires after 30 seconds.
create_work_item_comment[Project Management] Create a comment for a specific work item
create_workitem_attachmentUpload a file as a work-item attachment over multipart/form-data. Any type up to 10MB is accepted except svg and tiff. A remote deployment passes fileContent as base64 with a fileName; a server on the same machine can take filePath instead.
create_workitem_testcase_relation[Project Management] Relate a test case to a work item. Returns the created relation record id.
delete_app_orchestration[application delivery] Delete an application orchestration
delete_branch[Code Management] Delete a branch from a Codeup repository
delete_file[Code Management] Delete a file from a Codeup repository
delete_flow_variable_group[Pipeline Management] Delete a Flow (pipeline) variable group by numeric id.
delete_resource_member[Resource Member Management] Delete a resource member
delete_testcaseDelete a test case.
delete_variable_group[application delivery] Delete a variable group
delete_version[Project Management] Delete a version from a Yunxiao Project.
Use Cases:
Remove obsolete versions Clean up project versions
delete_work_item[Project Management] Delete a work item. This operation is irreversible.
delete_workitem_testcase_relation[Project Management] Remove a test case relation from a work item by relationRecordId (obtained from list_workitem_testcase_relations).
execute_app_release_stageRun a change request through a stage of the release workflow.
execute_job_actionAct on an environment's deployment order.
execute_pipeline_job_action[Pipeline Management] Execute a subsequent action of a pipeline job.
execute_pipeline_job_run[Pipeline Management] Manually run a pipeline task. Start a specific job in a pipeline run instance.
find_task_operation_logFetch the execution log of a deployment task, including the scheduling detail from the downstream deploy engine.
generate_pipeline_yaml[Pipeline Management] Generate the pipeline YAML without creating the pipeline — a dry run of create_pipeline_from_description, for previewing the config or debugging a generation problem. Takes the same parameters and follows the same guidelines.
get_app_orchestration[application delivery] Get an application orchestration
get_app_release_stage_job_logFetch the run log of a job in a development stage pipeline.
get_app_release_stage_pipeline_runGet the pipeline run instance for a development stage.
get_app_release_workflow_stageGet the detail of one stage of a release workflow.
get_app_variable_groups[application delivery] Get variable groups for an application
get_app_variable_groups_revision[application delivery] Get the revision of variable groups for an application
get_application[application delivery] Get application details by name
get_appstack_change_request_audit_items[application delivery] Get audit items for a change request
get_artifact[Packages Management] Get information about a single artifact in a package repository
get_branch[Code Management] Get information about a branch in a Codeup repository
get_change_orderRead the artifacts a deployment order uses and the state it is in.
get_change_request[Code Management] Get detailed information about a specific change request (merge request) by its local ID.
get_commit[Code Management] Get information about a commit
get_current_organization_infoGet information about the current user and organization based on the token. In the absence of an explicitly specified organization ID, this result will take precedence.
get_current_userGet information about the current user based on the token. In the absence of an explicitly specified user ID, this result will take precedence.
get_env_variable_groups[application delivery] Get variable groups for an environment
get_file_blobs[Code Management] Get file content from a Codeup repository
get_flow_variable_group[Pipeline Management] Get a Flow (pipeline) variable group by numeric id.
get_global_var[application delivery] Get a global variable group
get_latest_orchestration[application delivery] Get the latest orchestration for an environment
get_latest_pipeline_run[Pipeline Management] Get information about the latest pipeline run
get_machine_deploy_log[application delivery] Get machine deployment log
get_organization_department_ancestorsGet the ancestors of a department in an organization
get_organization_department_infoGet information about a department in an organization
get_organization_member_infoGet information about a member in an organization
get_organization_member_info_by_user_idGet information about a member in an organization by user ID
get_organization_role[Organization Management] Get information about an organization role
get_pipeline[Pipeline Management] Get details of a specific pipeline in an organization
get_pipeline_job_run_log[Pipeline Management] Get the execution logs of a pipeline job. Retrieve the log content for a specific job in a pipeline run.
get_pipeline_job_step_log[Pipeline Management] Get the log content for a specific step of a pipeline job. Use GetPipelineJobSteps first to get stepIndex and buildId.
get_pipeline_job_step_log_url[Pipeline Management] Get the download URL for a pipeline job step log. Use GetPipelineJobSteps first to get stepIndex and buildId.
get_pipeline_job_steps[Pipeline Management] Get the list of steps for a pipeline job. Returns step details including stepIndex and buildId needed for log retrieval.
get_pipeline_run[Pipeline Management] Get details of a specific pipeline run instance
get_project[Project Management] Get information about a Yunxiao project
get_repository[Code Management] Get information about a Codeup repository
get_sprint[Project Management] Get information about a sprint
get_test_plan_progressReturn execution progress for a test plan, counted as passed, failed, postponed and pending.
get_test_result_listList the test cases inside a test plan.
get_testcaseGet a test case.
get_testcase_field_configGet the field configuration for test cases in a repository.
get_user_organizationsGet the list of organizations the current user belongs to
get_variable_group[application delivery] Get a variable group
get_vm_deploy_machine_log[VM Deploy Order Management] Get VM deploy machine log
get_vm_deploy_order[VM Deploy Order Management] Get VM deploy order details
get_work_item[Project Management] Get information about a work item
get_work_item_type[Project Management] Get details of a specific work item type
get_work_item_type_field_config[Project Management] Get field configuration for a specific work item type
get_work_item_types[Project Management] Get the list of work item types for a project
get_work_item_workflow[Project Management] Get workflow information for a specific work item type
get_workitem_file[Project Management] Get file information for a specific work item. Supports both file IDs (long hex for description-embedded images) and attachment IDs (numeric like 62487031). Returns file details including name, size, suffix, and a temporary download URL.
list_all_work_item_types[Project Management] List all work item types in an organization
list_app_orchestration[application delivery] List application orchestrations
list_app_release_stage_briefsList summaries of the stages in a release workflow.
list_app_release_stage_metadataList the integrated changes recorded against a development stage execution.
list_app_release_stage_runsList the execution records of a release workflow stage.
list_app_release_workflow_briefsList summaries of the release workflows under an application.
list_app_release_workflowsList every release workflow under an application.
list_application_sources[application delivery] List application sources with pagination
list_applications[application delivery] List applications in an organization with pagination
list_appstack_change_request_executions[application delivery] List change request executions
list_appstack_change_request_work_items[application delivery] List work items for a change request
list_appstack_change_requests[application delivery] Search change requests in an application with pagination and filtering
list_artifacts[Packages Management] List artifacts in a package repository with filtering options
list_attached_change_requests[application delivery] List change requests attached to a release
list_branches[Code Management] List branches in a Codeup repository
list_change_order_job_logsFetch the logs of a deployment order for one environment.
list_change_order_versionsList the versions of an application's deployment orders.
list_change_orders_by_originFind deployment orders by what created them.
list_change_request_comments[Code Management] List comments on a change request. Supports filtering by comment type (GLOBAL_COMMENT or INLINE_COMMENT), state (OPENED or DRAFT), resolved status, and file path (for inline comments).
list_change_request_patch_sets[Code Management] List patch sets (versions) for a change request. Patch sets represent different versions of the merge request as it evolves.
list_change_requests[Code Management] List change requests with multi-condition filtering, pagination and sorting. Supports filtering by repository, author, reviewer, state (opened/merged/closed), search keywords, and creation time range.
list_commits[Code Management] List commits in a Codeup repository
list_current_user_effort_recordsList the current user's logged actual hours; the start and end dates cannot be more than 6 months apart.
list_effort_recordsList logged actual hours.
list_estimated_effortsList logged estimated hours.
list_files[Code Management] List file tree from a Codeup repository
list_flow_variable_groups[Pipeline Management] List organization-level Flow (pipeline) variable groups with pagination.
list_global_vars[application delivery] List global variable groups
list_organization_departmentsGet the list of departments in an organization
list_organization_memberslist user members in an organization
list_organization_roles[Organization Management] List organization roles
list_package_repositories[Packages Management] List package repositories in an organization with filtering options
list_pipeline_job_historys[Pipeline Management] Get the execution history of a pipeline task. Retrieve all execution records for a specific task in a pipeline.
list_pipeline_jobs_by_category[Pipeline Management] Get pipeline execution tasks by category. Currently only supports DEPLOY category.
list_pipeline_runs[Pipeline Management] Get a list of pipeline run instances with filtering options
list_pipelines[Pipeline Management] Get a list of pipelines in an organization with filtering options
list_program_versions[Project Management] List versions for a Yunxiao Program (Project Set). Versions are used to manage release plans and track delivery progress.
Use Cases:
List all versions in a program Filter versions by status (TODO, DOING, ARCHIVED) Search versions by name
list_repositories[Code Management] Get the CodeUp Repository List.
A Repository serves as a unit for managing source code and is distinct from a Project.
Use Case:
View my repositories
list_resource_members[Resource Member Management] Get a list of resource members
list_service_connections[Service Connection Management] List service connections in an organization with filtering options
list_sprints[Project Management] List sprints in a project
list_test_plan_result_directoriesList a test plan's result directories, returning the directory tree grouped by test repository with the case count under each.
list_test_plan_testcase_commentsList the comments on a test case inside a test plan, which are held separately from the comments on that case in its repository.
list_test_plansList the test plans in an organization.
list_test_repo_tagsList the tags in a test repository, paged and filterable by name keyword.
list_test_reposList test repositories, paged and filterable by name.
list_testcase_commentsList the comments on a test case.
list_testcase_directoriesList the test case directories in a test repository.
list_versions[Project Management] List versions for a Yunxiao Project or Program. Versions are used to manage release plans and track delivery progress.
Use Cases:
List all versions in a project Filter versions by status (TODO, DOING, ARCHIVED) Search versions by name
list_work_item_comments[Project Management] List comments for a specific work item
list_work_item_relation_work_item_types[Project Management] List work item types that can be related to a specific work item
list_work_item_types[Project Management] List work item types in a project space
list_workitem_activities[Project Management] List activity history for a specific work item. Returns changes including field updates, status transitions, association changes, and attachment changes, with operator and timestamp details.
list_workitem_attachments[Project Management] List attachments for a specific work item. Returns attachment information including file name, size, suffix, download URL, and creator/modifier details.
list_workitem_testcase_relations[Project Management] List test cases related to a work item. Returns relation records including relationRecordId (used for deletion), testcaseId, subject and owner.
pass_app_release_stage_validateApprove the validation gate on a release workflow stage.
pass_pipeline_validate[Pipeline Management] Approve/pass a manual checkpoint (human validation gate) in a pipeline run.
refuse_app_release_stage_validateReject the validation gate on a release workflow stage.
refuse_pipeline_validate[Pipeline Management] Refuse/reject a manual checkpoint (human validation gate) in a pipeline run.
rerun_pipeline_job_run[Pipeline Management] Rerun a pipeline job. Only deploy-type jobs are supported. You can set a job as deploy type in its configuration.
resume_vm_deploy_order[VM Deploy Order Management] Resume VM deploy order
retry_app_release_stage_pipelineRetry the pipeline of a change request's release workflow stage.
retry_pipeline_job_run[Pipeline Management] Retry a failed pipeline job run.
retry_vm_deploy_machine[VM Deploy Order Management] Retry VM deploy machine
search_app_tags[application delivery] Search application tags
search_app_templates[application delivery] Search application templates
search_organization_members[Organization Management] Search for organization members
search_programs[Project Management] Search for Yunxiao Program (Project Set) List. A Program is a collection of multiple related projects, used for unified management and coordination of large projects.
Use Cases:
Query programs by name Query programs by status Query programs by creator
search_projects[Project Management] Search for Yunxiao Project List. A Project is a project management unit that includes work items and sprints, and it is different from a code repository (Repository).
Use Cases:
Query projects I am involved in Query projects I have created
search_testcasesSearch test cases in a test repository.
search_workitems[Project Management] Search work items with various filter conditions
skip_app_release_stage_pipelineSkip the pipeline of a change request's release workflow stage.
skip_pipeline_job_run[Pipeline Management] Skip a pipeline job run.
skip_vm_deploy_machine[VM Deploy Order Management] Skip VM deploy machine
smart_list_pipelines[Pipeline Management] Intelligently search pipelines with natural language time references (e.g., 'today', 'this week')
stop_pipeline_job_run[Pipeline Management] Stop/terminate a running pipeline job.
stop_vm_deploy_order[VM Deploy Order Management] Stop VM deploy order
update_app_orchestration[application delivery] Update an application orchestration. This is a full replacement — include all existing spec fields (componentList, labels, placeholderList, groupNameMap) to avoid data loss. Call get_app_orchestration first to retrieve the current state.
update_app_release_stageUpdate a stage of an application's release workflow.
update_app_tag[application delivery] Update an application tag
update_app_tag_bind[application delivery] Update application tag bindings
update_application[application delivery] Update an existing application
update_change_request_comment[Code Management] Update a comment on a change request. Can update the comment content and/or resolved status.
update_effort_recordUpdate hours already logged as actual effort, which update_work_item's customFieldValues cannot reach.
update_estimated_effortUpdate hours already logged as estimated effort, which update_work_item's customFieldValues cannot reach.
update_file[Code Management] Update an existing file in a Codeup repository
update_flow_variable_group[Pipeline Management] Update a Flow (pipeline) variable group by numeric id.
update_global_var[application delivery] Update a global variable group
update_pipeline[Pipeline Management] Update an existing pipeline in Yunxiao by pipelineId. Use this to update pipeline YAML, stages, jobs, etc.
update_resource_member[Resource Member Management] Update a resource member
update_resource_owner[Resource Member Management] Transfer resource owner
update_sprint[Project Management] Update an existing sprint
update_test_resultRecord the result of a test case in a test plan.
update_variable_group[application delivery] Update a variable group
update_version[Project Management] Update an existing version in a Yunxiao Project. Can update version name, owners, start date, and publish date.
Use Cases:
Update version name Change version owners Modify version dates
update_work_itemUpdate a work item. Apart from organizationId and workItemId, every field being changed goes inside updateWorkItemFields — subject, description, formatType, status, assignedTo, priority, labels, sprint, trackers, verifier, participants, versions and customFieldValues.
BEFORE YOU INSTALL
197 tools when we connected. Some documented names changed: get_compare is now compare and list_change_request is now list_change_requests. The documented tag, tag-group and system-release-workflow tools are not exposed, and --toolsets or DEVOPS_TOOLSETS narrows the list to any of seven groups.
CONTEXT COST
Rated by the size of the 197 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx -y alibabacloud-devops-mcp-serverhttps://openapi-rdc.aliyuncs.com/ai/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
{
"mcpServers": {
"yunxiao": {
"url": "https://openapi-rdc.aliyuncs.com/ai/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}{
"mcpServers": {
"yunxiao": {
"url": "https://<YOUR_ORG>.devops.aliyuncs.com/ai/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}{
"mcpServers": {
"yunxiao": {
"command": "npx",
"args": [
"-y",
"alibabacloud-devops-mcp-server"
],
"env": {
"YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}{
"mcpServers": {
"yunxiao": {
"command": "npx",
"args": [
"-y",
"alibabacloud-devops-mcp-server"
],
"env": {
"YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>",
"YUNXIAO_API_BASE_URL": "https://<YOUR_ORG>.devops.aliyuncs.com"
}
}
}
}{
"mcpServers": {
"yunxiao": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"YUNXIAO_ACCESS_TOKEN",
"build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:latest"
],
"env": {
"YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}