Skip to content

TOOLSET.md

Latest commit

 

History

History
759 lines (477 loc) · 35.3 KB

TOOLSET.md

File metadata and controls

759 lines (477 loc) · 35.3 KB
Raw

Toolset

This page lists all available tools provided by the local Azure DevOps MCP server. Use it as a reference to understand what each tool does, what parameters it requires, and how tools are organized by functional area.

Overview

Advanced Security

Tool Description
mcp_ado_advsec_get_alerts Retrieve Advanced Security alerts for a repository
mcp_ado_advsec_get_alert_details Get detailed information about a specific security alert

Core

Tool Description
mcp_ado_core_list_projects List all projects in the organization
mcp_ado_core_list_project_teams List teams within a project
mcp_ado_core_get_identity_ids Retrieve identity IDs by search filter

Pipelines

Tool Description
mcp_ado_pipelines_create_pipeline Create a new pipeline with YAML configuration
mcp_ado_pipelines_get_builds Retrieve a list of builds with optional filters
mcp_ado_pipelines_get_build_status Get the status of a specific build
mcp_ado_pipelines_get_build_log Retrieve complete logs for a build
mcp_ado_pipelines_get_build_log_by_id Get a specific build log by log ID
mcp_ado_pipelines_get_build_changes Get changes (commits) associated with a build
mcp_ado_pipelines_get_build_definitions List build/pipeline definitions in a project
mcp_ado_pipelines_get_build_definition_revisions Get revision history of a build definition
mcp_ado_pipelines_run_pipeline Start a new pipeline run with optional parameters
mcp_ado_pipelines_get_run Get details of a specific pipeline run
mcp_ado_pipelines_list_runs List recent runs for a pipeline
mcp_ado_pipelines_update_build_stage Update a build stage (cancel, retry, or run)

Repositories

Tool Description
mcp_ado_repo_list_repos_by_project List all repositories in a project
mcp_ado_repo_get_repo_by_name_or_id Get repository details by name or ID
mcp_ado_repo_list_branches_by_repo List all branches in a repository
mcp_ado_repo_list_my_branches_by_repo List branches created by current user
mcp_ado_repo_get_branch_by_name Get details of a specific branch
mcp_ado_repo_create_branch Create a new branch from a source branch
mcp_ado_repo_search_commits Search for commits with comprehensive filters
mcp_ado_repo_list_pull_requests_by_repo_or_project List pull requests with optional filters
mcp_ado_repo_list_pull_requests_by_commits Find pull requests containing specific commits
mcp_ado_repo_get_pull_request_by_id Get details of a specific pull request
mcp_ado_repo_get_pull_request_changes Get file changes (diff) for a pull request
mcp_ado_repo_create_pull_request Create a new pull request
mcp_ado_repo_update_pull_request Update pull request properties and settings
mcp_ado_repo_update_pull_request_reviewers Add or remove reviewers from a pull request
mcp_ado_repo_vote_pull_request Cast a vote on a pull request
mcp_ado_repo_list_pull_request_threads List comment threads on a pull request
mcp_ado_repo_list_pull_request_thread_comments List comments in a specific thread
mcp_ado_repo_create_pull_request_thread Create a new comment thread on a pull request
mcp_ado_repo_update_pull_request_thread Update an existing pull request comment thread
mcp_ado_repo_reply_to_comment Reply to a pull request comment
mcp_ado_repo_list_directory List files and folders in a directory
mcp_ado_repo_get_file_content Get file content at a specific version

Search

Tool Description
mcp_ado_search_code Search for code across repositories
mcp_ado_search_wiki Search wiki pages by keywords
mcp_ado_search_workitem Search work items by text and filters

Test Plans

