⭐ Azure DevOps On-Premise MCP Server

This project provides a lightweight server to interact with on-premises Azure DevOps, enabling automation, project management, and streamlined workflows.

Forked from web-marketing-hr, which itself is a fork of Microsoft's Azure DevOps MCP

📺 Overview

The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prompts like:

• "List my ADO projects"
• "List ADO Builds for 'MyProjectName'"
• "List ADO Repos for 'MyProjectName'"
• "List test plans for 'MyProjectName'"
• "List teams for project 'MyProjectName'"
• "List iterations for project 'MyProjectName'"
• "List my work items for project 'MyProjectName'"
• "List work items in current iteration for 'MyProjectName' project and 'MyProjectName Team'"
• "List all wikis in the 'MyProjectName' project"
• "Create a wiki page '/Architecture/Overview' with content about system design"
• "Update the wiki page '/Getting Started' with new onboarding instructions"
• "Get the content of the wiki page '/API/Authentication' from the Documentation wiki"

🏆 Expectations

The Azure DevOps MCP Server is built from tools that are concise, simple, focused, and easy to use—each designed for a specific scenario. We intentionally avoid complex tools that try to do too much. The goal is to provide a thin abstraction layer over the REST APIs, making data access straightforward and letting the language model handle complex reasoning.

⚙️ Supported Tools

See TOOLSET.md for a comprehensive list.

🔌 Installation & Getting Started

For the best experience, use Visual Studio Code and GitHub Copilot. See the getting started documentation to use our MCP Server with other tools such as Visual Studio 2022, Claude Code, and Cursor.

Prerequisites

1. Install VS Code or VS Code Insiders
2. Install Node.js 20+
3. Open VS Code in an empty folder

Installation

In your project, add a .vscode\mcp.json file and setup environment varibales with the following content:

{
  "servers": {
    "ado-on-prem-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@lotfihoc/ado-on-prem-mcp", "<your_devops_project_name>", "--authentication", "envvar"],
      "env": {
        "LOG_LEVEL": "info",
        "ADO_MCP_MODE": "onprem",
        "ADO_MCP_AUTH_TYPE": "basic",
        "ADO_MCP_ORG_URL": "https://<on-prem-host>/tfs/<collection_name>",
        "ADO_MCP_API_VERSION": "6.0",
        "ADO_MCP_BATCH_API_VERSION": "6.0",
        "ADO_MCP_MARKDOWN_COMMENTS_API_VERSION": "5.0",
        "NODE_EXTRA_CA_CERTS": "<path_to_cert>",
        "ADO_MCP_AUTH_TOKEN": "<your_ado_pat>"
      }
    }
  }
}

Environment variables

• ADO_MCP_AUTH_TOKEN:
  • DevOps Personal Access Token (PAT)
• ADO_MCP_MODE:
  • Whether Azure DevOps is on-premises or in the cloud
  • "cloud" (default) or "onprem"
• ADO_MCP_AUTH_TYPE
  • DevOps authentication mode
  • "bearer" (default) or "basic"
• ADO_MCP_ORG_URL:
  • Full URL of the on-premises instance, for example: https://my-server/tfs/MyCollection
• ADO_MCP_API_VERSION:
  • Set Azure DevOps API version
  • default: "6.0-preview"
• ADO_MCP_BATCH_API_VERSION:
  • Set Azure DevOps Batch API version
  • default: "6.0-preview"
• ADO_MCP_MARKDOWN_COMMENTS_API_VERSION:
  • Set Azure DevOps Markdown API version
  • default: "5.0"
• NODE_EXTRA_CA_CERTS:
  • Set this variable to your certifcat path if needed
• ADO_MCP_AUTH_TOKEN:
  • Ado PAT

If you are using continue dev on vscode, you can use this config

mcpServers:
  - name: ado-on-prem-mcp
    type: stdio
    command: npx
    args:
      - -y
      - "@lotfihoc/ado-on-prem-mcp"
      - "<your_devops_project_name>"
      - "--authentication"
      - "envvar"
    env:
      LOG_LEVEL: "info"
      ADO_MCP_MODE: "onprem"
      ADO_MCP_AUTH_TYPE: "basic"
      ADO_MCP_ORG_URL: "https://<on-prem-host>/tfs/<collection_name>"
      ADO_MCP_API_VERSION: "6.0"
      ADO_MCP_BATCH_API_VERSION: "6.0"
      ADO_MCP_MARKDOWN_COMMENTS_API_VERSION: "5.0"
      ADO_MCP_AUTH_TOKEN: ${{ secrets.ADO_TOKEN }}
      NODE_EXTRA_CA_CERTS: ${{ secrets.NODE_EXTRA_CA_CERTS }}

It's recommended to set ADO_MCP_AUTH_TOKEN in your terminal or command line. Windows example:

