### Install Dependencies from Source

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/GETTINGSTARTED.md

Run this command in your project directory after cloning the repository to install all necessary dependencies when installing the MCP server from source.

```sh
npm install
```

--------------------------------

### Configure MCP Server with Source Installation

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/GETTINGSTARTED.md

Use this configuration in your `.vscode/mcp.json` file when installing the MCP server from source. It specifies the direct command to run the server executable.

```json
{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps organization's name  (e.g. 'contoso')"
    }
  ],
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "mcp-server-azuredevops",
      "args": ["${input:ado_org}"]
    }
  }
}
```

--------------------------------

### Add Azure DevOps MCP Server with Codex (Interactive)

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/GETTINGSTARTED.md

Start the Azure DevOps MCP Server with Codex using interactive authentication. Replace `Contoso` with your Azure DevOps organization name. This command initiates the setup process.

```bash
codex mcp add azure-devops -- npx -y @azure-devops/mcp Contoso
```

--------------------------------

### Start MCP Server with Environment Variable Authentication

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TROUBLESHOOTING.md

Start the Azure DevOps MCP server using the environment variable authentication method. Ensure the ADO_MCP_AUTH_TOKEN is set.

```bash
npx -y @azure-devops/mcp myorg --authentication envvar
```

--------------------------------

### Read and Update Wiki Page

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

This example demonstrates reading the content of a wiki page, suggesting improvements, and then updating it with revised content.

```text
Get wiki page 'sample-page-name' content. Review and suggest improvements, then update the page with the revised content.
```

--------------------------------

### Check Node.js Version

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TROUBLESHOOTING.md

Verify that you are using Node.js version 20 or higher for dependency installation.

```pwsh
node -v
```

--------------------------------

### Start Azure DevOps MCP Server in Terminal

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/GETTINGSTARTED.md

Run this command in your terminal to start the Azure DevOps MCP Server. Replace `Contoso` with your Azure DevOps organization name.

```bash
npx -y @azure-devops/mcp {Contoso}
```

--------------------------------

### Configure MCP server logging

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/CONTRIBUTING.md

Example configuration for enabling debug logs in an MCP client's mcp.json file.

```json
{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "LOG_LEVEL": "debug"
      }
    }
  }
}
```

--------------------------------

### Start MCP Server with Azure CLI Authentication

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TROUBLESHOOTING.md

Start the Azure DevOps MCP server using Azure CLI authentication. This method leverages your logged-in Azure CLI context.

```bash
npx -y @azure-devops/mcp myorg --authentication azcli
```

--------------------------------

### Start MCP Server with Environment Variable Authentication (Claude Code)

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TROUBLESHOOTING.md

Start the Azure DevOps MCP server using the environment variable authentication method, specifically for Claude Code integration. This command sets the environment variable and then executes the MCP server.

```bash
claude mcp add azure-devops -s user \
  -e ADO_MCP_AUTH_TOKEN="your-azure-devops-pat" \
  -- npx -y @azure-devops/mcp myorg --authentication envvar
```

--------------------------------

### Get List of Pages for Wiki

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

Fetch a list of all pages within a specific wiki in an Azure DevOps project.

```text
Get list of pages for Fabrikam wiki.
```

--------------------------------

### Get Query

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Gets a query by its ID or path. Requires project and query identifier.

```APIDOC
## mcp_ado_wit_get_query

### Description
Get a query by its ID or path.

### Parameters
#### Required
- `project`
- `query`

#### Optional
- `depth`
- `expand`
- `includeDeleted`
- `useIsoDateFormat`
```

--------------------------------

### Link Pull Request to Work Item

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

This example shows how to retrieve pull requests and link the first one to a work item. The tool can construct the artifact URI.

```text
Get me the list of pull requests for Constoso project and Frabrikam repo. Then link the first pull request to work item 12345.
```

--------------------------------

### Get List of Wikis in Project

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

Retrieve a list of all wikis available within a specified Azure DevOps project.

```text
Get list of wikis in project Contoso.
```

--------------------------------

### mcp_ado_wiki_get_wiki

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get the wiki by wikiIdentifier. Requires wikiIdentifier. Optional parameter for project.

```APIDOC
## mcp_ado_wiki_get_wiki

### Description
Get the wiki by wikiIdentifier.

### Parameters
#### Query Parameters
- **wikiIdentifier** (string) - Required - The identifier of the wiki.
- **project** (string) - Optional - The Azure DevOps project.
```

--------------------------------

### mcp_ado_pipelines_run_pipeline

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Starts a new run of a pipeline. Requires project and pipelineId. Optional parameters include pipelineVersion, previewRun, resources, stagesToSkip, templateParameters, variables, and yamlOverride.

