// MCP TOOL REFERENCE

AZURE DEVOPS TOOLS

84 tools from the Azure DevOps MCP Server, categorised by risk level.

View the Azure DevOps policy →
// ALL 84 AZURE DEVOPS TOOLS
READ 55 tools
Read mcp_ado_advsec_get_alert_details Get detailed info about a specific security alert Read mcp_ado_advsec_get_alerts Retrieve Advanced Security alerts for a repository Read mcp_ado_core_get_identity_ids Retrieve identity IDs by search filter Read mcp_ado_core_list_project_teams List teams within a project Read mcp_ado_core_list_projects List all projects in the organisation Read mcp_ado_pipelines_download_artifact Download a pipeline artifact Read mcp_ado_pipelines_get_build_changes Get changes associated with a build Read mcp_ado_pipelines_get_build_definition_revisions Get revision history of a build definition Read mcp_ado_pipelines_get_build_definitions List build/pipeline definitions in a project Read mcp_ado_pipelines_get_build_log Retrieve complete logs for a build Read mcp_ado_pipelines_get_build_log_by_id Get a specific build log by log ID Read mcp_ado_pipelines_get_build_status Get the status of a specific build Read mcp_ado_pipelines_get_builds Retrieve a list of builds with optional filters Read mcp_ado_pipelines_get_run Get details of a specific pipeline run Read mcp_ado_pipelines_list_artifacts List artifacts for a given build Read mcp_ado_pipelines_list_runs List recent runs for a pipeline Read mcp_ado_repo_get_branch_by_name Get details of a specific branch Read mcp_ado_repo_get_pull_request_by_id Get details of a specific pull request Read mcp_ado_repo_get_repo_by_name_or_id Get repository details by name or ID Read mcp_ado_repo_list_branches_by_repo List all branches in a repository Read mcp_ado_repo_list_directory List files and folders in a directory Read mcp_ado_repo_list_my_branches_by_repo List branches created by current user Read mcp_ado_repo_list_pull_request_thread_comments List comments in a specific thread Read mcp_ado_repo_list_pull_request_threads List comment threads on a pull request Read mcp_ado_repo_list_pull_requests_by_commits Find pull requests containing specific commits Read mcp_ado_repo_list_pull_requests_by_repo_or_project List pull requests with optional filters Read mcp_ado_repo_list_repos_by_project List all repositories in a project Read mcp_ado_repo_search_commits Search for commits with comprehensive filters Read mcp_ado_search_code Search for code across repositories Read mcp_ado_search_wiki Search wiki pages by keywords Read mcp_ado_search_workitem Search work items by text and filters Read mcp_ado_testplan_list_test_cases List test cases in a test suite Read mcp_ado_testplan_list_test_plans List test plans in a project Read mcp_ado_testplan_list_test_suites List test suites in a test plan Read mcp_ado_testplan_show_test_results_from_build_id Get test results for a specific build Read mcp_ado_wiki_get_page Get wiki page metadata without content Read mcp_ado_wiki_get_page_content Retrieve wiki page content Read mcp_ado_wiki_get_wiki Get details of a specific wiki Read mcp_ado_wiki_list_pages List pages in a wiki Read mcp_ado_wiki_list_wikis List wikis in organisation or project Read mcp_ado_wit_get_query Get a work item query by ID or path Read mcp_ado_wit_get_query_results_by_id Execute a query and get results Read mcp_ado_wit_get_work_item Get a work item by ID Read mcp_ado_wit_get_work_item_type Get details of a work item type Read mcp_ado_wit_get_work_items_batch_by_ids Retrieve multiple work items by IDs Read mcp_ado_wit_get_work_items_for_iteration Get work items in a specific iteration Read mcp_ado_wit_list_backlog_work_items Get work items in a backlog Read mcp_ado_wit_list_backlogs List backlogs for a team Read mcp_ado_wit_list_work_item_comments List comments on a work item Read mcp_ado_wit_list_work_item_revisions Get revision history of a work item Read mcp_ado_wit_my_work_items List work items relevant to current user Read mcp_ado_work_get_iteration_capacities Get capacity for all teams in an iteration Read mcp_ado_work_get_team_capacity Get capacity for a specific team in iteration Read mcp_ado_work_list_iterations List all iterations in a project Read mcp_ado_work_list_team_iterations List iterations assigned to a team
WRITE 26 tools
Write mcp_ado_pipelines_create_pipeline Create a new pipeline with YAML configuration Write mcp_ado_repo_create_branch Create a new branch from a source branch Write mcp_ado_repo_create_pull_request Create a new pull request Write mcp_ado_repo_create_pull_request_thread Create a new comment thread on a pull request Write mcp_ado_repo_reply_to_comment Reply to a pull request comment Write mcp_ado_repo_update_pull_request Update pull request properties and settings Write mcp_ado_repo_update_pull_request_reviewers Add or remove reviewers from a pull request Write mcp_ado_repo_update_pull_request_thread Update an existing pull request comment thread Write mcp_ado_repo_vote_pull_request Cast a vote on a pull request Write mcp_ado_testplan_add_test_cases_to_suite Add test cases to a test suite Write mcp_ado_testplan_create_test_case Create a new test case work item Write mcp_ado_testplan_create_test_plan Create a new test plan Write mcp_ado_testplan_create_test_suite Create a test suite within a test plan Write mcp_ado_testplan_update_test_case_steps Update steps of an existing test case Write mcp_ado_wiki_create_or_update_page Create or update a wiki page Write mcp_ado_wit_add_artifact_link Link artifacts to work items Write mcp_ado_wit_add_child_work_items Create child work items under a parent Write mcp_ado_wit_add_work_item_comment Add a comment to a work item Write mcp_ado_wit_create_work_item Create a new work item Write mcp_ado_wit_link_work_item_to_pull_request Link a work item to a pull request Write mcp_ado_wit_update_work_item Update fields of a work item Write mcp_ado_wit_update_work_items_batch Update multiple work items in batch Write mcp_ado_wit_work_items_link Link work items together Write mcp_ado_work_assign_iterations Assign iterations to a team Write mcp_ado_work_create_iterations Create new iterations in a project Write mcp_ado_work_update_team_capacity Update team member capacity for iteration
DESTRUCTIVE 1 tools
Destructive mcp_ado_wit_work_item_unlink Remove links from a work item
EXECUTE 2 tools
Execute mcp_ado_pipelines_run_pipeline Start a new pipeline run with optional parameters Execute mcp_ado_pipelines_update_build_stage Update a build stage (cancel, retry, or run)
// RUNNING THIS SERVER

The managed route: connect Azure DevOps through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y @@azure-devops/mcp
// FAQ
How many tools does the Azure DevOps MCP server have? +

The Azure DevOps MCP server exposes 84 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Azure DevOps tools? +

Route the Azure DevOps server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Azure DevOps tools fall into? +

Azure DevOps tools are categorised as Read (55), Write (26), Destructive (1), Execute (2). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.