Tool Description
mcp_ado_testplan_list_test_plans List test plans in a project
mcp_ado_testplan_create_test_plan Create a new test plan
mcp_ado_testplan_list_test_suites List test suites in a test plan
mcp_ado_testplan_create_test_suite Create a test suite within a test plan
mcp_ado_testplan_add_test_cases_to_suite Add test cases to a test suite
mcp_ado_testplan_list_test_cases List test cases in a test suite
mcp_ado_testplan_create_test_case Create a new test case work item
mcp_ado_testplan_update_test_case_steps Update steps of an existing test case
mcp_ado_testplan_show_test_results_from_build_id Get test results for a specific build

Wiki

Tool Description
mcp_ado_wiki_list_wikis List wikis in organization or project
mcp_ado_wiki_get_wiki Get details of a specific wiki
mcp_ado_wiki_list_pages List pages in a wiki
mcp_ado_wiki_get_page Get wiki page metadata (without content)
mcp_ado_wiki_get_page_content Retrieve wiki page content
mcp_ado_wiki_create_or_update_page Create or update a wiki page

Work Items

Tool Description
mcp_ado_wit_get_work_item Get a work item by ID
mcp_ado_wit_get_work_items_batch_by_ids Retrieve multiple work items by IDs
mcp_ado_wit_create_work_item Create a new work item
mcp_ado_wit_update_work_item Update fields of a work item
mcp_ado_wit_update_work_items_batch Update multiple work items in batch
mcp_ado_wit_add_child_work_items Create child work items under a parent
mcp_ado_wit_work_items_link Link work items together
mcp_ado_wit_work_item_unlink Remove links from a work item
mcp_ado_wit_add_artifact_link Link artifacts (commits, builds, PRs) to work items
mcp_ado_wit_link_work_item_to_pull_request Link a work item to a pull request
mcp_ado_wit_list_work_item_comments List comments on a work item
mcp_ado_wit_add_work_item_comment Add a comment to a work item
mcp_ado_wit_update_work_item_comment Update an existing comment on a work item
mcp_ado_wit_list_work_item_revisions Get revision history of a work item
mcp_ado_wit_get_work_item_type Get details of a work item type
mcp_ado_wit_my_work_items List work items relevant to current user
mcp_ado_wit_get_work_items_for_iteration Get work items in a specific iteration
mcp_ado_wit_list_backlogs List backlogs for a team
mcp_ado_wit_list_backlog_work_items Get work items in a backlog
mcp_ado_wit_get_query Get a work item query by ID or path
mcp_ado_wit_get_query_results_by_id Execute a query and get results
mcp_ado_wit_query_by_wiql Execute a WIQL query and return matching work items
mcp_ado_wit_get_work_item_attachment Download a work item attachment; save locally or return as base64

Work

Note: The work tools are being aligned with the Azure DevOps remote MCP server tool structure.

Tool Action Description
work list_iterations List all iterations in a project
work list_team_iterations List iterations assigned to a team
work get_team_settings Get team settings including default iteration, backlog iteration, and default area path
work get_team_capacity Get team capacity for an iteration
work get_iteration_capacities Get an iteration's capacity for all teams in the iteration and project
work_iteration_write create Create iterations
work_iteration_write assign Assign iterations to a team
work_capacity_write update Update the team capacity of a team member for a specific iteration

Details

Advanced Security

mcp_ado_advsec_get_alerts

Retrieve Advanced Security alerts for a repository.

  • Required: project, repository, confidenceLevels
  • Optional: alertType, continuationToken, onlyDefaultBranch, orderBy, ref, ruleId, ruleName, severities, states, toolName, top, validity

mcp_ado_advsec_get_alert_details

Get detailed information about a specific Advanced Security alert.

  • Required: project, repository, alertId
  • Optional: ref

Core

mcp_ado_core_list_projects

Retrieve a list of projects in your Azure DevOps organization.

  • Required: None
  • Optional: continuationToken, projectNameFilter, skip, stateFilter, top

mcp_ado_core_list_project_teams

Retrieve a list of teams for the specified Azure DevOps project.

  • Required: project
  • Optional: mine, skip, top

mcp_ado_core_get_identity_ids

Retrieve Azure DevOps identity IDs for a provided search filter.

  • Required: searchFilter
  • Optional: None