```APIDOC
## mcp_ado_pipelines_run_pipeline

### Description
Starts a new run of a pipeline.

### Parameters
#### Required
- **project** (string)
- **pipelineId** (integer)

#### Optional
- **pipelineVersion** (integer)
- **previewRun** (boolean)
- **resources** (object)
- **stagesToSkip** (list of string)
- **templateParameters** (object)
- **variables** (object)
- **yamlOverride** (string)
```

--------------------------------

### mcp_ado_testplan_create_test_plan

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Creates a new test plan in the project. Requires project, name, and iteration. Optional parameters include area path, description, start date, and end date.

```APIDOC
## mcp_ado_testplan_create_test_plan

### Description
Creates a new test plan in the project.

### Parameters
#### Query Parameters
- **project** (string) - Required - The Azure DevOps project.
- **name** (string) - Required - The name of the test plan.
- **iteration** (string) - Required - The iteration path for the test plan.
- **areaPath** (string) - Optional - The area path for the test plan.
- **description** (string) - Optional - A description for the test plan.
- **endDate** (string) - Optional - The end date for the test plan.
- **startDate** (string) - Optional - The start date for the test plan.
```

--------------------------------

### Triage Work Items by Assigning to Iterations

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

This example demonstrates how to retrieve iterations and backlog levels, then triage work items. It includes identifying security-related bugs and high-priority user stories, assigning them to current or next iterations.

```text
list iterations for Contoso team
```

```text
list backlog levels for Contoso team
```

```text
List of work items for Stories backlog. But then go thru and find all the security related bugs. Assign the first 4 to the current iteration. If there are more than four, assign the rest to the next iteration. Then find 2-3 high priority user stories and assign them to the current iteration. Do it!
```

--------------------------------

### Get Team Settings

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Gets team settings, including default iteration, backlog iteration, and default area path for a team. Requires project.

```APIDOC
## mcp_ado_work_get_team_settings

### Description
Get team settings including default iteration, backlog iteration, and default area path for a team.

### Parameters
#### Required
- `project`

#### Optional
- `team`
```

--------------------------------

### mcp_ado_repo_get_repo_by_name_or_id

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get the repository by project and repository name or ID. Requires project and repositoryNameOrId. No optional parameters.

```APIDOC
## mcp_ado_repo_get_repo_by_name_or_id

### Description
Get the repository by project and repository name or ID.

### Parameters
#### Required
- **project** (string)
- **repositoryNameOrId** (string)
```

--------------------------------

### Configure Interactive Authentication for Azure DevOps MCP

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/GETTINGSTARTED.md

Use this configuration for local development or initial setup. It's the default method and opens a browser for login.

```json
{
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "<your-org>"]
    }
  }
}
```

--------------------------------

### mcp_ado_wit_list_backlog_work_items

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get work items in a backlog.

```APIDOC
## mcp_ado_wit_list_backlog_work_items

### Description
Retrieves work items that belong to a specific backlog.

### Method
(Not specified in source, assuming a relevant HTTP method like GET or POST)

### Endpoint
(Not specified in source)

### Parameters
(No specific parameters documented in source)

### Request Example
(No request example provided in source)

### Response
#### Success Response (200)
(No specific response fields documented in source)

#### Response Example
(No response example provided in source)
```

--------------------------------

### Claude API Error Example

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOL-NAME-VALIDATION.md

An example of an API error response received when tool or parameter names do not comply with the Claude API's validation pattern `^[a-zA-Z0-9_.-]{1,64}$`.

```json
API Error: 400
{"type":"error","error":{"type":"invalid_request_error","message":"tools.127.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'"}}
```

--------------------------------

### mcp_ado_wit_get_query_results_by_id

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Execute a query and get results.

```APIDOC
## mcp_ado_wit_get_query_results_by_id

### Description
Executes a pre-defined work item query by its ID and returns the results.

### Method
(Not specified in source, assuming a relevant HTTP method like GET or POST)

### Endpoint
(Not specified in source)

### Parameters
(No specific parameters documented in source)

### Request Example
(No request example provided in source)

### Response
#### Success Response (200)
(No specific response fields documented in source)

#### Response Example
(No response example provided in source)
```

--------------------------------

### mcp_ado_wit_get_query

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get a work item query by ID or path.

```APIDOC
## mcp_ado_wit_get_query

### Description
Fetches a work item query using its unique identifier (ID) or its path within the project.

### Method
(Not specified in source, assuming a relevant HTTP method like GET or POST)

### Endpoint
(Not specified in source)

### Parameters
(No specific parameters documented in source)

### Request Example
(No request example provided in source)

### Response
#### Success Response (200)
(No specific response fields documented in source)

#### Response Example
(No response example provided in source)
```

--------------------------------

### mcp_ado_work_get_team_settings

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get team settings including default iteration and area.