setx ADO_MCP_AUTH_TOKEN "<pat_token>"`

🔥 To stay up to date with the latest features, you can use our nightly builds. Simply update your mcp.json configuration to use @lotfihoc/ado-on-prem-mcp@next. Here is an updated example:

{
  "servers": {
    "ado-on-prem-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@lotfihoc/ado-on-prem-mcp", "<your_devops_project_name>", "--authentication", "envvar"],
      "env": {
        "LOG_LEVEL": "info",
        "ADO_MCP_MODE": "onprem",
        "ADO_MCP_AUTH_TYPE": "basic",
        "ADO_MCP_ORG_URL": "https://<on-prem-host>/tfs/<collection_name>",
        "ADO_MCP_API_VERSION": "6.0",
        "ADO_MCP_BATCH_API_VERSION": "6.0",
        "ADO_MCP_MARKDOWN_COMMENTS_API_VERSION": "5.0",
        "NODE_EXTRA_CA_CERTS": "<path_to_cert>",
        "ADO_MCP_AUTH_TOKEN": "<your_ado_pat>"
      }
    }
  }
}

Save the file, then click 'Start'.

In chat, switch to Agent Mode.

Click "Select Tools" and choose the available tools.

Open GitHub Copilot Chat and try a prompt like List ADO projects. The first time an ADO tool is executed browser will open prompting to login with your Microsoft account. Please ensure you are using credentials matching selected Azure DevOps organization.

💥 We strongly recommend creating a .github\copilot-instructions.md in your project. This will enhance your experience using the Azure DevOps MCP Server with GitHub Copilot Chat. To start, just include "This project uses Azure DevOps. Always check to see if the Azure DevOps MCP server has a tool relevant to the user's request" in your copilot instructions file.

See the getting started documentation to use our MCP Server with other tools such as Visual Studio 2022, Claude Code, and Cursor.

🌏 Using Domains

Azure DevOps exposes a large surface area. As a result, our Azure DevOps MCP Server includes many tools. To keep the toolset manageable, avoid confusing the model, and respect client limits on loaded tools, use Domains to load only the areas you need. Domains are named groups of related tools (for example: core, work, work-items, repositories, wiki). Add the -d argument and the domain names to the server args in your mcp.json to list the domains to enable.

For example, use "-d", "core", "work", "work-items" to load only Work Item related tools (see the example below).

By default all domains are loaded

{
  "servers": {
    "ado-on-prem-mcp-with-filtered-domains": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@lotfihoc/ado-on-prem-mcp", "<your_devops_project_name>", "-d", "core", "work", "work-items", "--authentication", "envvar"],
      "env": {
        "LOG_LEVEL": "info",
        "ADO_MCP_MODE": "onprem",
        "ADO_MCP_AUTH_TYPE": "basic",
        "ADO_MCP_ORG_URL": "https://<on-prem-host>/tfs/<collection_name>",
        "ADO_MCP_API_VERSION": "6.0",
        "ADO_MCP_BATCH_API_VERSION": "6.0",
        "ADO_MCP_MARKDOWN_COMMENTS_API_VERSION": "5.0",
        "NODE_EXTRA_CA_CERTS": "<path_to_cert>",
        "ADO_MCP_AUTH_TOKEN": "<your_ado_pat>"
      }
    }
  }
}

Domains that are available are: core, work, work-items, search, test-plans, repositories, wiki, pipelines, advanced-security

We recommend that you always enable core tools so that you can fetch project level information.

If you are using continiue dev, you can use the following config

mcpServers:
  - name: ado-on-prem-mcp-domains
    type: stdio
    command: npx
    args:
      - -y
      - "@lotfihoc/ado-on-prem-mcp"
      - "<your_devops_project_name>"
      - "-d"
      - "core"
      - "work"
      - "work-items"
      - "--authentication"
      - "envvar"
    env:
      LOG_LEVEL: "info"
      ADO_MCP_MODE: "onprem"
      ADO_MCP_AUTH_TYPE: "basic"
      ADO_MCP_ORG_URL: "https://<on-prem-host>/tfs/<collection_name>"
      ADO_MCP_API_VERSION: "6.0"
      ADO_MCP_BATCH_API_VERSION: "6.0"
      ADO_MCP_MARKDOWN_COMMENTS_API_VERSION: "5.0"
      ADO_MCP_AUTH_TOKEN: ${{ secrets.ADO_TOKEN }}
      NODE_EXTRA_CA_CERTS: ${{ secrets.NODE_EXTRA_CA_CERTS }}

Don't forget to create .env in .continue folder to user secrets

Toolset

The following section provides the list of available tools you can use to interact with Azure Devops On-Premise.

Overview

| 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_reply_to_comment | Reply to a pull request comment | | Repositories | mcp_ado_repo_resolve_comment | Mark a comment thread as resolved | | 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 |

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

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 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

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: includeWorkItemRefs

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_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_reply_to_comment

Replies to a specific comment on a pull request.

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

mcp_ado_repo_resolve_comment

Resolves a specific comment thread on a pull request.

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

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: None

mcp_ado_testplan_create_test_case

Creates a new test case work item.

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

mcp_ado_testplan_update_test_case_steps

Update an existing test case work item.

• 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.

• Required: project, buildid
• Optional: None

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_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

Work

mcp_ado_work_list_iterations

List all iterations in a specified Azure DevOps project.

• Required: project
• Optional: depth, excludedIds

mcp_ado_work_create_iterations

Create new iterations in a specified Azure DevOps project.

• Required: project, iterations
• Optional: None

mcp_ado_work_list_team_iterations

Retrieve a list of iterations for a specific team in a project.

• Required: project, team
• Optional: timeframe

mcp_ado_work_assign_iterations

Assign existing iterations to a specific team in a project.

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

mcp_ado_work_get_iteration_capacities

Get an iteration's capacity for all teams in iteration and project.

• Required: project, iterationId
• Optional: None

mcp_ado_work_get_team_capacity

Get the team capacity of a specific team and iteration in a project.

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

mcp_ado_work_update_team_capacity

Update the team capacity of a team member for a specific iteration in a project.

• Required: project, team, teamMemberId, iterationId, activities
• Optional: daysOff