| Functional Area | Tool | Description |
|---|---|---|
| Advanced Security | mcp_ado_advsec_get_alerts | Retrieve Advanced Security alerts for a repository |
| Advanced Security | mcp_ado_advsec_get_alert_details | Get detailed information about a specific security alert |
| Core | mcp_ado_core_list_projects | List all projects in the organization |
| Core | mcp_ado_core_list_project_teams | List teams within a project |
| Core | mcp_ado_core_get_identity_ids | Retrieve identity IDs by search filter |
| Pipelines | mcp_ado_pipelines_create_pipeline | Create a new pipeline with YAML configuration |
| Pipelines | mcp_ado_pipelines_get_builds | Retrieve a list of builds with optional filters |
| Pipelines | mcp_ado_pipelines_get_build_status | Get the status of a specific build |
| Pipelines | mcp_ado_pipelines_get_build_log | Retrieve complete logs for a build |
| Pipelines | mcp_ado_pipelines_get_build_log_by_id | Get a specific build log by log ID |
| Pipelines | mcp_ado_pipelines_get_build_changes | Get changes (commits) associated with a build |
| Pipelines | mcp_ado_pipelines_get_build_definitions | List build/pipeline definitions in a project |
| Pipelines | mcp_ado_pipelines_get_build_definition_revisions | Get revision history of a build definition |
| Pipelines | mcp_ado_pipelines_run_pipeline | Start a new pipeline run with optional parameters |
| Pipelines | mcp_ado_pipelines_get_run | Get details of a specific pipeline run |
| Pipelines | mcp_ado_pipelines_list_runs | List recent runs for a pipeline |
| Pipelines | mcp_ado_pipelines_update_build_stage | Update a build stage (cancel, retry, or run) |
| Repositories | mcp_ado_repo_list_repos_by_project | List all repositories in a project |
| Repositories | mcp_ado_repo_get_repo_by_name_or_id | Get repository details by name or ID |
| Repositories | mcp_ado_repo_list_branches_by_repo | List all branches in a repository |
| Repositories | mcp_ado_repo_list_my_branches_by_repo | List branches created by current user |
| Repositories | mcp_ado_repo_get_branch_by_name | Get details of a specific branch |
| Repositories | mcp_ado_repo_create_branch | Create a new branch from a source branch |
| Repositories | mcp_ado_repo_search_commits | Search for commits with comprehensive filters |
| Repositories | mcp_ado_repo_list_pull_requests_by_repo_or_project | List pull requests with optional filters |
| Repositories | mcp_ado_repo_list_pull_requests_by_commits | Find pull requests containing specific commits |
| Repositories | mcp_ado_repo_get_pull_request_by_id | Get details of a specific pull request |
| Repositories | mcp_ado_repo_create_pull_request | Create a new pull request |
| Repositories | mcp_ado_repo_update_pull_request | Update pull request properties and settings |
| Repositories | mcp_ado_repo_update_pull_request_reviewers | Add or remove reviewers from a pull request |
| Repositories | mcp_ado_repo_list_pull_request_threads | List comment threads on a pull request |
| Repositories | mcp_ado_repo_list_pull_request_thread_comments | List comments in a specific thread |
| Repositories | mcp_ado_repo_create_pull_request_thread | Create a new comment thread on a pull request |
| Repositories | mcp_ado_repo_update_pull_request_thread | Update an existing pull request comment thread |
| Repositories | mcp_ado_repo_reply_to_comment | Reply to a pull request comment |
| Search | mcp_ado_search_code | Search for code across repositories |
| Search | mcp_ado_search_wiki | Search wiki pages by keywords |
| Search | mcp_ado_search_workitem | Search work items by text and filters |
| Test Plans | mcp_ado_testplan_list_test_plans | List test plans in a project |
| Test Plans | mcp_ado_testplan_create_test_plan | Create a new test plan |
| Test Plans | mcp_ado_testplan_list_test_suites | List test suites in a test plan |
| Test Plans | mcp_ado_testplan_create_test_suite | Create a test suite within a test plan |
| Test Plans | mcp_ado_testplan_add_test_cases_to_suite | Add test cases to a test suite |
| Test Plans | mcp_ado_testplan_list_test_cases | List test cases in a test suite |
| Test Plans | mcp_ado_testplan_create_test_case | Create a new test case work item |
| Test Plans | mcp_ado_testplan_update_test_case_steps | Update steps of an existing test case |
| Test Plans | mcp_ado_testplan_show_test_results_from_build_id | Get test results for a specific build |
| Wiki | mcp_ado_wiki_list_wikis | List wikis in organization or project |
| Wiki | mcp_ado_wiki_get_wiki | Get details of a specific wiki |
| Wiki | mcp_ado_wiki_list_pages | List pages in a wiki |
| Wiki | mcp_ado_wiki_get_page | Get wiki page metadata (without content) |
| Wiki | mcp_ado_wiki_get_page_content | Retrieve wiki page content |
| Wiki | mcp_ado_wiki_create_or_update_page | Create or update a wiki page |
| Work Items | mcp_ado_wit_get_work_item | Get a work item by ID |
| Work Items | mcp_ado_wit_get_work_items_batch_by_ids | Retrieve multiple work items by IDs |
| Work Items | mcp_ado_wit_create_work_item | Create a new work item |
| Work Items | mcp_ado_wit_update_work_item | Update fields of a work item |
| Work Items | mcp_ado_wit_update_work_items_batch | Update multiple work items in batch |
| Work Items | mcp_ado_wit_add_child_work_items | Create child work items under a parent |
| Work Items | mcp_ado_wit_work_items_link | Link work items together |
| Work Items | mcp_ado_wit_work_item_unlink | Remove links from a work item |
| Work Items | mcp_ado_wit_add_artifact_link | Link artifacts (commits, builds, PRs) to work items |
| Work Items | mcp_ado_wit_link_work_item_to_pull_request | Link a work item to a pull request |
| Work Items | mcp_ado_wit_list_work_item_comments | List comments on a work item |
| Work Items | mcp_ado_wit_add_work_item_comment | Add a comment to a work item |
| Work Items | mcp_ado_wit_list_work_item_revisions | Get revision history of a work item |
| Work Items | mcp_ado_wit_get_work_item_type | Get details of a work item type |
| Work Items | mcp_ado_wit_my_work_items | List work items relevant to current user |
| Work Items | mcp_ado_wit_get_work_items_for_iteration | Get work items in a specific iteration |
| Work Items | mcp_ado_wit_list_backlogs | List backlogs for a team |
| Work Items | mcp_ado_wit_list_backlog_work_items | Get work items in a backlog |
| Work Items | mcp_ado_wit_get_query | Get a work item query by ID or path |
| Work Items | mcp_ado_wit_get_query_results_by_id | Execute a query and get results |
| Work | mcp_ado_work_list_iterations | List all iterations in a project |
| Work | mcp_ado_work_create_iterations | Create new iterations in a project |
| Work | mcp_ado_work_list_team_iterations | List iterations assigned to a team |
| Work | mcp_ado_work_assign_iterations | Assign iterations to a team |
| Work | mcp_ado_work_get_iteration_capacities | Get capacity for all teams in an iteration |
| Work | mcp_ado_work_get_team_capacity | Get capacity for a specific team in iteration |
| Work | mcp_ado_work_update_team_capacity | Update team member capacity for iteration |
Retrieve Advanced Security alerts for a repository.
- Required:
project,repository,confidenceLevels - Optional:
alertType,continuationToken,onlyDefaultBranch,orderBy,ref,ruleId,ruleName,severities,states,toolName,top,validity
Get detailed information about a specific Advanced Security alert.
- Required:
project,repository,alertId - Optional:
ref
Retrieve a list of projects in your Azure DevOps organization.
- Required: None
- Optional:
continuationToken,projectNameFilter,skip,stateFilter,top
Retrieve a list of teams for the specified Azure DevOps project.
- Required:
project - Optional:
mine,skip,top
Retrieve Azure DevOps identity IDs for a provided search filter.
- Required:
searchFilter - Optional: None
Creates a pipeline definition with YAML configuration for a given project.
- Required:
project,name,yamlPath,repositoryType,repositoryName - Optional:
folder,repositoryConnectionId,repositoryId
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
Fetches the status of a specific build.
- Required:
project,buildId - Optional: None
Retrieves the logs for a specific build.
- Required:
project,buildId - Optional: None
Get a specific build log by log ID.
- Required:
project,buildId,logId - Optional:
endLine,startLine
Get the changes associated with a specific build.
- Required:
project,buildId - Optional:
continuationToken,includeSourceChange,top
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
Retrieves a list of revisions for a specific build definition.
- Required:
project,definitionId - Optional: None
Starts a new run of a pipeline.
- Required:
project,pipelineId - Optional:
pipelineVersion,previewRun,resources,stagesToSkip,templateParameters,variables,yamlOverride
Gets a run for a particular pipeline.
- Required:
project,pipelineId,runId - Optional: None
Gets top 10000 runs for a particular pipeline.
- Required:
project,pipelineId - Optional: None
Updates the stage of a specific build.
- Required:
project,buildId,stageName,status - Optional:
forceRetryAllJobs
Lists artifacts for a given build.
- Required:
project,buildId
Downloads a pipeline artifact.
- Required:
project,buildId,artifactName - Optional:
destinationPath
Retrieve a list of repositories for a given project.
- Required:
project - Optional:
repoNameFilter,skip,top
Get the repository by project and repository name or ID.
- Required:
project,repositoryNameOrId - Optional: None
Retrieve a list of branches for a given repository.
- Required:
repositoryId - Optional:
filterContains,top
Retrieve a list of my branches for a given repository Id.
- Required:
repositoryId - Optional:
filterContains,top
Get a branch by its name.
- Required:
repositoryId,branchName - Optional: None
Create a new branch in the repository.
- Required:
repositoryId,branchName - Optional:
sourceBranchName,sourceCommitId
Search for commits in a repository with comprehensive filtering capabilities.
- Required:
project,repository - Optional:
author,authorEmail,commitIds,committer,committerEmail,fromCommit,fromDate,historySimplificationMode,includeLinks,includeWorkItems,searchText,skip,toCommit,toDate,top,version,versionType
Retrieve a list of pull requests for a given repository.
- Required: None (either
repositoryIdorprojectmust be provided) - Optional:
created_by_me,created_by_user,i_am_reviewer,project,repositoryId,skip,sourceRefName,status,targetRefName,top,user_is_reviewer
Lists pull requests by commit IDs to find which pull requests contain specific commits.
- Required:
project,repository,commits - Optional:
queryType
Get a pull request by its ID.
- Required:
repositoryId,pullRequestId - Optional:
includeWorkItemRefs
Create a new pull request.
- Required:
repositoryId,sourceRefName,targetRefName,title - Optional:
description,forkSourceRepositoryId,isDraft,labels,workItems
Update a Pull Request by ID with specified fields.
- Required:
repositoryId,pullRequestId - Optional:
autoComplete,bypassReason,deleteSourceBranch,description,isDraft,mergeStrategy,status,targetRefName,title,transitionWorkItems
Add or remove reviewers for an existing pull request.
- Required:
repositoryId,pullRequestId,reviewerIds,action - Optional: None
Retrieve a list of comment threads for a pull request.
- Required:
repositoryId,pullRequestId - Optional:
baseIteration,fullResponse,iteration,project,skip,top
Retrieve a list of comments in a pull request thread.
- Required:
repositoryId,pullRequestId,threadId - Optional:
fullResponse,project,skip,top
Creates a new comment thread on a pull request.
- Required:
repositoryId,pullRequestId,content - Optional:
filePath,project,rightFileEndLine,rightFileEndOffset,rightFileStartLine,rightFileStartOffset,status
Updates an existing comment thread on a pull request.
- Required:
repositoryId,pullRequestId,threadId - Optional:
project,status
Replies to a specific comment on a pull request.
- Required:
repositoryId,pullRequestId,threadId,content - Optional:
fullResponse,project
Search Azure DevOps Repositories for a given search text.
- Required:
searchText - Optional:
branch,includeFacets,path,project,repository,skip,top
Search Azure DevOps Wiki for a given search text.
- Required:
searchText - Optional:
includeFacets,project,skip,top,wiki
Get Azure DevOps Work Item search results for a given search text.
- Required:
searchText - Optional:
areaPath,assignedTo,includeFacets,project,skip,state,top,workItemType
Retrieve a paginated list of test plans from an Azure DevOps project.
- Required:
project - Optional:
continuationToken,filterActivePlans,includePlanDetails
Creates a new test plan in the project.
- Required:
project,name,iteration - Optional:
areaPath,description,endDate,startDate
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
Creates a new test suite in a test plan.
- Required:
project,planId,parentSuiteId,name - Optional: None
Adds existing test cases to a test suite.
- Required:
project,planId,suiteId,testCaseIds - Optional: None
Gets a list of test cases in the test plan.
- Required:
project,planid,suiteid - Optional: None
Creates a new test case work item.
- Required:
project,title - Optional:
areaPath,iterationPath,priority,steps,testsWorkItemId
Update an existing test case work item.
- Required:
id,steps - Optional: None
Gets a list of test results for a given project and build ID.
- Required:
project,buildid - Optional: None
Retrieve a list of wikis for an organization or project.
- Required: None
- Optional:
project
Get the wiki by wikiIdentifier.
- Required:
wikiIdentifier - Optional:
project
Retrieve a list of wiki pages for a specific wiki and project.
- Required:
wikiIdentifier,project - Optional:
continuationToken,pageViewsForDays,top
Retrieve wiki page metadata by path. This tool does not return page content.
- Required:
wikiIdentifier,project,path - Optional:
recursionLevel
Retrieve wiki page content.
- Required: None (either
urlORwikiIdentifierandproject) - Optional:
path,project,url,wikiIdentifier
Create or update a wiki page with content.
- Required:
wikiIdentifier,path,content - Optional:
branch,etag,project
Get a single work item by ID.
- Required:
id,project - Optional:
asOf,expand,fields
Retrieve list of work items by IDs in batch.
- Required:
project,ids - Optional:
fields
Create a new work item in a specified project and work item type.
- Required:
project,workItemType,fields - Optional: None
Update a work item by ID with specified fields.
- Required:
id,updates - Optional: None
Update work items in batch.
- Required:
updates - Optional: None
Create one or many child work items from a parent by work item type and parent id.
- Required:
parentId,project,workItemType,items - Optional: None
Link work items together in batch.
- Required:
project,updates - Optional: None
Remove one or many links from a single work item.
- Required:
project,id - Optional:
type,url
Add artifact links (repository, branch, commit, builds) to work items.
- Required:
workItemId,project - Optional:
artifactUri,branchName,buildId,comment,commitId,linkType,projectId,pullRequestId,repositoryId
Link a single work item to an existing pull request.
- Required:
projectId,repositoryId,pullRequestId,workItemId - Optional:
pullRequestProjectId
Retrieve list of comments for a work item by ID.
- Required:
project,workItemId - Optional:
top
Add comment to a work item by ID.
- Required:
project,workItemId,comment - Optional:
format
Retrieve list of revisions for a work item by ID.
- Required:
project,workItemId - Optional:
expand,skip,top
Get a specific work item type.
- Required:
project,workItemType - Optional: None
Retrieve a list of work items relevant to the authenticated user.
- Required:
project - Optional:
includeCompleted,top,type
Retrieve a list of work items for a specified iteration.
- Required:
project,iterationId - Optional:
team
Receive a list of backlogs for a given project and team.
- Required:
project,team - Optional: None
Retrieve a list of backlogs for a given project, team, and backlog category.
- Required:
project,team,backlogId - Optional: None
Get a query by its ID or path.
- Required:
project,query - Optional:
depth,expand,includeDeleted,useIsoDateFormat
Retrieve the results of a work item query given the query ID.
- Required:
id - Optional:
project,responseType,team,timePrecision,top
List all iterations in a specified Azure DevOps project.
- Required:
project - Optional:
depth,excludedIds
Create new iterations in a specified Azure DevOps project.
- Required:
project,iterations - Optional: None
Retrieve a list of iterations for a specific team in a project.
- Required:
project,team - Optional:
timeframe
Assign existing iterations to a specific team in a project.
- Required:
project,team,iterations - Optional: None
Get an iteration's capacity for all teams in iteration and project.
- Required:
project,iterationId - Optional: None
Get the team capacity of a specific team and iteration in a project.
- Required:
project,team,iterationId - Optional: None
Update the team capacity of a team member for a specific iteration in a project.
- Required:
project,team,teamMemberId,iterationId,activities - Optional:
daysOff