```APIDOC
## mcp_ado_work_get_team_settings

### Description
Retrieves the configuration settings for a team, including their default iteration and area paths.

### Method
(Not specified in source, assuming a relevant HTTP method like GET or POST)

### Endpoint
(Not specified in source)

### Parameters
(No specific parameters documented in source)

### Request Example
(No request example provided in source)

### Response
#### Success Response (200)
(No specific response fields documented in source)

#### Response Example
(No response example provided in source)
```

--------------------------------

### Add MCP Server using GitHub Copilot CLI

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/GETTINGSTARTED.md

Use this command to interactively add the Azure DevOps MCP Server to your GitHub Copilot CLI configuration. Ensure you have the Copilot CLI installed.

```bash
/mcp add
```

--------------------------------

### mcp_ado_wit_get_work_items_for_iteration

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get work items in a specific iteration.

```APIDOC
## mcp_ado_wit_get_work_items_for_iteration

### Description
Retrieves work items associated with a specific iteration within an Azure DevOps project.

### Method
(Not specified in source, assuming a relevant HTTP method like GET or POST)

### Endpoint
(Not specified in source)

### Parameters
(No specific parameters documented in source)

### Request Example
(No request example provided in source)

### Response
#### Success Response (200)
(No specific response fields documented in source)

#### Response Example
(No response example provided in source)
```

--------------------------------

### Get My Work Items

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

Retrieves a list of work items assigned to the current user within a specified project. This command utilizes the `wit_get_work_items_batch_by_ids` tool.

```text
get my work items for project contoso
```

--------------------------------

### Update Work Item Description with Markdown Format

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

Shows how to update a work item's description using Markdown formatting by specifying the `format` parameter. This example uses bulk update functionality.

```text
Update work item 12345 with a new description and use Markdown text. Use Markdown format param. Use bulk update.
```

--------------------------------

### Configure Local MCP Server with Public Feed

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/README.md

Use this JSON configuration in `.vscode/mcp.json` to set up the local MCP server using the public feed. It prompts for the Azure DevOps organization name and specifies the `stdio` server type with the command to install and run the MCP server.

```json
{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps organization name  (e.g. 'contoso')"
    }
  ],
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "${input:ado_org}"]
    }
  }
}
```

--------------------------------

### mcp_ado_testplan_list_test_cases

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Gets a list of test cases in the test plan. Requires project, plan ID, and suite ID. Supports optional continuation token.

```APIDOC
## mcp_ado_testplan_list_test_cases

### Description
Gets a list of test cases in the test plan.

### Parameters
#### Query Parameters
- **project** (string) - Required - The Azure DevOps project.
- **planid** (string) - Required - The ID of the test plan.
- **suiteid** (string) - Required - The ID of the test suite.
- **continuationToken** (string) - Optional - Token to retrieve the next page of results.
```

--------------------------------

### Configure Project and Team Defaults in .vscode/mcp.json

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/README.md

Set default Azure DevOps project and team values in .vscode/mcp.json to skip selection prompts. This example configures the 'ado' server with 'Contoso' project and 'Fabrikam Team'.

```json
{
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "myorg", "--authentication", "azcli"],
      "env": {
        "ado_mcp_project": "Contoso",
        "ado_mcp_team": "Fabrikam Team"
      }
    }
  }
}
```

--------------------------------

### mcp_ado_wit_get_work_item

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get a single work item by ID. Requires ID and project. Optional parameters for as of date, expand, and fields.

```APIDOC
## mcp_ado_wit_get_work_item

### Description
Get a single work item by ID.

### Parameters
#### Query Parameters
- **id** (string) - Required - The ID of the work item.
- **project** (string) - Required - The Azure DevOps project.
- **asOf** (string) - Optional - Retrieves work items from a specific point in time (e.g., '12/15/2023 10:00:00').
- **expand** (string) - Optional - Specifies related data to expand (e.g., 'relations', 'all').
- **fields** (array) - Optional - A list of fields to retrieve for the work item.
```

--------------------------------

### Get File Content

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieves the content of a file from a Git repository at a specific version. Requires repository ID and file path.

```APIDOC
## mcp_ado_repo_get_file_content

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

### Parameters
#### Required
- **repositoryId** (string) - The ID of the repository.
- **path** (string) - The path to the file.

#### Optional
- **project** (string) - The name of the project.
- **version** (string) - The branch, tag, or commit SHA of the file.
- **versionType** (string) - The type of the version (e.g., 'branch', 'tag', 'commit').
```

--------------------------------

### Configure Azure CLI Authentication for Azure DevOps MCP

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/GETTINGSTARTED.md

This method leverages an active Azure CLI login session. Ensure Azure CLI is installed and you are signed in.

```json
{
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "<your-org>", "--authentication", "azcli"]
    }
  }
}
```

--------------------------------

### Get All Work Items in a Backlog

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

Fetches all work items within a specific backlog (e.g., Features, Stories, Epics) for a given project and team. It requires project, team, and backlog context.