Pipelines

mcp_ado_pipelines_create_pipeline

Creates a pipeline definition with YAML configuration for a given project.

  • Required: project, name, yamlPath, repositoryType, repositoryName
  • Optional: folder, repositoryConnectionId, repositoryId

mcp_ado_pipelines_get_builds

Retrieves a list of builds for a given project.

  • Required: project
  • Optional: branchName, buildIds, buildNumber, continuationToken, definitions, deletedFilter, maxBuildsPerDefinition, maxTime, minTime, properties, queryOrder, queues, reasonFilter, repositoryId, repositoryType, requestedFor, resultFilter, statusFilter, tagFilters, top

mcp_ado_pipelines_get_build_status

Fetches the status of a specific build.

  • Required: project, buildId
  • Optional: None

mcp_ado_pipelines_get_build_log

Retrieves the logs for a specific build.

  • Required: project, buildId
  • Optional: None

mcp_ado_pipelines_get_build_log_by_id

Get a specific build log by log ID.

  • Required: project, buildId, logId
  • Optional: endLine, startLine

mcp_ado_pipelines_get_build_changes

Get the changes associated with a specific build.

  • Required: project, buildId
  • Optional: continuationToken, includeSourceChange, top

mcp_ado_pipelines_get_build_definitions

Retrieves a list of build definitions for a given project.

  • Required: project
  • Optional: builtAfter, continuationToken, definitionIds, includeAllProperties, includeLatestBuilds, minMetricsTime, name, notBuiltAfter, path, processType, queryOrder, repositoryId, repositoryType, taskIdFilter, top, yamlFilename

mcp_ado_pipelines_get_build_definition_revisions

Retrieves a list of revisions for a specific build definition.

  • Required: project, definitionId
  • Optional: None

mcp_ado_pipelines_run_pipeline

Starts a new run of a pipeline.

  • Required: project, pipelineId
  • Optional: pipelineVersion, previewRun, resources, stagesToSkip, templateParameters, variables, yamlOverride

mcp_ado_pipelines_get_run

Gets a run for a particular pipeline.

  • Required: project, pipelineId, runId
  • Optional: None

mcp_ado_pipelines_list_runs

Gets top 10000 runs for a particular pipeline.

  • Required: project, pipelineId
  • Optional: None

mcp_ado_pipelines_update_build_stage

Updates the stage of a specific build.

  • Required: project, buildId, stageName, status
  • Optional: forceRetryAllJobs

mcp_ado_pipelines_list_artifacts

Lists artifacts for a given build.

  • Required: project, buildId

mcp_ado_pipelines_download_artifact

Downloads a pipeline artifact.

  • Required: project, buildId, artifactName
  • Optional: destinationPath (relative local path; absolute paths and path traversal are not allowed)

Repositories

mcp_ado_repo_list_repos_by_project

Retrieve a list of repositories for a given project.

  • Required: project
  • Optional: repoNameFilter, skip, top

mcp_ado_repo_get_repo_by_name_or_id

Get the repository by project and repository name or ID.

  • Required: project, repositoryNameOrId
  • Optional: None

mcp_ado_repo_list_branches_by_repo

Retrieve a list of branches for a given repository.

  • Required: repositoryId
  • Optional: filterContains, top

mcp_ado_repo_list_my_branches_by_repo

Retrieve a list of my branches for a given repository Id.

  • Required: repositoryId
  • Optional: filterContains, top

mcp_ado_repo_get_branch_by_name

Get a branch by its name.

  • Required: repositoryId, branchName
  • Optional: None

mcp_ado_repo_create_branch

Create a new branch in the repository.

  • Required: repositoryId, branchName
  • Optional: sourceBranchName, sourceCommitId

mcp_ado_repo_search_commits

Search for commits across projects and repositories with comprehensive filtering capabilities.

  • Required: searchText
  • Optional: project, repository, branch, author, commitStartDate, commitEndDate, orderBy, includeFacets, skip, top

