Verfy

MCP servers / @azure-devops/mcp

MCP tool changes

@azure-devops/mcp

4 of its last 4 updates changed what the agent reads: 16 tool descriptions rewritten, up to 2.11.0.

npm package · last recorded on 13 November 2026 on a clean machine with placeholder settings; only tools/list was sent. A changed description is not a vulnerability. npm page · Method and limits · this data as JSON.

Release by release

2.9.0 → 2.11.0

minor release, 22 October 2026

Added: repo_file_write, repo_pull_request_org, wit_work_item_attachment_link, wit_work_item_attachment_upload

advsec_get_alert_details: title, annotations or output schema changed

advsec_get_alerts: title, annotations or output schema changed

core_get_identity_ids: title, annotations or output schema changed

core_list_project_teams: title, annotations or output schema changed

core_list_projects: title, annotations or output schema changed

pipelines_artifact: title, annotations or output schema changed

pipelines_build: input schema changed

pipelines_build_log: title, annotations or output schema changed

pipelines_definition: input schema changed

pipelines_run: title, annotations or output schema changed

pipelines_write: input schema changed

repo_branch: title, annotations or output schema changed

repo_create_branch: title, annotations or output schema changed

repo_file: input schema changed

repo_pull_request: description and input schema changed
Before (2.9.0)
Retrieve pull request data. Use the action parameter to specify the operation.
After (2.11.0)
Retrieve pull request data for a specific repository or project, or retrieve one pull request by ID. For the authenticated user's active pull requests across the entire organization, use repo_pull_request_org.

repo_pull_request_thread: title, annotations or output schema changed

repo_pull_request_thread_write: input schema changed; new arguments: changeTrackingId, commentId, firstComparingIteration, secondComparingIteration

repo_pull_request_write: input schema changed; new arguments: bypassPolicy

repo_repository: title, annotations or output schema changed

repo_search_commits: title, annotations or output schema changed

search_code: title, annotations or output schema changed

search_wiki: description changed
Before (2.9.0)
Search Azure DevOps Wiki for a given search text
After (2.11.0)
Search Azure DevOps Wiki for a given search text. Results include the repository path and a wiki-relative pagePath that can be used with the wiki tool.

search_workitem: title, annotations or output schema changed

testplan: title, annotations or output schema changed

testplan_show_test_results_from_build_id: input schema changed

testplan_test_case_write: title, annotations or output schema changed

testplan_test_plan_write: title, annotations or output schema changed

testplan_test_suite_write: title, annotations or output schema changed

wiki: input schema changed

wiki_upsert_page: title, annotations or output schema changed

wit_backlog: input schema changed; new arguments: ids, iterationId, iterationPath, nextId, parentId, previousId

wit_query: input schema changed

wit_work_item: description and input schema changed; new arguments: continuationToken
Before (2.9.0)
Retrieve work item data for a project. Use the action parameter to specify the operation.
After (2.11.0)
Retrieve work item data. Use the action parameter to specify the operation.

wit_work_item_attachment: input schema changed

wit_work_item_comment_write: title, annotations or output schema changed

wit_work_item_link_write: input schema changed

wit_work_item_write: input schema changed

work: title, annotations or output schema changed

work_capacity_write: title, annotations or output schema changed

work_iteration_write: title, annotations or output schema changed

2.8.1 → 2.9.0

minor release, 29 July 2026

Added: pipelines_artifact, pipelines_build, pipelines_build_log, pipelines_definition, pipelines_run, pipelines_write, repo_branch, repo_file, repo_pull_request, repo_pull_request_thread, repo_pull_request_thread_write, repo_pull_request_write, repo_repository, testplan, testplan_test_case_write, testplan_test_plan_write, testplan_test_suite_write, wiki, wiki_upsert_page, wit_backlog, wit_query, wit_work_item, wit_work_item_attachment, wit_work_item_comment_write, wit_work_item_link_write, wit_work_item_write, work, work_capacity_write, work_iteration_write