```text
get backlogs for Contoso project and Fabrikam team
```

```text
get list of work items for Features backlog
```

--------------------------------

### Get Iteration Capacities

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Gets the iteration capacity for all teams within a specified iteration and project. Requires project and iteration ID.

```APIDOC
## mcp_ado_work_get_iteration_capacities

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

### Parameters
#### Required
- `project`
- `iterationId`
```

--------------------------------

### Configure Copilot Instructions for Azure DevOps

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/HOWTO.md

Add these instructions to .github/copilot-instructions.md to encourage batch processing and specific formatting for work items.

```markdown
## Using MCP Server for Azure DevOps

When getting work items using MCP Server for Azure DevOps, always try to use batch tools for updates instead of many individual single updates. For updates, try and update up to 200 updates in a single batch. When getting work items, once you get the list of IDs, use the tool `get_work_items_batch_by_ids` to get the work item details. By default, show fields ID, Type, Title, State. Show work item results in a rendered markdown table.
```

--------------------------------

### Configure Filtered Domains in mcp.json

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/README.md

Use domains to load specific areas of the Azure DevOps MCP Server toolset. Add the -d argument with domain names to the server args in your mcp.json. This example loads core, work, and work-items domains.

```json
{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps organization name  (e.g. 'contoso')"
    }
  ],
  "servers": {
    "ado_with_filtered_domains": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "${input:ado_org}", "-d", "core", "work", "work-items"]
    }
  }
}
```

--------------------------------

### Get Team Capacity

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Gets the team capacity of a specific team and iteration within a project. Requires project, team, and iteration ID.

```APIDOC
## mcp_ado_work_get_team_capacity

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

### Parameters
#### Required
- `project`
- `team`
- `iterationId`
```

--------------------------------

### Create New Wiki Page

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

Create a new wiki page with specified content. The content can be provided directly in the command.

```text
Create new wiki page called 'how to bake a cake' and add the following content:

<content>
```

--------------------------------

### mcp_ado_testplan_show_test_results_from_build_id

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Gets a list of test results for a given project and build ID. Can filter by test outcome. Returns test case titles, error messages, stack traces, and outcomes. Requires project and build ID.

```APIDOC
## mcp_ado_testplan_show_test_results_from_build_id

### Description
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.

### Parameters
#### Query Parameters
- **project** (string) - Required - The Azure DevOps project.
- **buildid** (string) - Required - The ID of the build.
- **outcomes** (array) - Optional - A list of test outcomes to filter by (e.g., Failed, Passed, Aborted).
```

--------------------------------

### Create and Link Test Cases from User Story

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

This snippet shows how to open a user story, generate test cases with detailed steps based on its description, preview them, and link them back to the original user story in Azure DevOps.

```text
Open work item 1234 in 'Contoso' project. Then look at the description and create 1-3 Test Cases with test steps. But show me a preview first before creating the Test Case in Azure DevOps. Be sure to link the new Test Case to the User Story 1234 when you do.
```

--------------------------------

### mcp_ado_work_get_iteration_capacities

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get capacity for all teams in an iteration.

```APIDOC
## mcp_ado_work_get_iteration_capacities

### Description
Retrieves the capacity information for all teams participating in a given iteration.

### Method
(Not specified in source, assuming a relevant HTTP method like GET or POST)

### Endpoint
(Not specified in source)

### Parameters
(No specific parameters documented in source)

### Request Example
(No request example provided in source)

### Response
#### Success Response (200)
(No specific response fields documented in source)

#### Response Example
(No response example provided in source)
```

--------------------------------

### mcp_ado_wiki_create_or_update_page

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Create or update a wiki page with content. Requires wikiIdentifier, path, and content. Optional parameters for branch, etag, and project.

```APIDOC
## mcp_ado_wiki_create_or_update_page

### Description
Create or update a wiki page with content.

### Parameters
#### Query Parameters
- **wikiIdentifier** (string) - Required - The identifier of the wiki.
- **path** (string) - Required - The path of the wiki page.
- **content** (string) - Required - The content of the wiki page.
- **branch** (string) - Optional - The branch to create or update the page in.
- **etag** (string) - Optional - The ETag of the wiki page for optimistic concurrency.
- **project** (string) - Optional - The Azure DevOps project.
```

--------------------------------

### mcp_ado_work_get_team_capacity

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get capacity for a specific team in iteration.

```APIDOC
## mcp_ado_work_get_team_capacity

### Description
Retrieves the capacity details for a specific team within a given iteration.

### Method
(Not specified in source, assuming a relevant HTTP method like GET or POST)

### Endpoint
(Not specified in source)

### Parameters
(No specific parameters documented in source)

### Request Example
(No request example provided in source)

### Response
#### Success Response (200)
(No specific response fields documented in source)

#### Response Example
(No response example provided in source)
```

--------------------------------