mcp_ado_repo_list_pull_requests_by_repo_or_project

Retrieve a list of pull requests for a given repository.

  • Required: None (either repositoryId or project must be provided)
  • Optional: created_by_me, created_by_user, i_am_reviewer, project, repositoryId, skip, sourceRefName, status, targetRefName, top, user_is_reviewer

mcp_ado_repo_list_pull_requests_by_commits

Lists pull requests by commit IDs to find which pull requests contain specific commits.

  • Required: project, repository, commits
  • Optional: queryType

mcp_ado_repo_get_pull_request_by_id

Get a pull request by its ID.

  • Required: repositoryId, pullRequestId
  • Optional: project, includeWorkItemRefs, includeLabels, includeChangedFiles

mcp_ado_repo_get_pull_request_changes

Get the file changes (diff) for a pull request iteration with actual code diff content. Returns the code changes including line-by-line diffs made in the pull request.

  • Required: repositoryId, pullRequestId
  • Optional: iterationId, project, top, skip, compareTo, includeDiffs, includeLineContent

Notes:

  • If iterationId is not specified, returns changes for the latest iteration
  • Use compareTo to get changes between two specific iterations
  • Supports pagination with top and skip parameters
  • By default, includes line-by-line diff metadata (line numbers, change types) AND actual code content
  • Set includeDiffs=false to get only file metadata without diff information
  • Set includeLineContent=false to exclude actual code lines and get only diff metadata (line numbers, change types)
  • The diff content includes lineDiffBlocks showing line numbers and change types
  • By default, each lineDiffBlock includes originalLines (from base) and modifiedLines (from target) arrays with actual code content

mcp_ado_repo_create_pull_request

Create a new pull request.

  • Required: repositoryId, sourceRefName, targetRefName, title
  • Optional: description, forkSourceRepositoryId, isDraft, labels, workItems

mcp_ado_repo_update_pull_request

Update a Pull Request by ID with specified fields.

  • Required: repositoryId, pullRequestId
  • Optional: autoComplete, bypassReason, deleteSourceBranch, description, isDraft, mergeStrategy, status, targetRefName, title, transitionWorkItems

mcp_ado_repo_update_pull_request_reviewers

Add or remove reviewers for an existing pull request.

  • Required: repositoryId, pullRequestId, reviewerIds, action
  • Optional: None

mcp_ado_repo_vote_pull_request

Cast a vote on a pull request.

  • Required: repositoryId, pullRequestId, vote
  • Optional: None

mcp_ado_repo_list_pull_request_threads

Retrieve a list of comment threads for a pull request.

  • Required: repositoryId, pullRequestId
  • Optional: baseIteration, fullResponse, iteration, project, skip, top

mcp_ado_repo_list_pull_request_thread_comments

Retrieve a list of comments in a pull request thread.

  • Required: repositoryId, pullRequestId, threadId
  • Optional: fullResponse, project, skip, top

mcp_ado_repo_create_pull_request_thread

Creates a new comment thread on a pull request.

  • Required: repositoryId, pullRequestId, content
  • Optional: filePath, project, rightFileEndLine, rightFileEndOffset, rightFileStartLine, rightFileStartOffset, status

mcp_ado_repo_update_pull_request_thread

Updates an existing comment thread on a pull request.

  • Required: repositoryId, pullRequestId, threadId
  • Optional: project, status

mcp_ado_repo_reply_to_comment

Replies to a specific comment on a pull request.

  • Required: repositoryId, pullRequestId, threadId, content
  • Optional: fullResponse, project

mcp_ado_repo_list_directory

List files and folders in a directory within a repository.

  • Required: repositoryId
  • Optional: path, project, version, versionType, recursive, recursionDepth

mcp_ado_repo_get_file_content

Get the content of a file from a Git repository at a specific version (branch, tag, or commit SHA).

  • Required: repositoryId, path
  • Optional: project, version, versionType

Search

mcp_ado_search_code

Search Azure DevOps Repositories for a given search text.

  • Required: searchText
  • Optional: branch, includeFacets, path, project, repository, skip, top