Removed: pipelines_create_pipeline, pipelines_download_artifact, pipelines_get_build_changes, pipelines_get_build_definition_revisions, pipelines_get_build_definitions, pipelines_get_build_log, pipelines_get_build_log_by_id, pipelines_get_build_status, pipelines_get_builds, pipelines_get_run, pipelines_list_artifacts, pipelines_list_runs, pipelines_run_pipeline, pipelines_update_build_stage, repo_create_pull_request, repo_create_pull_request_thread, repo_get_branch_by_name, repo_get_file_content, repo_get_pull_request_by_id, repo_get_pull_request_changes, repo_get_repo_by_name_or_id, repo_list_branches_by_repo, repo_list_directory, repo_list_my_branches_by_repo, repo_list_pull_request_thread_comments, repo_list_pull_request_threads, repo_list_pull_requests_by_commits, repo_list_pull_requests_by_repo_or_project, repo_list_repos_by_project, repo_reply_to_comment, repo_update_pull_request, repo_update_pull_request_reviewers, repo_update_pull_request_thread, repo_vote_pull_request, testplan_add_test_cases_to_suite, testplan_create_test_case, testplan_create_test_plan, testplan_create_test_suite, testplan_list_test_cases, testplan_list_test_plans, testplan_list_test_suites, testplan_update_test_case_steps, wiki_create_or_update_page, wiki_get_page, wiki_get_page_content, wiki_get_wiki, wiki_list_pages, wiki_list_wikis, wit_add_artifact_link, wit_add_child_work_items, wit_add_work_item_comment, wit_create_work_item, wit_get_query, wit_get_query_results_by_id, wit_get_work_item, wit_get_work_item_attachment, wit_get_work_item_type, wit_get_work_items_batch_by_ids, wit_get_work_items_for_iteration, wit_link_work_item_to_pull_request, wit_list_backlog_work_items, wit_list_backlogs, wit_list_work_item_comments, wit_list_work_item_revisions, wit_my_work_items, wit_query_by_wiql, wit_update_work_item, wit_update_work_item_comment, wit_update_work_items_batch, wit_work_item_unlink, wit_work_items_link, work_assign_iterations, work_create_iterations, work_get_iteration_capacities, work_get_team_capacity, work_get_team_settings, work_list_iterations, work_list_team_iterations, work_update_team_capacity

advsec_get_alerts: description and input schema changed
Before (2.8.1)
Retrieve Advanced Security alerts for a repository.
After (2.9.0)
Retrieve Advanced Security alerts for a repository. Results are scoped to the specified project and repository. Branch filters (onlyDefaultBranch, ref) apply only to code, dependency, and license alerts; they are not applicable to secret alerts and are ignored by the service, so they neither include nor exclude secrets. To narrow secret alerts by confidence, pass a single 'confidenceLevels' value ('High' or 'Other'); selecting every level is treated as no confidence filter.
repo_search_commits: description and input schema changed
Before (2.8.1)
Search for commits in a repository with comprehensive filtering capabilities. Supports searching by description/comment text, time range, author and more.
After (2.9.0)
Search commits with filtering by text, author, date range, and more.

2.8.0 → 2.8.1

patch release, 14 July 2026

wit_add_artifact_link: input schema changed; new arguments: pageId, pagePath, wikiId

2.7.0 → 2.8.0

minor release, 8 July 2026
pipelines_download_artifact: description and input schema changed
Before (2.7.0)
Downloads a pipeline artifact.
After (2.8.0)
Downloads a pipeline artifact. When destinationPath is provided, it must be a relative local path; absolute paths and path traversal are not allowed.

pipelines_get_build_definitions: input schema changed

repo_create_pull_request_thread: input schema changed

repo_get_branch_by_name: description changed
Before (2.7.0)
Get a branch by its name.
After (2.8.0)
Get a branch by its name. Returns isError: true if the branch is not found.
repo_get_file_content: description changed
Before (2.7.0)
Get the content of a file from a Git repository at a specific version (branch, tag, or commit SHA). Useful for reading source files from PR branches, specific commits, or tags without having them checked out locally.
After (2.8.0)
Get the content of a file from a Git repository at a specific version (branch, tag, or commit SHA). Useful for reading source files from PR branches, specific commits, or tags without having them checked out locally. Returns isError: true if the file is not found.
repo_list_branches_by_repo: description changed
Before (2.7.0)
Retrieve a list of branches for a given repository.
After (2.8.0)
Retrieve a list of branch names for a given repository. Returns an array of branch name strings, not full branch objects. Use repo_get_branch_by_name to get full details for a specific branch.
repo_list_directory: description changed
Before (2.7.0)
List files and folders in a directory within a repository. Useful for exploring the structure of a codebase or finding related files.
After (2.8.0)
List files and folders in a directory within a repository. Useful for exploring the structure of a codebase or finding related files. Returns isError: true if the path is not found.
repo_list_my_branches_by_repo: description changed
Before (2.7.0)
Retrieve a list of my branches for a given repository Id.
After (2.8.0)
Retrieve a list of my branch names for a given repository Id. Returns an array of branch name strings, not full branch objects. Use repo_get_branch_by_name to get full details for a specific branch.
repo_search_commits: description and input schema changed; new arguments: branch, commitEndDate, commitStartDate, includeFacets, orderBy; arguments removed: authorEmail, commitIds, committer, committerEmail, fromCommit, fromDate, historySimplificationMode, includeLinks, includeWorkItems, toCommit, toDate, version, versionType
Before (2.7.0)
Search for commits in a repository with comprehensive filtering capabilities. Supports searching by description/comment text, time range, author, committer, specific commit IDs, and more. This is the unified tool for all commit search operations.
After (2.8.0)
Search for commits in a repository with comprehensive filtering capabilities. Supports searching by description/comment text, time range, author and more.