### Run tests via npm

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/CONTRIBUTING.md

Commands for executing the project's test suite using Jest.

```bash
# Run all tests
npm test

# Run specific test file
npm test test/src/utils.test.ts

# Run tests with coverage report
npm test -- --coverage
```

--------------------------------

### mcp_ado_repo_list_repos_by_project

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieve a list of repositories for a given project. Requires the project parameter. Optional parameters include repoNameFilter, skip, and top.

```APIDOC
## mcp_ado_repo_list_repos_by_project

### Description
Retrieve a list of repositories for a given project.

### Parameters
#### Required
- **project** (string)

#### Optional
- **repoNameFilter** (string)
- **skip** (integer)
- **top** (integer)
```

--------------------------------

### Retrieve and Edit Work Items

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

Demonstrates a workflow to retrieve a work item, fetch its comments, update specific fields (like Repro Steps, Story Points, State), and add a new comment. It also covers assigning the work item to a user.

```text
Get work item 12345 and show me fields ID, Type, State, Repro Steps, Story Points, and Priority. Get all comments for the work item and summarize them for me.
```

```text
Polish the Repro Steps with more information and details. Then take that value and update the work item. Also update StoryPoints = 5 and State = Active.
```

```text
Assign this work item to myemail@outlook.com and add a comment "I will own this Bug and get it fixed"
```

--------------------------------

### Configure Local MCP Server with Nightly Builds

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/README.md

This JSON configuration for `.vscode/mcp.json` enables the use of nightly builds for the local MCP server by specifying `@azure-devops/mcp@next`. It includes a prompt for the Azure DevOps organization name and configures the `stdio` server type.

```json
{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps organization name  (e.g. 'contoso')"
    }
  ],
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp@next", "${input:ado_org}"]
    }
  }
}
```

--------------------------------

### mcp_ado_repo_get_branch_by_name

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get a branch by its name. Requires repositoryId and branchName. No optional parameters.

```APIDOC
## mcp_ado_repo_get_branch_by_name

### Description
Get a branch by its name.

### Parameters
#### Required
- **repositoryId** (string)
- **branchName** (string)
```

--------------------------------

### mcp_ado_wit_query_by_wiql

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Execute a WIQL query and return matching work items.

```APIDOC
## mcp_ado_wit_query_by_wiql

### Description
Executes a query written in Work Item Query Language (WIQL) and returns the work items that match the query criteria.

### Method
(Not specified in source, assuming a relevant HTTP method like GET or POST)

### Endpoint
(Not specified in source)

### Parameters
(No specific parameters documented in source)

### Request Example
(No request example provided in source)

### Response
#### Success Response (200)
(No specific response fields documented in source)

#### Response Example
(No response example provided in source)
```

--------------------------------

### mcp_ado_pipelines_get_run

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Gets a run for a particular pipeline. Requires project, pipelineId, and runId. No optional parameters.

```APIDOC
## mcp_ado_pipelines_get_run

### Description
Gets a run for a particular pipeline.

### Parameters
#### Required
- **project** (string)
- **pipelineId** (integer)
- **runId** (integer)
```

--------------------------------

### Clear npm Cache

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TROUBLESHOOTING.md

Use this command to clear the npm cache if you encounter issues with package installations.

```bash
npm cache clean --force
```

--------------------------------

### mcp_ado_testplan_create_test_suite

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Creates a new test suite in a test plan. Requires project, plan ID, parent suite ID, and name. No optional parameters.

```APIDOC
## mcp_ado_testplan_create_test_suite

### Description
Creates a new test suite in a test plan.

### Parameters
#### Query Parameters
- **project** (string) - Required - The Azure DevOps project.
- **planId** (string) - Required - The ID of the test plan.
- **parentSuiteId** (string) - Required - The ID of the parent test suite.
- **name** (string) - Required - The name of the new test suite.
```

--------------------------------

### mcp_ado_pipelines_list_runs

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Gets top 10000 runs for a particular pipeline. Requires project and pipelineId. No optional parameters.

```APIDOC
## mcp_ado_pipelines_list_runs

### Description
Gets top 10000 runs for a particular pipeline.

### Parameters
#### Required
- **project** (string)
- **pipelineId** (integer)
```

--------------------------------

### Azure DevOps Organization Error

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TROUBLESHOOTING.md

Example of the error message returned when the provided organization name is incorrect or inaccessible.

```text
Error fetching projects: Failed to find api location for area: Location id: e81700f7-3be2-46de-8624-2eb35882fcaa
```

--------------------------------

### Authenticate in GitHub Codespaces

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TROUBLESHOOTING.md

Use 'az login' in the terminal for authentication in GitHub Codespaces due to environment limitations.

```sh
az login
```

--------------------------------