mcp_ado_search_wiki

Search Azure DevOps Wiki for a given search text.

  • Required: searchText
  • Optional: includeFacets, project, skip, top, wiki

mcp_ado_search_workitem

Get Azure DevOps Work Item search results for a given search text.

  • Required: searchText
  • Optional: areaPath, assignedTo, includeFacets, project, skip, state, top, workItemType

Test Plans

mcp_ado_testplan_list_test_plans

Retrieve a paginated list of test plans from an Azure DevOps project.

  • Required: project
  • Optional: continuationToken, filterActivePlans, includePlanDetails

mcp_ado_testplan_create_test_plan

Creates a new test plan in the project.

  • Required: project, name, iteration
  • Optional: areaPath, description, endDate, startDate

mcp_ado_testplan_list_test_suites

Retrieve a paginated list of test suites from an Azure DevOps project and Test Plan Id. Returns test suites in a properly nested hierarchical structure.

  • Required: project, planId
  • Optional: continuationToken

mcp_ado_testplan_create_test_suite

Creates a new test suite in a test plan.

  • Required: project, planId, parentSuiteId, name
  • Optional: None

mcp_ado_testplan_add_test_cases_to_suite

Adds existing test cases to a test suite.

  • Required: project, planId, suiteId, testCaseIds
  • Optional: None

mcp_ado_testplan_list_test_cases

Gets a list of test cases in the test plan.

  • Required: project, planid, suiteid
  • Optional: continuationToken

mcp_ado_testplan_create_test_case

Creates a new test case work item. Step content supports text formatting — use HTML tags (<b>, <i>, <u>, <code>) or Markdown markers (**bold**, *italic*, `code`, [label](url)) directly in step text and expected results.

  • Required: project, title
  • Optional: areaPath, iterationPath, priority, steps, testsWorkItemId

mcp_ado_testplan_update_test_case_steps

Update the steps of an existing test case work item. Step content supports text formatting — use HTML tags (<b>, <i>, <u>, <code>) or Markdown markers (**bold**, *italic*, `code`, [label](url)) directly in step text and expected results.

  • Required: id, steps
  • Optional: None

mcp_ado_testplan_show_test_results_from_build_id

Gets a list of test results for a given project and build ID. Can filter by test outcome (e.g. Failed, Passed, Aborted). Returns test case titles, error messages, stack traces, and outcomes.

  • Required: project, buildid
  • Optional: outcomes

Wiki

mcp_ado_wiki_list_wikis

Retrieve a list of wikis for an organization or project.

  • Required: None
  • Optional: project

mcp_ado_wiki_get_wiki

Get the wiki by wikiIdentifier.

  • Required: wikiIdentifier
  • Optional: project

mcp_ado_wiki_list_pages

Retrieve a list of wiki pages for a specific wiki and project.

  • Required: wikiIdentifier, project
  • Optional: continuationToken, pageViewsForDays, top

mcp_ado_wiki_get_page

Retrieve wiki page metadata by path. This tool does not return page content.

  • Required: wikiIdentifier, project, path
  • Optional: recursionLevel

mcp_ado_wiki_get_page_content

Retrieve wiki page content.

  • Required: None (either url OR wikiIdentifier and project)
  • Optional: path, project, url, wikiIdentifier

mcp_ado_wiki_create_or_update_page

Create or update a wiki page with content.

  • Required: wikiIdentifier, path, content
  • Optional: branch, etag, project

Work Items

mcp_ado_wit_get_work_item

Get a single work item by ID.

  • Required: id, project
  • Optional: asOf, expand, fields

mcp_ado_wit_get_work_items_batch_by_ids

Retrieve list of work items by IDs in batch.

  • Required: project, ids
  • Optional: fields

mcp_ado_wit_create_work_item

Create a new work item in a specified project and work item type.

  • Required: project, workItemType, fields
  • Optional: None

mcp_ado_wit_update_work_item