repo_update_pull_request: input schema changed; new arguments: mergeCommitMessage

wiki_get_page: description changed
Before (2.7.0)
Retrieve wiki page metadata by path. This tool does not return page content.
After (2.8.0)
Retrieve wiki page metadata by path. This tool does not return page content. Returns isError: true if the page is not found.
wiki_get_page_content: description changed
Before (2.7.0)
Retrieve wiki page content. Provide either a 'url' parameter OR the combination of 'wikiIdentifier' and 'project' parameters.
After (2.8.0)
Retrieve wiki page content. Provide either a 'url' parameter OR the combination of 'wikiIdentifier' and 'project' parameters. Returns isError: true if the wiki page is not found.
wit_get_work_item_attachment: description and input schema changed; new arguments: savePath
Before (2.7.0)
Download a work item attachment by its ID and return the content as a base64-encoded resource. Useful for viewing images (e.g. screenshots) attached to work items such as bugs. If a project is not specified, you will be prompted to select one.
After (2.8.0)
Download a work item attachment by its ID. By default returns the content as a base64-encoded resource. If savePath is provided, saves the file locally to that directory and returns the file path instead. Useful for viewing images (e.g. screenshots) or other files attached to work items such as bugs. If a project is not specified, you will be prompted to select one.
wit_my_work_items: description changed
Before (2.7.0)
Retrieve a list of work items relevent to the authenticated user. If a project is not specified, you will be prompted to select one.
After (2.8.0)
Retrieve a list of work items relevant to the authenticated user. If a project is not specified, you will be prompted to select one.

work_list_iterations: input schema changed

Releases tried: 2.7.0 (2026-04-23); 2.8.0 (2026-07-08); 2.8.1 (2026-07-14); 2.9.0 (2026-07-29); 2.10.0 (2026-09-09), did not start; 2.11.0 (2026-10-22).

Tools in 2.11.0

The pin is the SHA-256 of the tool's name, description and input schema, as verfy.lock records it. The same pin in your lock means your agent reads this exact definition. Verfy 0.16.0 and later also pin a tool's title, annotations and output schema when the server sends them, so such a tool shows a different pin in your lock.