### mcp_ado_pipelines_create_pipeline

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Creates a pipeline definition with YAML configuration for a given project. Requires project, name, yamlPath, repositoryType, and repositoryName. Optional parameters include folder, repositoryConnectionId, and repositoryId.

```APIDOC
## mcp_ado_pipelines_create_pipeline

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

### Parameters
#### Required
- **project** (string)
- **name** (string)
- **yamlPath** (string)
- **repositoryType** (string)
- **repositoryName** (string)

#### Optional
- **folder** (string)
- **repositoryConnectionId** (string)
- **repositoryId** (string)
```

--------------------------------

### Get Query Results By ID

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieves the results of a work item query given the query ID. Requires query ID.

```APIDOC
## mcp_ado_wit_get_query_results_by_id

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

### Parameters
#### Required
- `id`

#### Optional
- `project`
- `responseType`
- `team`
- `timePrecision`
- `top`
```

--------------------------------

### mcp_ado_wit_work_items_link

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Link work items together in batch. Requires project and a list of updates. No optional parameters.

```APIDOC
## mcp_ado_wit_work_items_link

### Description
Link work items together in batch.

### Parameters
#### Query Parameters
- **project** (string) - Required - The Azure DevOps project.
- **updates** (array) - Required - An array of objects, each specifying the source and target work items and the link type.
```

--------------------------------

### Get Pull Request by ID

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieves a specific pull request by its ID. Requires repository ID and pull request ID.

```APIDOC
## mcp_ado_repo_get_pull_request_by_id

### Description
Get a pull request by its ID.

### Parameters
#### Required
- **repositoryId** (string) - The ID of the repository.
- **pullRequestId** (integer) - The ID of the pull request.

#### Optional
- **project** (string) - The name of the project.
- **includeWorkItemRefs** (boolean) - Whether to include work item references.
- **includeLabels** (boolean) - Whether to include labels.
- **includeChangedFiles** (boolean) - Whether to include changed files.
```

--------------------------------

### mcp_ado_pipelines_get_build_changes

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get the changes associated with a specific build. Requires project and buildId. Optional parameters include continuationToken and top, and includeSourceChange.

```APIDOC
## mcp_ado_pipelines_get_build_changes

### Description
Get the changes associated with a specific build.

### Parameters
#### Required
- **project** (string)
- **buildId** (integer)

#### Optional
- **continuationToken** (string)
- **includeSourceChange** (boolean)
- **top** (integer)
```

--------------------------------

### mcp_ado_pipelines_get_build_definitions

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieves a list of build definitions for a given project. Requires the project parameter. Numerous optional parameters are available for filtering and controlling the output, including builtAfter, continuationToken, definitionIds, includeAllProperties, includeLatestBuilds, minMetricsTime, name, notBuiltAfter, path, processType, queryOrder, repositoryId, repositoryType, taskIdFilter, top, and yamlFilename.

```APIDOC
## mcp_ado_pipelines_get_build_definitions

### Description
Retrieves a list of build definitions for a given project.

### Parameters
#### Required
- **project** (string)

#### Optional
- **builtAfter** (string)
- **continuationToken** (string)
- **definitionIds** (list of integer)
- **includeAllProperties** (boolean)
- **includeLatestBuilds** (boolean)
- **minMetricsTime** (string)
- **name** (string)
- **notBuiltAfter** (string)
- **path** (string)
- **processType** (integer)
- **queryOrder** (string)
- **repositoryId** (string)
- **repositoryType** (string)
- **taskIdFilter** (string)
- **top** (integer)
- **yamlFilename** (string)
```

--------------------------------

### Configure Kilocode MCP Server for Windows Command Prompt

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/GETTINGSTARTED.md

For Windows users, use this JSON configuration in Kilocode's `mcp_settings.json` or `.kilocode/mcp.json` to correctly wrap the command for the Windows Command Prompt. Replace `<your-org>` with your Azure DevOps organization name.

```json
{
  "mcpServers": {
    "azure-devops": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@azure-devops/mcp", "<your-org>"]
    }
  }
}
```

--------------------------------

### Get Work Items for Iteration

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieves a list of work items for a specified iteration within a project. Requires project and iteration ID.

```APIDOC
## mcp_ado_wit_get_work_items_for_iteration

### Description
Retrieve a list of work items for a specified iteration.

### Parameters
#### Required
- `project`
- `iterationId`

#### Optional
- `team`
```

--------------------------------

### mcp_ado_wiki_list_wikis

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieve a list of wikis for an organization or project. Optional parameter for project.

```APIDOC
## mcp_ado_wiki_list_wikis

### Description
Retrieve a list of wikis for an organization or project.

### Parameters
#### Query Parameters
- **project** (string) - Optional - The Azure DevOps project.
```

--------------------------------

### mcp_ado_pipelines_get_build_log_by_id

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get a specific build log by log ID. Requires project, buildId, and logId. Optional parameters include endLine and startLine.