Update a work item by ID with specified fields.

  • Required: id, updates
  • Optional: None

mcp_ado_wit_update_work_items_batch

Update work items in batch.

  • Required: updates
  • Optional: None

mcp_ado_wit_add_child_work_items

Create one or many child work items from a parent by work item type and parent id.

  • Required: parentId, project, workItemType, items
  • Optional: None

mcp_ado_wit_work_items_link

Link work items together in batch.

  • Required: project, updates
  • Optional: None

mcp_ado_wit_work_item_unlink

Remove one or many links from a single work item.

  • Required: project, id
  • Optional: type, url

mcp_ado_wit_add_artifact_link

Add artifact links (repository, branch, commit, builds) to work items.

  • Required: workItemId, project
  • Optional: artifactUri, branchName, buildId, comment, commitId, linkType, projectId, pullRequestId, repositoryId

mcp_ado_wit_link_work_item_to_pull_request

Link a single work item to an existing pull request.

  • Required: projectId, repositoryId, pullRequestId, workItemId
  • Optional: pullRequestProjectId

mcp_ado_wit_list_work_item_comments

Retrieve list of comments for a work item by ID.

  • Required: project, workItemId
  • Optional: top

mcp_ado_wit_add_work_item_comment

Add comment to a work item by ID.

  • Required: project, workItemId, comment
  • Optional: format

mcp_ado_wit_update_work_item_comment

Update an existing comment on a work item by ID.

  • Required: project, workItemId, commentId, text
  • Optional: format

mcp_ado_wit_list_work_item_revisions

Retrieve list of revisions for a work item by ID.

  • Required: project, workItemId
  • Optional: expand, skip, top

mcp_ado_wit_get_work_item_type

Get a specific work item type.

  • Required: project, workItemType
  • Optional: None

mcp_ado_wit_my_work_items

Retrieve a list of work items relevant to the authenticated user.

  • Required: project
  • Optional: includeCompleted, top, type

mcp_ado_wit_get_work_items_for_iteration

Retrieve a list of work items for a specified iteration.

  • Required: project, iterationId
  • Optional: team

mcp_ado_wit_list_backlogs

Receive a list of backlogs for a given project and team.

  • Required: project, team
  • Optional: None

mcp_ado_wit_list_backlog_work_items

Retrieve a list of backlogs for a given project, team, and backlog category.

  • Required: project, team, backlogId
  • Optional: None

mcp_ado_wit_get_query

Get a query by its ID or path.

  • Required: project, query
  • Optional: depth, expand, includeDeleted, useIsoDateFormat

mcp_ado_wit_get_query_results_by_id

Retrieve the results of a work item query given the query ID.

  • Required: id
  • Optional: project, responseType, team, timePrecision, top

mcp_ado_wit_query_by_wiql

Execute a WIQL (Work Item Query Language) query and return the matching work items. If a project is not specified, you will be prompted to select one.

  • Required: wiql
  • Optional: project, team, timePrecision, top

mcp_ado_wit_get_work_item_attachment

Download a work item attachment by its ID. If savePath is provided, saves the file to that local directory and returns the file path. Otherwise returns the content as a base64-encoded resource. Useful for viewing images (e.g. screenshots) or other files attached to work items such as bugs.

  • Required: attachmentId
  • Optional: project, fileName, savePath

Work

Note: The work tools are being aligned with the Azure DevOps remote MCP server tool structure.

The work tools are consolidated into grouped dispatchers using an action parameter.

Tool Action Description Read-only
work list_iterations List all iterations in a project ✅
work list_team_iterations List iterations assigned to a team ✅
work get_team_settings Get team settings including default iteration, backlog iteration, and default area path ✅
work get_team_capacity Get team capacity for an iteration ✅
work get_iteration_capacities Get an iteration's capacity for all teams in the iteration and project ✅
work_iteration_write create Create iterations ❌
work_iteration_write assign Assign iterations to a team ❌
work_capacity_write update Update the team capacity of a team member for a specific iteration ❌