Tools in 2.11.0
ToolDescriptionPin
core_list_project_teamsRetrieve a list of teams for an Azure DevOps project. If a project is not specified, you will be prompted to select one.7e0f5956b642
core_list_projectsRetrieve a list of projects in your Azure DevOps organization.0f98d382745b
core_get_identity_idsRetrieve Azure DevOps identity IDs for a provided search filter.0331cb9b9cc2
workRetrieve work-related data for a project or team. Use the action parameter to specify the operation.2e1e9913e103
work_iteration_writeCreate or assign iterations in an Azure DevOps project. Use the action parameter to specify the operation.0c7b846d7815
work_capacity_writeUpdate the team capacity of a team member for a specific iteration in a project.1b700808e972
pipelines_buildRetrieve build data for a project. Use the action parameter to specify the operation.bc928d55362d
pipelines_build_logRetrieve build log data for a project. Use the action parameter to specify the operation.e44fb7a38271
pipelines_definitionRetrieve pipeline definition data for a project. Use the action parameter to specify the operation.ceb7862defbb
pipelines_runRetrieve pipeline run data for a project. Use the action parameter to specify the operation.39fa287158b9
pipelines_artifactRetrieve and download build artifacts. Use the action parameter to specify the operation.323b5603a931
pipelines_writeWrite operations for pipelines and builds. Use the action parameter to specify the operation.2734ac533438
repo_repositoryRetrieve repository data for an organization or project. Use the action parameter to specify the operation.6ea266fcc951
repo_pull_requestRetrieve pull request data for a specific repository or project, or retrieve one pull request by ID. For the authenticated user's active pull requests across the entire organization, use repo_pull_request_org.a6c9b6853051
repo_pull_request_orgList active pull requests across all projects and repositories in the organization for the authenticated user. Use this tool for organization-wide requests such as 'my pull requests' or 'pull requests awaiting my review'. For a specific project, repository, or pull request ID, use repo_pull_request.f2d90c1ea700
repo_pull_request_threadRetrieve pull request thread and comment data. Use the action parameter to specify the operation.beb8c292f048
repo_branchRetrieve branch data for a repository. Use the action parameter to specify the operation.41717f660651
repo_fileRetrieve file data from a repository. Use the action parameter to specify the operation.6477ed47ac45
repo_file_writeCreate or update a text file in an existing repository branch and commit the change.51f52016da6e
repo_search_commitsSearch commits with filtering by text, author, date range, and more.1262846ee057
repo_pull_request_writeWrite operations for pull requests. Use the action parameter to specify the operation.2b99b25c80c9
repo_pull_request_thread_writeWrite operations for pull request comment threads. Use the action parameter to specify the operation.ca66e8da7b7f
repo_create_branchCreate a new branch in the repository.1675b7daa535
wit_work_itemRetrieve work item data. Use the action parameter to specify the operation.241e1291837c
wit_queryRetrieve work item query data for a project. Use the action parameter to specify the operation.701db7c9aab6
wit_backlogRetrieve backlog data for a project and team. Use the action parameter to specify the operation.a105439d307d
wit_work_item_attachmentDownload a work item attachment by its ID. By default returns the content as a base64-encoded resource. If savePath is provided, saves the file locally to that directory and returns the file path instead. Useful for viewing images (e.g. screenshots) or other files attached to work items such as bugs. If a project is not specified, you will be prompted to select one.ef6382da94c4
wit_work_item_attachment_uploadUpload base64-encoded content as a new work item attachment. This tool only uploads the attachment; use wit_work_item_attachment_link separately to link the returned attachment URL to a work item.a2ec8da66cf4
wit_work_item_attachment_linkLink an uploaded attachment to a work item using the attachment URL returned by wit_work_item_attachment_upload.1e1708b1a72e
wit_work_item_writeWrite operations for work items. Use the action parameter to specify the operation.5ccaf643e924
wit_work_item_comment_writeWrite operations for work item comments. Use the action parameter to specify the operation.569f5d7c736b
wit_work_item_link_writeWrite operations for work item links. Use the action parameter to specify the operation.bfe88b14f079
wikiRetrieve wiki data for an organization or project. Use the action parameter to specify the operation.54ac90bc0871
wiki_upsert_pageCreate or update a wiki page with content.5b3db7c23c39
testplanRetrieve paginated test plan, suite, and case data for a project. Use the action parameter to specify the operation. When a response includes a continuationToken, pass it back with the same action and query parameters to fetch the next batch; null token indicates the last batch.cb99abf688bc
testplan_show_test_results_from_build_idGets 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. Efficiently handles builds with large numbers of test runs.e8ccbb963dea
testplan_test_plan_writeWrite operations for test plans. Use the action parameter to specify the operation.225cf4337b6e
testplan_test_suite_writeWrite operations for test suites. Use the action parameter to specify the operation.7b154e1c2841
testplan_test_case_writeWrite operations for test cases. Use the action parameter to specify the operation.cd42b5ead6fc
search_codeSearch Azure DevOps Repositories for a given search text8e44cd6eaa70
search_wikiSearch Azure DevOps Wiki for a given search text. Results include the repository path and a wiki-relative pagePath that can be used with the wiki tool.502cde1eb30e
search_workitemGet Azure DevOps Work Item search results for a given search text051ce9d9719c
advsec_get_alertsRetrieve Advanced Security alerts for a repository. Results are scoped to the specified project and repository. Branch filters (onlyDefaultBranch, ref) apply only to code, dependency, and license alerts; they are not applicable to secret alerts and are ignored by the service, so they neither include nor exclude secrets. To narrow secret alerts by confidence, pass a single 'confidenceLevels' value ('High' or 'Other'); selecting every level is treated as no confidence filter.f5c0650eded6
advsec_get_alert_detailsGet detailed information about a specific Advanced Security alert.c5c5d2cd7722

Lock these tools

Pin what @azure-devops/mcp serves you today, commit the lock, and a pull request fails when a tool changes, with the text before and after. Pin the package version in your MCP config as well.

$ pip install verfy
$ verfy lock check --update   # shows each tool, then writes verfy.lock
$ git add verfy.lock
# .github/workflows/verfy.yml, after actions/checkout
- uses: verfy-dev/verfy-action@v1

Maintain this server? Run the same check on your releases and add the Locked by Verfy badge to your README.