```APIDOC
## mcp_ado_pipelines_get_build_log_by_id

### Description
Get a specific build log by log ID.

### Parameters
#### Required
- **project** (string)
- **buildId** (integer)
- **logId** (integer)

#### Optional
- **endLine** (integer)
- **startLine** (integer)
```

--------------------------------

### Configure MCP Server

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TROUBLESHOOTING.md

Update the .vscode/mcp.json file to define inputs and server arguments for the Azure DevOps MCP server.

```json
{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps organization name (e.g. 'contoso')"
    },
    {
      "id": "ado_tenant",
      "type": "promptString",
      "description": "Azure tenant ID (required for multi-tenant scenarios)"
    }
  ],
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "${input:ado_org}", "--authentication", "azcli", "--tenant", "${input:ado_tenant}"]
    }
  }
}
```

```json
{
  "inputs": [
    {
      "id": "ado_org",
      "type": "promptString",
      "description": "Azure DevOps organization name (e.g. 'contoso')"
    },
    {
      "id": "ado_tenant",
      "type": "promptString",
      "description": "Azure tenant ID (required for multi-tenant scenarios)"
    }
  ],
  "servers": {
    "ado": {
      "type": "stdio",
      "command": "mcp-server-azuredevops",
      "args": ["${input:ado_org}", "--tenant", "${input:ado_tenant}"]
    }
  }
}
```

--------------------------------

### mcp_ado_advsec_get_alert_details

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Get detailed information about a specific Advanced Security alert. Requires project, repository, and alertId. An optional ref parameter can be provided.

```APIDOC
## mcp_ado_advsec_get_alert_details

### Description
Get detailed information about a specific Advanced Security alert.

### Parameters
#### Required
- **project** (string)
- **repository** (string)
- **alertId** (string)

#### Optional
- **ref** (string)
```

--------------------------------

### Run Build-Time Tool Validation

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOL-NAME-VALIDATION.md

Execute the npm script to validate all tool names and parameter names against Claude API requirements before building.

```bash
npm run validate-tools
```

--------------------------------

### Get List of Azure DevOps Projects

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

Retrieve the list of projects within your Azure DevOps organization. This is often required to establish project context for other commands.

```text
get list of ado projects
```

--------------------------------

### mcp_ado_pipelines_get_builds

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieves a list of builds for a given project. Requires the project parameter. Numerous optional parameters are available for filtering and controlling the output, including branchName, buildIds, buildNumber, continuationToken, definitions, deletedFilter, maxBuildsPerDefinition, maxTime, minTime, properties, queryOrder, queues, reasonFilter, repositoryId, repositoryType, requestedFor, resultFilter, statusFilter, tagFilters, and top.

```APIDOC
## mcp_ado_pipelines_get_builds

### Description
Retrieves a list of builds for a given project.

### Parameters
#### Required
- **project** (string)

#### Optional
- **branchName** (string)
- **buildIds** (list of integer)
- **buildNumber** (string)
- **continuationToken** (string)
- **definitions** (list of integer)
- **deletedFilter** (string)
- **maxBuildsPerDefinition** (integer)
- **maxTime** (string)
- **minTime** (string)
- **properties** (list of string)
- **queryOrder** (string)
- **queues** (list of integer)
- **reasonFilter** (string)
- **repositoryId** (string)
- **repositoryType** (string)
- **requestedFor** (string)
- **resultFilter** (string)
- **statusFilter** (string)
- **tagFilters** (list of string)
- **top** (integer)
```

--------------------------------

### mcp_ado_work_create_iterations

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Create new iterations in a project.

```APIDOC
## mcp_ado_work_create_iterations

### Description
Creates one or more new iterations within an Azure DevOps project.

### Method
(Not specified in source, assuming a relevant HTTP method like POST or PUT)

### Endpoint
(Not specified in source)

### Parameters
(No specific parameters documented in source)

### Request Example
(No request example provided in source)

### Response
#### Success Response (200)
(No specific response fields documented in source)

#### Response Example
(No response example provided in source)
```

--------------------------------

### Get Work Item Attachment

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Downloads a work item attachment by its ID. Optionally saves the file locally if `savePath` is provided. Requires attachment ID.

```APIDOC
## mcp_ado_wit_get_work_item_attachment

### Description
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.

### Parameters
#### Required
- `attachmentId`

#### Optional
- `project`
- `fileName`
- `savePath`
```

--------------------------------

### Get Work Item Type

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieves details for a specific work item type within a project. Requires project and work item type name.

```APIDOC
## mcp_ado_wit_get_work_item_type

### Description
Get a specific work item type.

### Parameters
#### Required
- `project`
- `workItemType`
```

--------------------------------

### mcp_ado_wit_create_work_item

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Create a new work item in a specified project and work item type. Requires project, work item type, and fields. No optional parameters.

```APIDOC
## mcp_ado_wit_create_work_item

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

### Parameters
#### Query Parameters
- **project** (string) - Required - The Azure DevOps project.
- **workItemType** (string) - Required - The type of work item to create (e.g., 'Task', 'Bug').
- **fields** (object) - Required - A JSON object containing the fields and their values for the new work item.
```

--------------------------------

### mcp_ado_wit_get_work_item_attachment

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Download a work item attachment; save locally or return as base64.

```APIDOC
## mcp_ado_wit_get_work_item_attachment

### Description
Downloads an attachment associated with a work item. The attachment can be saved locally or returned as a Base64 encoded string.

### Method
(Not specified in source, assuming a relevant HTTP method like GET or POST)

### Endpoint
(Not specified in source)

### Parameters
(No specific parameters documented in source)

### Request Example
(No request example provided in source)

### Response
#### Success Response (200)
(No specific response fields documented in source)

#### Response Example
(No response example provided in source)
```

--------------------------------

### Configure MCP Server for Opencode

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/GETTINGSTARTED.md

Add this configuration to your Opencode config file (`~/.config/opencode/opencode.json`) to enable the Azure DevOps MCP server. Replace `<your-org>` with your Azure DevOps organization name.

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "azure-devops": {
      "type": "local",
      "command": ["npx", "-y", "@azure-devops/mcp", "<your-org>"],
      "enabled": true
    }
  }
}
```

--------------------------------

### Get List of Teams for a Project

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md

Retrieve a list of teams associated with a specific Azure DevOps project. Ensure your organization and project are correctly configured in the `mcp.json` file.

```text
get list of teams for project contoso
```

--------------------------------

### List Directory

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Lists files and folders within a specified path in a repository. Requires repository ID.

```APIDOC
## mcp_ado_repo_list_directory

### Description
List files and folders in a directory within a repository.

### Parameters
#### Required
- **repositoryId** (string) - The ID of the repository.

#### Optional
- **path** (string) - The path within the repository to list.
- **project** (string) - The name of the project.
- **version** (string) - The branch, tag, or commit SHA to list from.
- **versionType** (string) - The type of the version (e.g., 'branch', 'tag', 'commit').
- **recursive** (boolean) - Whether to list recursively.
- **recursionDepth** (integer) - The depth for recursive listing.
```

--------------------------------

### mcp_ado_search_wiki

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Search Azure DevOps Wiki for a given search text. Supports optional parameters for facets, project, skip, top, and wiki.

```APIDOC
## mcp_ado_search_wiki

### Description
Search Azure DevOps Wiki for a given search text.

### Parameters
#### Query Parameters
- **searchText** (string) - Required - The text to search for.
- **includeFacets** (boolean) - Optional - Whether to include facets in the search results.
- **project** (string) - Optional - The Azure DevOps project.
- **skip** (integer) - Optional - The number of results to skip.
- **top** (integer) - Optional - The maximum number of results to return.
- **wiki** (string) - Optional - The specific wiki to search within.
```

--------------------------------

### mcp_ado_wiki_list_pages

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieve a list of wiki pages for a specific wiki and project. Requires wikiIdentifier and project. Optional parameters for continuation token, page views for days, and top.

```APIDOC
## mcp_ado_wiki_list_pages

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

### Parameters
#### Query Parameters
- **wikiIdentifier** (string) - Required - The identifier of the wiki.
- **project** (string) - Required - The Azure DevOps project.
- **continuationToken** (string) - Optional - Token to retrieve the next page of results.
- **pageViewsForDays** (integer) - Optional - The number of days to retrieve page views for.
- **top** (integer) - Optional - The maximum number of pages to return.
```

--------------------------------

### Verify npm Registry Configuration

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TROUBLESHOOTING.md

Check your npm registry configuration to ensure it points to the official npm registry.

```pwsh
npm config get registry
```

--------------------------------

### Get Pull Request Changes

Source: https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TOOLSET.md

Retrieves the file changes (diff) for a specific pull request iteration, including line-by-line diff content. Requires repository ID and pull request ID.

```APIDOC
## mcp_ado_repo_get_pull_request_changes

### Description
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.

### Parameters
#### Required
- **repositoryId** (string) - The ID of the repository.
- **pullRequestId** (integer) - The ID of the pull request.

#### Optional
- **iterationId** (integer) - The ID of the iteration. If not specified, returns changes for the latest iteration.
- **project** (string) - The name of the project.
- **top** (integer) - The maximum number of changes to return.
- **skip** (integer) - Number of changes to skip.
- **compareTo** (integer) - The iteration ID to compare against. Use to get changes between two specific iterations.
- **includeDiffs** (boolean) - Whether to include diff information. Set to `false` to get only file metadata.
- **includeLineContent** (boolean) - Whether to include actual code lines. Set to `false` to exclude code lines and get only diff metadata.
```