Core

Projects, teams, and organization-level resources.

3 tools

Read

Get Identity IDs

tool namecore_get_identity_ids

Retrieve Azure DevOps identity IDs for a provided search filter.

Parameters

Parameter	Type	Description
`searchFilter`required	`string`	Search filter (unique name, display name, email) to retrieve identity IDs for.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_get_identity_ids"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "core_get_identity_ids",
    "arguments": {
      "searchFilter": "string"
    }
  }
}

Read

List Project Teams

tool namecore_list_project_teams

Retrieve a list of teams for an Azure DevOps project. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`mine`	`boolean`	If true, only return teams that the authenticated user is a member of.
`top`	`number`	The maximum number of teams to return. Defaults to 100.
`skip`	`number`	The number of teams to skip for pagination. Defaults to 0.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_project_teams"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "core_list_project_teams",
    "arguments": {
      "project": "string",
      "mine": false,
      "top": 0,
      "skip": 0
    }
  }
}

Read

List Projects

tool namecore_list_projects

Retrieve a list of projects in your Azure DevOps organization.

Parameters

Parameter	Type	Description
`stateFilter`	`enum`	Filter projects by their state. Defaults to 'wellFormed'. `allwellFormedcreatePendingdeleted` default: `"wellFormed"`
`top`	`number`	The maximum number of projects to return. Defaults to 100.
`skip`	`number`	The number of projects to skip for pagination. Defaults to 0.
`continuationToken`	`number`	Continuation token for pagination. Used to fetch the next set of results if available.
`projectNameFilter`	`string`	Filter projects by name. Supports partial matches.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "core_list_projects",
    "arguments": {
      "stateFilter": "wellFormed",
      "top": 0,
      "skip": 0,
      "continuationToken": 0,
      "projectNameFilter": "string"
    }
  }
}

Work

Team iterations, backlogs, and boards.

8 tools

Update

Assign Iterations

tool namework_assign_iterations

Assign existing iterations to a specific team in a project.

Parameters

Parameter	Type	Description
`project`required	`string`	The name or ID of the Azure DevOps project.
`team`required	`string`	The name or ID of the Azure DevOps team.
`iterations`required	`array<object>`	An array of iterations to assign. Each iteration must have an identifier and a path.
`identifier`required	`string`	The identifier of the iteration to assign.
`path`required	`string`	The path of the iteration to assign, e.g., 'Project/Iteration'.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "work_assign_iterations"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "work_assign_iterations",
    "arguments": {
      "project": "string",
      "team": "string",
      "iterations": [
        {
          "identifier": "string",
          "path": "string"
        }
      ]
    }
  }
}

Write

Create Iterations

tool namework_create_iterations

Create new iterations in a specified Azure DevOps project.

Parameters

Parameter	Type	Description
`project`required	`string`	The name or ID of the Azure DevOps project.
`iterations`required	`array<object>`	An array of iterations to create. Each iteration must have a name and can optionally have start and finish dates in ISO format.
`iterationName`required	`string`	The name of the iteration to create.
`startDate`	`string`	The start date of the iteration in ISO format (e.g., '2023-01-01T00:00:00Z'). Optional.
`finishDate`	`string`	The finish date of the iteration in ISO format (e.g., '2023-01-31T23:59:59Z'). Optional.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "work_create_iterations"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "work_create_iterations",
    "arguments": {
      "project": "string",
      "iterations": [
        {
          "iterationName": "string",
          "startDate": "string",
          "finishDate": "string"
        }
      ]
    }
  }
}

Read

Get Iteration Capacities

tool namework_get_iteration_capacities

Get an iteration's capacity for all teams in iteration and project. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or Id of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`iterationId`required	`string`	The Iteration Id to get capacity for.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "work_get_iteration_capacities"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "work_get_iteration_capacities",
    "arguments": {
      "iterationId": "string",
      "project": "string"
    }
  }
}

Read

Get Team Capacity

tool namework_get_team_capacity

Get the team capacity of a specific team and iteration in a project. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or Id of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`team`required	`string`	The name or Id of the Azure DevOps team. Reuse from prior context if already known.
`iterationId`required	`string`	The Iteration Id to get capacity for.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "work_get_team_capacity"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "work_get_team_capacity",
    "arguments": {
      "team": "string",
      "iterationId": "string",
      "project": "string"
    }
  }
}

Read

Get Team Settings

tool namework_get_team_settings

Get team settings including default iteration, backlog iteration, and default area path for a team. If a project or team is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`team`	`string`	The name or ID of the Azure DevOps team. Reuse from prior context if already known. If not provided, a team selection prompt will be shown.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "work_get_team_settings"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "work_get_team_settings",
    "arguments": {
      "project": "string",
      "team": "string"
    }
  }
}

Read

List Iterations

tool namework_list_iterations

List all iterations in a specified Azure DevOps project. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`depth`	`number`	Depth of children to fetch. default: `2`
`excludedIds`	`array<number>`	An optional array of iteration IDs, and thier children, that should not be returned.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "work_list_iterations"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "work_list_iterations",
    "arguments": {
      "project": "string",
      "depth": 2,
      "excludedIds": [
        1
      ]
    }
  }
}

Read

List Team Iterations

tool namework_list_team_iterations

Retrieve a list of iterations for a specific team in a project. If a project or team is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`team`	`string`	The name or ID of the Azure DevOps team. Reuse from prior context if already known. If not provided, a team selection prompt will be shown.
`timeframe`	`enum`	The timeframe for which to retrieve iterations. Currently, only 'current' is supported. `current`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "work_list_team_iterations"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "work_list_team_iterations",
    "arguments": {
      "project": "string",
      "team": "string",
      "timeframe": "current"
    }
  }
}

Update

Update Team Capacity

tool namework_update_team_capacity

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

Parameters

Parameter	Type	Description
`project`required	`string`	The name or Id of the Azure DevOps project.
`team`required	`string`	The name or Id of the Azure DevOps team.
`teamMemberId`required	`string`	The team member Id for the specific team member.
`iterationId`required	`string`	The Iteration Id to update the capacity for.
`activities`required	`array<object>`	Array of activities and their daily capacities for the team member.
`name`required	`string`	The name of the activity (e.g., 'Development').
`capacityPerDay`required	`number`	The capacity per day for this activity.
`daysOff`	`array<object>`	Array of days off for the team member, each with a start and end date in ISO format.
`start`required	`string`	Start date of the day off in ISO format.
`end`required	`string`	End date of the day off in ISO format.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "work_update_team_capacity"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "work_update_team_capacity",
    "arguments": {
      "project": "string",
      "team": "string",
      "teamMemberId": "string",
      "iterationId": "string",
      "activities": [
        {
          "name": "string",
          "capacityPerDay": 0
        }
      ],
      "daysOff": [
        {
          "start": "string",
          "end": "string"
        }
      ]
    }
  }
}

Work Items

Create, query, and update work items (Work Item Tracking).

23 tools

Write

Add Artifact Link

tool namewit_add_artifact_link

Add artifact links (repository, branch, commit, builds) to work items. You can either provide the full vstfs URI or the individual components to build it automatically. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`workItemId`required	`number`	The ID of the work item to add the artifact link to.
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`artifactUri`	`string`	The complete VSTFS URI of the artifact to link. If provided, individual component parameters are ignored.
`projectId`	`string`	The project ID (GUID) containing the artifact. Required for Git artifacts when artifactUri is not provided.
`repositoryId`	`string`	The repository ID (GUID) containing the artifact. Required for Git artifacts when artifactUri is not provided.
`branchName`	`string`	The branch name (e.g., 'main'). Required when linkType is 'Branch'.
`commitId`	`string`	The commit SHA hash. Required when linkType is 'Fixed in Commit'.
`pullRequestId`	`number`	The pull request ID. Required when linkType is 'Pull Request'.
`buildId`	`number`	The build ID. Required when linkType is 'Build', 'Found in build', or 'Integrated in build'.
`linkType`	`enum`	Type of artifact link, defaults to 'Branch'. This determines both the link type and how to build the VSTFS URI from individual components. `BranchBuildFixed in ChangesetFixed in CommitFound in buildIntegrated in buildModel LinkPull RequestRelated WorkitemResult AttachmentSource Code FileTagTest ResultWiki` default: `"Branch"`
`comment`	`string`	Comment to include with the artifact link.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_add_artifact_link"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_add_artifact_link",
    "arguments": {
      "workItemId": 1,
      "project": "string",
      "artifactUri": "string",
      "projectId": "string",
      "repositoryId": "string",
      "branchName": "string",
      "commitId": "string",
      "pullRequestId": 1,
      "buildId": 1,
      "linkType": "Branch",
      "comment": "string"
    }
  }
}

Write

Add Child Work Items

tool namewit_add_child_work_items

Create one or many child work items from a parent by work item type and parent id. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`parentId`required	`number`	The ID of the parent work item to create a child work item under.
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`workItemType`required	`string`	The type of the child work item to create.
`items`required	`array<object>`
`title`required	`string`	The title of the child work item.
`description`required	`string`	The description of the child work item.
`format`	`enum`	Format for the description on the child work item, e.g., 'Markdown', 'Html'. Defaults to 'Markdown'. `MarkdownHtml` default: `"Markdown"`
`areaPath`	`string`	Optional area path for the child work item.
`iterationPath`	`string`	Optional iteration path for the child work item.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_add_child_work_items"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_add_child_work_items",
    "arguments": {
      "parentId": 1,
      "workItemType": "string",
      "items": [
        {
          "title": "string",
          "description": "string",
          "format": "Markdown",
          "areaPath": "string",
          "iterationPath": "string"
        }
      ],
      "project": "string"
    }
  }
}

Write

Add Work Item Comment

tool namewit_add_work_item_comment

Add comment to a work item by ID. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`workItemId`required	`number`	The ID of the work item to add a comment to.
`comment`required	`string`	The text of the comment to add to the work item.
`format`	`enum`	The format of the comment text, e.g., 'Markdown', 'Html'. Optional, defaults to 'Markdown'. `MarkdownHtml` default: `"Markdown"`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_add_work_item_comment"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_add_work_item_comment",
    "arguments": {
      "workItemId": 1,
      "comment": "string",
      "project": "string",
      "format": "Markdown"
    }
  }
}

Write

Create Work Item

tool namewit_create_work_item

Create a new work item in a specified project and work item type. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`workItemType`required	`string`	The type of work item to create, e.g., 'Task', 'Bug', etc.
`fields`required	`array<object>`	A record of field names and values to set on the new work item. Each fild is the field name and each value is the corresponding value to set for that field.
`name`required	`string`	The name of the field, e.g., 'System.Title'.
`value`required	`string`	The value of the field.
`format`	`enum`	the format of the field value, e.g., 'Html', 'Markdown'. Optional, defaults to 'Markdown'. `HtmlMarkdown`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_create_work_item"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_create_work_item",
    "arguments": {
      "workItemType": "string",
      "fields": [
        {
          "name": "string",
          "value": "string",
          "format": "Html"
        }
      ],
      "project": "string"
    }
  }
}

Read

Get Query

tool namewit_get_query

Get a query by its ID or path. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`query`required	`string`	The ID or path of the query to retrieve.
`expand`	`enum`	Optional expand parameter to include additional details in the response. Defaults to 'None'. `NoneWiqlClausesAllMinimal`
`depth`	`number`	Optional depth parameter to specify how deep to expand the query. Defaults to 0. default: `0`
`includeDeleted`	`boolean`	Whether to include deleted items in the query results. Defaults to false. default: `false`
`useIsoDateFormat`	`boolean`	Whether to use ISO date format in the response. Defaults to false. default: `false`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_get_query"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_get_query",
    "arguments": {
      "query": "string",
      "project": "string",
      "expand": "None",
      "depth": 0,
      "includeDeleted": false,
      "useIsoDateFormat": false
    }
  }
}

Read

Get Query Results By ID

tool namewit_get_query_results_by_id

Retrieve the results of a work item query given the query ID. Supports full or IDs-only response types.

Parameters

Parameter	Type	Description
`id`required	`string`	The ID of the query to retrieve results for.
`project`	`string`	The name or ID of the Azure DevOps project. If not provided, the default project will be used.
`team`	`string`	The name or ID of the Azure DevOps team. If not provided, the default team will be used.
`timePrecision`	`boolean`	Whether to include time precision in the results. Defaults to false.
`top`	`number`	The maximum number of results to return. Defaults to 50. default: `50`
`responseType`	`enum`	Response type: 'full' returns complete query results (default), 'ids' returns only work item IDs for reduced payload size. `fullids` default: `"full"`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_get_query_results_by_id"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_get_query_results_by_id",
    "arguments": {
      "id": "string",
      "project": "string",
      "team": "string",
      "timePrecision": false,
      "top": 50,
      "responseType": "full"
    }
  }
}

Read

Get Work Item

tool namewit_get_work_item

Get a single work item by ID. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`id`required	`number`	The ID of the work item to retrieve.
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`fields`	`array<string>`	Optional list of fields to include in the response. If not provided, all fields will be returned. Cannot be used together with the expand parameter.
`asOf`	`string`	Optional date string to retrieve the work item as of a specific time. If not provided, the current state will be returned.
`expand`	`enum`	Expand options include 'All', 'Fields', 'Links', 'None', and 'Relations'. Relations can be used to get child workitems. Defaults to 'None'. Cannot be used together with the fields parameter. `allfieldslinksnonerelations`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_get_work_item"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_get_work_item",
    "arguments": {
      "id": 1,
      "project": "string",
      "fields": [
        "string"
      ],
      "asOf": "2024-01-01T00:00:00Z",
      "expand": "all"
    }
  }
}

Read

Get Work Item Attachment

tool namewit_get_work_item_attachment

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.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`attachmentId`required	`string`	The GUID of the attachment. Found in the attachment URL: https://dev.azure.com/{org}/{project}/_apis/wit/attachments/{attachmentId}
`fileName`	`string`	The file name of the attachment, e.g. 'screenshot.png'. Used to determine the MIME type for the returned resource.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_get_work_item_attachment"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_get_work_item_attachment",
    "arguments": {
      "attachmentId": "string",
      "project": "string",
      "fileName": "string"
    }
  }
}

Read

Get Work Item Type

tool namewit_get_work_item_type

Get a specific work item type. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`workItemType`required	`string`	The name of the work item type to retrieve.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_get_work_item_type"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_get_work_item_type",
    "arguments": {
      "workItemType": "string",
      "project": "string"
    }
  }
}

Read

Get Work Items Batch By IDs

tool namewit_get_work_items_batch_by_ids

Retrieve list of work items by IDs in batch. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`ids`required	`array<number>`	The IDs of the work items to retrieve.
`fields`	`array<string>`	Optional list of fields to include in the response. If not provided, a hardcoded default set of fields will be used.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_get_work_items_batch_by_ids"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_get_work_items_batch_by_ids",
    "arguments": {
      "ids": [
        1
      ],
      "project": "string",
      "fields": [
        "string"
      ]
    }
  }
}

Read

Get Work Items For Iteration

tool namewit_get_work_items_for_iteration

Retrieve a list of work items for a specified iteration. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`team`	`string`	The name or ID of the Azure DevOps team. If not provided, the default team will be used.
`iterationId`required	`string`	The ID of the iteration to retrieve work items for.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_get_work_items_for_iteration"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_get_work_items_for_iteration",
    "arguments": {
      "iterationId": "string",
      "project": "string",
      "team": "string"
    }
  }
}

Update

Link Work Item To Pull Request

tool namewit_link_work_item_to_pull_request

Link a single work item to an existing pull request.

Parameters

Parameter	Type	Description
`projectId`required	`string`	The project ID of the Azure DevOps project (note: project name is not valid).
`repositoryId`required	`string`	The ID of the repository containing the pull request. Do not use the repository name here, use the ID instead.
`pullRequestId`required	`number`	The ID of the pull request to link to.
`workItemId`required	`number`	The ID of the work item to link to the pull request.
`pullRequestProjectId`	`string`	The project ID containing the pull request. If not provided, defaults to the work item's project ID (for same-project linking).

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_link_work_item_to_pull_request"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_link_work_item_to_pull_request",
    "arguments": {
      "projectId": "string",
      "repositoryId": "string",
      "pullRequestId": 1,
      "workItemId": 1,
      "pullRequestProjectId": "string"
    }
  }
}

Read

List Backlog Work Items

tool namewit_list_backlog_work_items

Retrieve a list of backlogs of for a given project, team, and backlog category. If a project or team is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`team`	`string`	The name or ID of the Azure DevOps team. Reuse from prior context if already known. If not provided, a team selection prompt will be shown.
`backlogId`required	`string`	The ID of the backlog category to retrieve work items from.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_list_backlog_work_items"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_list_backlog_work_items",
    "arguments": {
      "backlogId": "string",
      "project": "string",
      "team": "string"
    }
  }
}

Read

List Backlogs

tool namewit_list_backlogs

Receive a list of backlogs for a given project and team. If a project or team is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`team`	`string`	The name or ID of the Azure DevOps team. Reuse from prior context if already known. If not provided, a team selection prompt will be shown.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_list_backlogs"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_list_backlogs",
    "arguments": {
      "project": "string",
      "team": "string"
    }
  }
}

Read

List Work Item Comments

tool namewit_list_work_item_comments

Retrieve list of comments for a work item by ID. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`workItemId`required	`number`	The ID of the work item to retrieve comments for.
`top`	`number`	Optional number of comments to retrieve. Defaults to all comments. default: `50`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_list_work_item_comments"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_list_work_item_comments",
    "arguments": {
      "workItemId": 1,
      "project": "string",
      "top": 50
    }
  }
}

Read

List Work Item Revisions

tool namewit_list_work_item_revisions

Retrieve list of revisions for a work item by ID. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`workItemId`required	`number`	The ID of the work item to retrieve revisions for.
`top`	`number`	Optional number of revisions to retrieve. If not provided, all revisions will be returned. default: `50`
`skip`	`number`	Optional number of revisions to skip for pagination. Defaults to 0.
`expand`	`enum`	Optional expand parameter to include additional details. Defaults to 'None'. `NoneRelationsFieldsLinksAll` default: `"None"`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_list_work_item_revisions"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_list_work_item_revisions",
    "arguments": {
      "workItemId": 1,
      "project": "string",
      "top": 50,
      "skip": 0,
      "expand": "None"
    }
  }
}

Read

My Work Items

tool namewit_my_work_items

Retrieve a list of work items relevent to the authenticated user. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`type`	`enum`	The type of work items to retrieve. Defaults to 'assignedtome'. `assignedtomemyactivity` default: `"assignedtome"`
`top`	`number`	The maximum number of work items to return. Defaults to 50. default: `50`
`includeCompleted`	`boolean`	Whether to include completed work items. Defaults to false. default: `false`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_my_work_items"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_my_work_items",
    "arguments": {
      "project": "string",
      "type": "assignedtome",
      "top": 50,
      "includeCompleted": false
    }
  }
}

Read

Query By WIQL

tool namewit_query_by_wiql

Execute a WIQL (Work Item Query Language) query and return the matching work items. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`wiql`required	`string`	The WIQL query string to execute, e.g., "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.TeamProject] = @project"
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`team`	`string`	The name or ID of the Azure DevOps team. If not provided, the default team context will be used.
`timePrecision`	`boolean`	Whether to include time precision in date fields. Defaults to false.
`top`	`number`	The maximum number of results to return. Defaults to 50. default: `50`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_query_by_wiql"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_query_by_wiql",
    "arguments": {
      "wiql": "string",
      "project": "string",
      "team": "string",
      "timePrecision": false,
      "top": 50
    }
  }
}

Update

Update Work Item

tool namewit_update_work_item

Update a work item by ID with specified fields.

Parameters

Parameter	Type	Description
`id`required	`number`	The ID of the work item to update.
`updates`required	`array<object>`	An array of field updates to apply to the work item.
`op`	`string`	The operation to perform on the field. default: `"add"`
`path`required	`string`	The path of the field to update, e.g., '/fields/System.Title'.
`value`required	`string`	The new value for the field. This is required for 'Add' and 'Replace' operations, and should be omitted for 'Remove' operations.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_update_work_item"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_update_work_item",
    "arguments": {
      "id": 1,
      "updates": [
        {
          "path": "string",
          "value": "string",
          "op": "add"
        }
      ]
    }
  }
}

Update

Update Work Item Comment

tool namewit_update_work_item_comment

Update an existing comment on a work item by ID. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`workItemId`required	`number`	The ID of the work item.
`commentId`required	`number`	The ID of the comment to update.
`text`required	`string`	The updated comment text.
`format`	`enum`	The format of the comment text, e.g., 'Markdown', 'Html'. Optional, defaults to 'Markdown'. `MarkdownHtml` default: `"Markdown"`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_update_work_item_comment"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_update_work_item_comment",
    "arguments": {
      "workItemId": 1,
      "commentId": 1,
      "text": "string",
      "project": "string",
      "format": "Markdown"
    }
  }
}

Update

Update Work Items Batch

tool namewit_update_work_items_batch

Update work items in batch

Parameters

Parameter	Type	Description
`updates`required	`array<object>`	An array of updates to apply to work items. Each update should include the operation (op), work item ID (id), field path (path), and new value (value).
`op`	`enum`	The operation to perform on the field. `AddReplaceRemove` default: `"Add"`
`id`required	`number`	The ID of the work item to update.
`path`required	`string`	The path of the field to update, e.g., '/fields/System.Title'.
`value`required	`string`	The new value for the field. This is required for 'add' and 'replace' operations, and should be omitted for 'remove' operations.
`format`	`enum`	The format of the field value. Only to be used for large text fields. e.g., 'Html', 'Markdown'. Optional, defaults to 'Markdown'. `HtmlMarkdown`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_update_work_items_batch"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_update_work_items_batch",
    "arguments": {
      "updates": [
        {
          "id": 1,
          "path": "string",
          "value": "string",
          "op": "Add",
          "format": "Html"
        }
      ]
    }
  }
}

Update

Work Item Unlink

tool namewit_work_item_unlink

Remove one or many links from a single work item. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`id`required	`number`	The ID of the work item to remove the links from.
`type`	`enum`	Type of link to remove. Options include 'parent', 'child', 'duplicate', 'duplicate of', 'related', 'successor', 'predecessor', 'tested by', 'tests', 'affects', 'affected by', and 'artifact'. Defaults to 'related'. `parentchildduplicateduplicate ofrelatedsuccessorpredecessortested bytestsaffectsaffected byartifact` default: `"related"`
`url`	`string`	Optional URL to match for the link to remove. If not provided, all links of the specified type will be removed.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_work_item_unlink"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_work_item_unlink",
    "arguments": {
      "id": 1,
      "project": "string",
      "type": "related",
      "url": "string"
    }
  }
}

Update

Work Items Link

tool namewit_work_items_link

Link work items together in batch. If a project is not specified, you will be prompted to select one.

Parameters

Parameter	Type	Description
`project`	`string`	The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown.
`updates`required	`array<object>`
`id`required	`number`	The ID of the work item to update.
`linkToId`required	`number`	The ID of the work item to link to.
`type`	`enum`	Type of link to create between the work items. Options include 'parent', 'child', 'duplicate', 'duplicate of', 'related', 'successor', 'predecessor', 'tested by', 'tests', 'affects', and 'affected by'. Defaults to 'related'. `parentchildduplicateduplicate ofrelatedsuccessorpredecessortested bytestsaffectsaffected by` default: `"related"`
`comment`	`string`	Optional comment to include with the link. This can be used to provide additional context for the link being created.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wit_work_items_link"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wit_work_items_link",
    "arguments": {
      "updates": [
        {
          "id": 1,
          "linkToId": 1,
          "type": "related",
          "comment": "string"
        }
      ],
      "project": "string"
    }
  }
}

Repositories

Git repositories, branches, pull requests, and commits.

22 tools

Write

Create Branch

tool namerepo_create_branch

Create a new branch in the repository.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the branch will be created. When using a repository name instead of a GUID, the project parameter must also be provided.
`branchName`required	`string`	The name of the new branch to create, e.g., 'feature-branch'.
`sourceBranchName`	`string`	The name of the source branch to create the new branch from. Defaults to 'main'. default: `"main"`
`sourceCommitId`	`string`	The commit ID to create the branch from. If not provided, uses the latest commit of the source branch.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_create_branch"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_create_branch",
    "arguments": {
      "repositoryId": "string",
      "branchName": "string",
      "sourceBranchName": "main",
      "sourceCommitId": "string",
      "project": "string"
    }
  }
}

Write

Create Pull Request

tool namerepo_create_pull_request

Create a new pull request.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the pull request will be created. When using a repository name instead of a GUID, the project parameter must also be provided.
`sourceRefName`required	`string`	The source branch name for the pull request, e.g., 'refs/heads/feature-branch'.
`targetRefName`required	`string`	The target branch name for the pull request, e.g., 'refs/heads/main'.
`title`required	`string`	The title of the pull request.
`description`	`string`	The description of the pull request. Must not be longer than 4000 characters. Optional.
`isDraft`	`boolean`	Indicates whether the pull request is a draft. Defaults to false. default: `false`
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.
`workItems`	`string`	Work item IDs to associate with the pull request, space-separated.
`forkSourceRepositoryId`	`string`	The ID of the fork repository that the pull request originates from. Optional, used when creating a pull request from a fork.
`labels`	`array<string>`	Array of label names to add to the pull request after creation.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_create_pull_request"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_create_pull_request",
    "arguments": {
      "repositoryId": "string",
      "sourceRefName": "string",
      "targetRefName": "string",
      "title": "string",
      "description": "string",
      "isDraft": false,
      "project": "string",
      "workItems": "string",
      "forkSourceRepositoryId": "string",
      "labels": [
        "string"
      ]
    }
  }
}

Write

Create Pull Request Thread

tool namerepo_create_pull_request_thread

Creates a new comment thread on a pull request.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the pull request is located. When using a repository name instead of a GUID, the project parameter must also be provided.
`pullRequestId`required	`number`	The ID of the pull request where the comment thread exists.
`content`required	`string`	The content of the comment to be added.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.
`filePath`	`string`	The path of the file where the comment thread will be created. (optional)
`status`	`enum`	The status of the comment thread. Defaults to 'Active'. `UnknownActiveFixedWontFixClosedByDesignPending` default: `"Active"`
`rightFileStartLine`	`number`	Position of first character of the thread's span in right file. The line number of a thread's position. Starts at 1. (optional)
`rightFileStartOffset`	`number`	Position of first character of the thread's span in right file. The line number of a thread's position. The character offset of a thread's position inside of a line. Starts at 1. Must be set if rightFileStartLine is also specified. (optional)
`rightFileEndLine`	`number`	Position of last character of the thread's span in right file. The line number of a thread's position. Starts at 1. Must be set if rightFileStartLine is also specified. (optional)
`rightFileEndOffset`	`number`	Position of last character of the thread's span in right file. The character offset of a thread's position inside of a line. Must be set if rightFileEndLine is also specified. (optional)

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_create_pull_request_thread"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_create_pull_request_thread",
    "arguments": {
      "repositoryId": "string",
      "pullRequestId": 1,
      "content": "string",
      "project": "string",
      "filePath": "string",
      "status": "Active",
      "rightFileStartLine": 1,
      "rightFileStartOffset": 0,
      "rightFileEndLine": 0,
      "rightFileEndOffset": 0
    }
  }
}

Read

Get Branch By Name

tool namerepo_get_branch_by_name

Get a branch by its name.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the branch is located. When using a repository name instead of a GUID, the project parameter must also be provided.
`branchName`required	`string`	The name of the branch to retrieve, e.g., 'main' or 'feature-branch'.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_get_branch_by_name"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_get_branch_by_name",
    "arguments": {
      "repositoryId": "string",
      "branchName": "string",
      "project": "string"
    }
  }
}

Read

Get File Content

tool namerepo_get_file_content

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.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID (GUID) or name of the repository.
`path`required	`string`	The full path to the file in the repository, e.g., '/src/main.ts' or 'src/main.ts'.
`project`	`string`	Project ID or project name. Required when repositoryId is a name.
`version`	`string`	Version string: branch name (e.g. 'main'), tag name, or commit SHA. Defaults to the repository's default branch if not specified.
`versionType`	`enum`	How to interpret the 'version' parameter. Defaults to 'Commit'. `BranchTagCommit` default: `"Commit"`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_get_file_content"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_get_file_content",
    "arguments": {
      "repositoryId": "string",
      "path": "string",
      "project": "string",
      "version": "string",
      "versionType": "Commit"
    }
  }
}

Read

Get Pull Request By ID

tool namerepo_get_pull_request_by_id

Get a pull request by its ID.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the pull request is located. When using a repository name instead of a GUID, the project parameter must also be provided.
`pullRequestId`required	`number`	The ID of the pull request to retrieve.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.
`includeWorkItemRefs`	`boolean`	Whether to reference work items associated with the pull request. default: `false`
`includeLabels`	`boolean`	Whether to include a summary of labels in the response. default: `false`
`includeChangedFiles`	`boolean`	Whether to include the list of files changed in the pull request. default: `false`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_get_pull_request_by_id"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_get_pull_request_by_id",
    "arguments": {
      "repositoryId": "string",
      "pullRequestId": 1,
      "project": "string",
      "includeWorkItemRefs": false,
      "includeLabels": false,
      "includeChangedFiles": false
    }
  }
}

Read

Get Pull Request Changes

tool namerepo_get_pull_request_changes

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

Parameter	Type	Description
`repositoryId`required	`string`	The ID of the repository where the pull request is located.
`pullRequestId`required	`number`	The ID of the pull request to retrieve changes for.
`iterationId`	`number`	The iteration ID to get changes for. If not specified, gets changes for the latest iteration.
`project`	`string`	Project ID or project name (optional)
`top`	`number`	Maximum number of files to include diffs for. Default is 100.
`skip`	`number`	Number of changes to skip for pagination.
`compareTo`	`number`	Iteration ID to compare against. If specified, returns changes between two iterations.
`includeDiffs`	`boolean`	Whether to include actual line-by-line diff content. Default is true. Set to false to get only file metadata.
`includeLineContent`	`boolean`	Whether to include the actual line content from the changed files. Default is true. When true, fetches file content and includes the actual code lines that were added/removed/modified.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_get_pull_request_changes"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_get_pull_request_changes",
    "arguments": {
      "repositoryId": "string",
      "pullRequestId": 0,
      "iterationId": 0,
      "project": "string",
      "top": 0,
      "skip": 0,
      "compareTo": 0,
      "includeDiffs": false,
      "includeLineContent": false
    }
  }
}

Read

Get Repo By Name Or ID

tool namerepo_get_repo_by_name_or_id

Get the repository by project and repository name or ID.

Parameters

Parameter	Type	Description
`project`required	`string`	Project name or ID where the repository is located.
`repositoryNameOrId`required	`string`	Repository name or ID.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_get_repo_by_name_or_id"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_get_repo_by_name_or_id",
    "arguments": {
      "project": "string",
      "repositoryNameOrId": "string"
    }
  }
}

Read

List Branches By Repo

tool namerepo_list_branches_by_repo

Retrieve a list of branches for a given repository.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the branches are located. When using a repository name instead of a GUID, the project parameter must also be provided.
`top`	`number`	The maximum number of branches to return. Defaults to 100. default: `100`
`filterContains`	`string`	Filter to find branches that contain this string in their name.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_list_branches_by_repo"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_list_branches_by_repo",
    "arguments": {
      "repositoryId": "string",
      "top": 100,
      "filterContains": "string",
      "project": "string"
    }
  }
}

Read

List Directory

tool namerepo_list_directory

List files and folders in a directory within a repository. Useful for exploring the structure of a codebase or finding related files.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository.
`path`	`string`	The directory path to list (e.g., '/src' or '/src/components'). Defaults to repository root. default: `"/"`
`project`	`string`	Project ID or name. Required if repositoryId is a name rather than a GUID.
`version`	`string`	The version identifier - branch name (e.g., 'main'), tag name, or commit SHA. Defaults to the repository's default branch.
`versionType`	`enum`	The type of version identifier: 'Branch', 'Commit', or 'Tag'. Defaults to 'Branch'. `BranchCommitTag` default: `"Branch"`
`recursive`	`boolean`	Whether to list items recursively. Defaults to false. default: `false`
`recursionDepth`	`number`	Maximum depth for recursive listing (1-10). Only applies when recursive is true. Defaults to 1. default: `1`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_list_directory"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_list_directory",
    "arguments": {
      "repositoryId": "string",
      "path": "/",
      "project": "string",
      "version": "string",
      "versionType": "Branch",
      "recursive": false,
      "recursionDepth": 1
    }
  }
}

Read

List My Branches By Repo

tool namerepo_list_my_branches_by_repo

Retrieve a list of my branches for a given repository Id.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the branches are located. When using a repository name instead of a GUID, the project parameter must also be provided.
`top`	`number`	The maximum number of branches to return. default: `100`
`filterContains`	`string`	Filter to find branches that contain this string in their name.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_list_my_branches_by_repo"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_list_my_branches_by_repo",
    "arguments": {
      "repositoryId": "string",
      "top": 100,
      "filterContains": "string",
      "project": "string"
    }
  }
}

Read

List Pull Request Thread Comments

tool namerepo_list_pull_request_thread_comments

Retrieve a list of comments in a pull request thread.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the pull request is located. When using a repository name instead of a GUID, the project parameter must also be provided.
`pullRequestId`required	`number`	The ID of the pull request for which to retrieve thread comments.
`threadId`required	`number`	The ID of the thread for which to retrieve comments.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.
`top`	`number`	The maximum number of comments to return. default: `100`
`skip`	`number`	The number of comments to skip. default: `0`
`fullResponse`	`boolean`	Return full comment JSON response instead of trimmed data. default: `false`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_list_pull_request_thread_comments"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_list_pull_request_thread_comments",
    "arguments": {
      "repositoryId": "string",
      "pullRequestId": 1,
      "threadId": 1,
      "project": "string",
      "top": 100,
      "skip": 0,
      "fullResponse": false
    }
  }
}

Read

List Pull Request Threads

tool namerepo_list_pull_request_threads

Retrieve a list of comment threads for a pull request.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the pull request is located. When using a repository name instead of a GUID, the project parameter must also be provided.
`pullRequestId`required	`number`	The ID of the pull request for which to retrieve threads.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.
`iteration`	`number`	The iteration ID for which to retrieve threads. Optional, defaults to the latest iteration.
`baseIteration`	`number`	The base iteration ID for which to retrieve threads. Optional, defaults to the latest base iteration.
`top`	`number`	The maximum number of threads to return after filtering. default: `100`
`skip`	`number`	The number of threads to skip after filtering. default: `0`
`fullResponse`	`boolean`	Return full thread JSON response instead of trimmed data. default: `false`
`status`	`enum`	Filter threads by status. If not specified, returns threads of all statuses. `UnknownActiveFixedWontFixClosedByDesignPending`
`authorEmail`	`string`	Filter threads by the email of the thread author (first comment author).
`authorDisplayName`	`string`	Filter threads by the display name of the thread author (first comment author). Case-insensitive partial matching.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_list_pull_request_threads"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_list_pull_request_threads",
    "arguments": {
      "repositoryId": "string",
      "pullRequestId": 1,
      "project": "string",
      "iteration": 1,
      "baseIteration": 1,
      "top": 100,
      "skip": 0,
      "fullResponse": false,
      "status": "Unknown",
      "authorEmail": "string",
      "authorDisplayName": "string"
    }
  }
}

Read

List Pull Requests By Commits

tool namerepo_list_pull_requests_by_commits

Lists pull requests by commit IDs to find which pull requests contain specific commits

Parameters

Parameter	Type	Description
`project`required	`string`	Project name or ID
`repository`required	`string`	Repository name or ID
`commits`required	`array<string>`	Array of commit IDs to query for
`queryType`	`enum`	Type of query to perform `NotSetLastMergeCommitCommit` default: `"LastMergeCommit"`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_list_pull_requests_by_commits"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_list_pull_requests_by_commits",
    "arguments": {
      "project": "string",
      "repository": "string",
      "commits": [
        "string"
      ],
      "queryType": "LastMergeCommit"
    }
  }
}

Read

List Pull Requests By Repo Or Project

tool namerepo_list_pull_requests_by_repo_or_project

Retrieve a list of pull requests for a given repository. Either repositoryId or project must be provided.

Parameters

Parameter	Type	Description
`repositoryId`	`string`	The ID or name of the repository where the pull requests are located. When using a repository name instead of a GUID, the project parameter must also be provided.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID, or to scope the search to a specific project.
`top`	`number`	The maximum number of pull requests to return. default: `100`
`skip`	`number`	The number of pull requests to skip. default: `0`
`created_by_me`	`boolean`	Filter pull requests created by the current user. default: `false`
`created_by_user`	`string`	Filter pull requests created by a specific user (provide email or unique name). Takes precedence over created_by_me if both are provided.
`i_am_reviewer`	`boolean`	Filter pull requests where the current user is a reviewer. default: `false`
`user_is_reviewer`	`string`	Filter pull requests where a specific user is a reviewer (provide email or unique name). Takes precedence over i_am_reviewer if both are provided.
`status`	`enum`	Filter pull requests by status. Defaults to 'Active'. `NotSetActiveAbandonedCompletedAll` default: `"Active"`
`sourceRefName`	`string`	Filter pull requests from this source branch (e.g., 'refs/heads/feature-branch').
`targetRefName`	`string`	Filter pull requests into this target branch (e.g., 'refs/heads/main').

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_list_pull_requests_by_repo_or_project"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_list_pull_requests_by_repo_or_project",
    "arguments": {
      "repositoryId": "string",
      "project": "string",
      "top": 100,
      "skip": 0,
      "created_by_me": false,
      "created_by_user": "string",
      "i_am_reviewer": false,
      "user_is_reviewer": "string",
      "status": "Active",
      "sourceRefName": "string",
      "targetRefName": "string"
    }
  }
}

Read

List Repos By Project

tool namerepo_list_repos_by_project

Retrieve a list of repositories for a given project

Parameters

Parameter	Type	Description
`project`required	`string`	The name or ID of the Azure DevOps project.
`top`	`number`	The maximum number of repositories to return. default: `100`
`skip`	`number`	The number of repositories to skip. Defaults to 0. default: `0`
`repoNameFilter`	`string`	Optional filter to search for repositories by name. If provided, only repositories with names containing this string will be returned.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_list_repos_by_project"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_list_repos_by_project",
    "arguments": {
      "project": "string",
      "top": 100,
      "skip": 0,
      "repoNameFilter": "string"
    }
  }
}

Write

Reply To Comment

tool namerepo_reply_to_comment

Replies to a specific comment on a pull request.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the pull request is located. When using a repository name instead of a GUID, the project parameter must also be provided.
`pullRequestId`required	`number`	The ID of the pull request where the comment thread exists.
`threadId`required	`number`	The ID of the thread to which the comment will be added.
`content`required	`string`	The content of the comment to be added.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.
`fullResponse`	`boolean`	Return full comment JSON response instead of a simple confirmation message. default: `false`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_reply_to_comment"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_reply_to_comment",
    "arguments": {
      "repositoryId": "string",
      "pullRequestId": 1,
      "threadId": 1,
      "content": "string",
      "project": "string",
      "fullResponse": false
    }
  }
}

Read

Search Commits

tool namerepo_search_commits

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.

Parameters

Parameter	Type	Description
`project`required	`string`	Project name or ID
`repository`required	`string`	Repository name or ID
`fromCommit`	`string`	Starting commit ID
`toCommit`	`string`	Ending commit ID
`version`	`string`	The name of the branch, tag or commit to filter commits by
`versionType`	`enum`	The meaning of the version parameter, e.g., branch, tag or commit `BranchTagCommit` default: `"Branch"`
`skip`	`number`	Number of commits to skip default: `0`
`top`	`number`	Maximum number of commits to return default: `10`
`includeLinks`	`boolean`	Include commit links default: `false`
`includeWorkItems`	`boolean`	Include associated work items default: `false`
`searchText`	`string`	Search text to filter commits by description/comment. Supports partial matching.
`author`	`string`	Filter commits by author email or display name
`authorEmail`	`string`	Filter commits by exact author email address
`committer`	`string`	Filter commits by committer email or display name
`committerEmail`	`string`	Filter commits by exact committer email address
`fromDate`	`string`	Filter commits from this date (ISO 8601 format, e.g., '2024-01-01T00:00:00Z')
`toDate`	`string`	Filter commits to this date (ISO 8601 format, e.g., '2024-12-31T23:59:59Z')
`commitIds`	`array<string>`	Array of specific commit IDs to retrieve. When provided, other filters are ignored except top/skip.
`historySimplificationMode`	`enum`	How to simplify the commit history `FirstParentSimplifyMergesFullHistoryFullHistorySimplifyMerges`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_search_commits"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_search_commits",
    "arguments": {
      "project": "string",
      "repository": "string",
      "fromCommit": "string",
      "toCommit": "string",
      "version": "string",
      "versionType": "Branch",
      "skip": 0,
      "top": 10,
      "includeLinks": false,
      "includeWorkItems": false,
      "searchText": "string",
      "author": "string",
      "authorEmail": "string",
      "committer": "string",
      "committerEmail": "string",
      "fromDate": "string",
      "toDate": "string",
      "commitIds": [
        "string"
      ],
      "historySimplificationMode": "FirstParent"
    }
  }
}

Update

Update Pull Request

tool namerepo_update_pull_request

Update a Pull Request by ID with specified fields, including setting autocomplete with various completion options.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the pull request exists. When using a repository name instead of a GUID, the project parameter must also be provided.
`pullRequestId`required	`number`	The ID of the pull request to update.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.
`title`	`string`	The new title for the pull request.
`description`	`string`	The new description for the pull request. Must not be longer than 4000 characters.
`isDraft`	`boolean`	Whether the pull request should be a draft.
`targetRefName`	`string`	The new target branch name (e.g., 'refs/heads/main').
`status`	`enum`	The new status of the pull request. Can be 'Active' or 'Abandoned'. `ActiveAbandoned`
`autoComplete`	`boolean`	Set the pull request to autocomplete when all requirements are met.
`mergeStrategy`	`enum`	The merge strategy to use when the pull request autocompletes. Defaults to 'NoFastForward'. `NoFastForwardSquashRebaseRebaseMerge`
`deleteSourceBranch`	`boolean`	Whether to delete the source branch when the pull request autocompletes. Defaults to false. default: `false`
`transitionWorkItems`	`boolean`	Whether to transition associated work items to the next state when the pull request autocompletes. Defaults to true. default: `true`
`bypassReason`	`string`	Reason for bypassing branch policies. When provided, branch policies will be automatically bypassed during autocompletion.
`labels`	`array<string>`	Array of label names to replace existing labels on the pull request. This will remove all current labels and add the specified ones.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_update_pull_request"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_update_pull_request",
    "arguments": {
      "repositoryId": "string",
      "pullRequestId": 1,
      "project": "string",
      "title": "string",
      "description": "string",
      "isDraft": false,
      "targetRefName": "string",
      "status": "Active",
      "autoComplete": false,
      "mergeStrategy": "NoFastForward",
      "deleteSourceBranch": false,
      "transitionWorkItems": true,
      "bypassReason": "string",
      "labels": [
        "string"
      ]
    }
  }
}

Update

Update Pull Request Reviewers

tool namerepo_update_pull_request_reviewers

Add or remove reviewers for an existing pull request.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the pull request exists. When using a repository name instead of a GUID, the project parameter must also be provided.
`pullRequestId`required	`number`	The ID of the pull request to update.
`reviewerIds`required	`array<string>`	List of reviewer ids to add or remove from the pull request.
`action`required	`enum`	Action to perform on the reviewers. Can be 'add' or 'remove'. `addremove`
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_update_pull_request_reviewers"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_update_pull_request_reviewers",
    "arguments": {
      "repositoryId": "string",
      "pullRequestId": 1,
      "reviewerIds": [
        "string"
      ],
      "action": "add",
      "project": "string"
    }
  }
}

Update

Update Pull Request Thread

tool namerepo_update_pull_request_thread

Updates an existing comment thread on a pull request.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository where the pull request is located. When using a repository name instead of a GUID, the project parameter must also be provided.
`pullRequestId`required	`number`	The ID of the pull request where the comment thread exists.
`threadId`required	`number`	The ID of the thread to update.
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.
`status`	`enum`	The new status for the comment thread. `UnknownActiveFixedWontFixClosedByDesignPending`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_update_pull_request_thread"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_update_pull_request_thread",
    "arguments": {
      "repositoryId": "string",
      "pullRequestId": 1,
      "threadId": 1,
      "project": "string",
      "status": "Unknown"
    }
  }
}

Update

Vote Pull Request

tool namerepo_vote_pull_request

Cast a vote on a pull request. Automatically adds the current user as a reviewer if they are not already one.

Parameters

Parameter	Type	Description
`repositoryId`required	`string`	The ID or name of the repository. When using a repository name instead of a GUID, the project parameter must also be provided.
`pullRequestId`required	`number`	The ID of the pull request.
`vote`required	`enum`	The vote to cast: Approved(10), Suggestions(5), None(0), Waiting(-5), Rejected(-10). `ApprovedApprovedWithSuggestionsNoVoteWaitingForAuthorRejected`
`project`	`string`	Project ID or project name. Required when repositoryId is a repository name instead of a GUID.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "repo_vote_pull_request"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "repo_vote_pull_request",
    "arguments": {
      "repositoryId": "string",
      "pullRequestId": 1,
      "vote": "Approved",
      "project": "string"
    }
  }
}

Pipelines

YAML/classic pipelines and pipeline runs.

14 tools

Write

Create Pipeline

tool namepipelines_create_pipeline

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

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to run the build in.
`name`required	`string`	Name of the new pipeline.
`folder`	`string`	Folder path for the new pipeline. Defaults to '\' if not specified.
`yamlPath`required	`string`	The path to the pipeline's YAML file in the repository
`repositoryType`required	`enum`	The type of repository where the pipeline's YAML file is located. `UnknownGitHubAzureReposGitGitHubEnterpriseBitBucketAzureReposGitHyphenated`
`repositoryName`required	`string`	The name of the repository. In case of GitHub repository, this is the full name (:owner/:repo) - e.g. octocat/Hello-World.
`repositoryId`	`string`	The ID of the repository.
`repositoryConnectionId`	`string`	The service connection ID for GitHub repositories. Not required for Azure Repos Git.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_create_pipeline"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_create_pipeline",
    "arguments": {
      "project": "string",
      "name": "string",
      "yamlPath": "string",
      "repositoryType": "Unknown",
      "repositoryName": "string",
      "folder": "string",
      "repositoryId": "string",
      "repositoryConnectionId": "string"
    }
  }
}

Read

Download Artifact

tool namepipelines_download_artifact

Downloads a pipeline artifact.

Parameters

Parameter	Type	Description
`project`required	`string`	The name or ID of the project.
`buildId`required	`number`	The ID of the build.
`artifactName`required	`string`	The name of the artifact to download.
`destinationPath`	`string`	The local path to download the artifact to. If not provided, returns binary content as base64.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_download_artifact"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_download_artifact",
    "arguments": {
      "project": "string",
      "buildId": 1,
      "artifactName": "string",
      "destinationPath": "string"
    }
  }
}

Read

Get Build Changes

tool namepipelines_get_build_changes

Get the changes associated with a specific build.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to get the build changes for
`buildId`required	`number`	ID of the build to get changes for
`continuationToken`	`string`	Continuation token for pagination
`top`	`number`	Number of changes to retrieve, defaults to 100 default: `100`
`includeSourceChange`	`boolean`	Whether to include source changes in the results, defaults to false

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_get_build_changes"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_get_build_changes",
    "arguments": {
      "project": "string",
      "buildId": 1,
      "continuationToken": "string",
      "top": 100,
      "includeSourceChange": false
    }
  }
}

Read

Get Build Definition Revisions

tool namepipelines_get_build_definition_revisions

Retrieves a list of revisions for a specific build definition.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to get the build definition revisions for
`definitionId`required	`number`	ID of the build definition to get revisions for

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_get_build_definition_revisions"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_get_build_definition_revisions",
    "arguments": {
      "project": "string",
      "definitionId": 1
    }
  }
}

Read

Get Build Definitions

tool namepipelines_get_build_definitions

Retrieves a list of build definitions for a given project.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to get build definitions for
`repositoryId`	`string`	Repository ID to filter build definitions
`repositoryType`	`enum`	Type of repository to filter build definitions `TfsGitGitHubBitbucketCloud`
`name`	`string`	Name of the build definition to filter
`path`	`string`	Path of the build definition to filter
`queryOrder`	`enum`	Order in which build definitions are returned `NoneLastModifiedAscendingLastModifiedDescendingDefinitionNameAscendingDefinitionNameDescending`
`top`	`number`	Maximum number of build definitions to return
`continuationToken`	`string`	Token for continuing paged results
`minMetricsTime`	`string`	Minimum metrics time to filter build definitions
`definitionIds`	`array<number>`	Array of build definition IDs to filter
`builtAfter`	`string`	Return definitions that have builds after this date
`notBuiltAfter`	`string`	Return definitions that do not have builds after this date
`includeAllProperties`	`boolean`	Whether to include all properties in the results
`includeLatestBuilds`	`boolean`	Whether to include the latest builds for each definition
`taskIdFilter`	`string`	Task ID to filter build definitions
`processType`	`number`	Process type to filter build definitions
`yamlFilename`	`string`	YAML filename to filter build definitions

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_get_build_definitions"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_get_build_definitions",
    "arguments": {
      "project": "string",
      "repositoryId": "string",
      "repositoryType": "TfsGit",
      "name": "string",
      "path": "string",
      "queryOrder": "None",
      "top": 0,
      "continuationToken": "string",
      "minMetricsTime": "2024-01-01T00:00:00Z",
      "definitionIds": [
        1
      ],
      "builtAfter": "2024-01-01T00:00:00Z",
      "notBuiltAfter": "2024-01-01T00:00:00Z",
      "includeAllProperties": false,
      "includeLatestBuilds": false,
      "taskIdFilter": "string",
      "processType": 0,
      "yamlFilename": "string"
    }
  }
}

Read

Get Build Log

tool namepipelines_get_build_log

Retrieves the logs for a specific build.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to get the build log for
`buildId`required	`number`	ID of the build to get the log for

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_get_build_log"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_get_build_log",
    "arguments": {
      "project": "string",
      "buildId": 1
    }
  }
}

Read

Get Build Log By ID

tool namepipelines_get_build_log_by_id

Get a specific build log by log ID.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to get the build log for
`buildId`required	`number`	ID of the build to get the log for
`logId`required	`number`	ID of the log to retrieve
`startLine`	`number`	Starting line number for the log content, defaults to 0
`endLine`	`number`	Ending line number for the log content, defaults to the end of the log

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_get_build_log_by_id"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_get_build_log_by_id",
    "arguments": {
      "project": "string",
      "buildId": 1,
      "logId": 1,
      "startLine": 0,
      "endLine": 0
    }
  }
}

Read

Get Build Status

tool namepipelines_get_build_status

Fetches the status of a specific build.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to get the build status for
`buildId`required	`number`	ID of the build to get the status for

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_get_build_status"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_get_build_status",
    "arguments": {
      "project": "string",
      "buildId": 1
    }
  }
}

Read

Get Builds

tool namepipelines_get_builds

Retrieves a list of builds for a given project.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to get builds for
`definitions`	`array<number>`	Array of build definition IDs to filter builds
`queues`	`array<number>`	Array of queue IDs to filter builds
`buildNumber`	`string`	Build number to filter builds
`minTime`	`string`	Minimum finish time to filter builds
`maxTime`	`string`	Maximum finish time to filter builds
`requestedFor`	`string`	User ID or name who requested the build
`reasonFilter`	`number`	Reason filter for the build (see BuildReason enum)
`statusFilter`	`number`	Status filter for the build (see BuildStatus enum)
`resultFilter`	`number`	Result filter for the build (see BuildResult enum)
`tagFilters`	`array<string>`	Array of tags to filter builds
`properties`	`array<string>`	Array of property names to include in the results
`top`	`number`	Maximum number of builds to return
`continuationToken`	`string`	Token for continuing paged results
`maxBuildsPerDefinition`	`number`	Maximum number of builds per definition
`deletedFilter`	`number`	Filter for deleted builds (see QueryDeletedOption enum)
`queryOrder`	`enum`	Order in which builds are returned `FinishTimeAscendingFinishTimeDescendingQueueTimeDescendingQueueTimeAscendingStartTimeDescendingStartTimeAscending` default: `"QueueTimeDescending"`
`branchName`	`string`	Branch name to filter builds
`buildIds`	`array<number>`	Array of build IDs to retrieve
`repositoryId`	`string`	Repository ID to filter builds
`repositoryType`	`enum`	Type of repository to filter builds `TfsGitGitHubBitbucketCloud`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_get_builds"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_get_builds",
    "arguments": {
      "project": "string",
      "definitions": [
        1
      ],
      "queues": [
        1
      ],
      "buildNumber": "string",
      "minTime": "2024-01-01T00:00:00Z",
      "maxTime": "2024-01-01T00:00:00Z",
      "requestedFor": "string",
      "reasonFilter": 0,
      "statusFilter": 0,
      "resultFilter": 0,
      "tagFilters": [
        "string"
      ],
      "properties": [
        "string"
      ],
      "top": 0,
      "continuationToken": "string",
      "maxBuildsPerDefinition": 0,
      "deletedFilter": 0,
      "queryOrder": "QueueTimeDescending",
      "branchName": "string",
      "buildIds": [
        1
      ],
      "repositoryId": "string",
      "repositoryType": "TfsGit"
    }
  }
}

Read

Get Run

tool namepipelines_get_run

Gets a run for a particular pipeline.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to run the build in
`pipelineId`required	`number`	ID of the pipeline to run
`runId`required	`number`	ID of the run to get

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_get_run"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_get_run",
    "arguments": {
      "project": "string",
      "pipelineId": 1,
      "runId": 1
    }
  }
}

Read

List Artifacts

tool namepipelines_list_artifacts

Lists artifacts for a given build.

Parameters

Parameter	Type	Description
`project`required	`string`	The name or ID of the project.
`buildId`required	`number`	The ID of the build.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_list_artifacts"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_list_artifacts",
    "arguments": {
      "project": "string",
      "buildId": 1
    }
  }
}

Read

List Runs

tool namepipelines_list_runs

Gets top 10000 runs for a particular pipeline.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to run the build in
`pipelineId`required	`number`	ID of the pipeline to run

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_list_runs"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_list_runs",
    "arguments": {
      "project": "string",
      "pipelineId": 1
    }
  }
}

Write

Run Pipeline

tool namepipelines_run_pipeline

Starts a new run of a pipeline.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to run the build in
`pipelineId`required	`number`	ID of the pipeline to run
`pipelineVersion`	`number`	Version of the pipeline to run. If not provided, the latest version will be used.
`previewRun`	`boolean`	If true, returns the final YAML document after parsing templates without creating a new run.
`resources`	`object`	A dictionary of resources to pass to the pipeline.
`builds`	`object`
`containers`	`object`
`packages`	`object`
`pipelines`required	`object`
`repositories`	`object`
`stagesToSkip`	`array<string>`	A list of stages to skip.
`templateParameters`	`object`	Custom build parameters as key-value pairs
`variables`	`object`	A dictionary of variables to pass to the pipeline.
`yamlOverride`	`string`	YAML override for the pipeline run.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_run_pipeline"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_run_pipeline",
    "arguments": {
      "project": "string",
      "pipelineId": 1,
      "pipelineVersion": 1,
      "previewRun": false,
      "resources": {
        "pipelines": {},
        "builds": {},
        "containers": {},
        "packages": {},
        "repositories": {}
      },
      "stagesToSkip": [
        "string"
      ],
      "templateParameters": {},
      "variables": {},
      "yamlOverride": "string"
    }
  }
}

Update

Update Build Stage

tool namepipelines_update_build_stage

Updates the stage of a specific build.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or name to update the build stage for
`buildId`required	`number`	ID of the build to update
`stageName`required	`string`	Name of the stage to update
`status`required	`enum`	New status for the stage `CancelRetryRun`
`forceRetryAllJobs`	`boolean`	Whether to force retry all jobs in the stage. default: `false`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "pipelines_update_build_stage"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pipelines_update_build_stage",
    "arguments": {
      "project": "string",
      "buildId": 1,
      "stageName": "string",
      "status": "Cancel",
      "forceRetryAllJobs": false
    }
  }
}

Test Plans

Test plans and suites.

9 tools

Write

Add Test Cases To Suite

tool nametestplan_add_test_cases_to_suite

Adds existing test cases to a test suite.

Parameters

Parameter	Type	Description
`project`required	`string`	The unique identifier (ID or name) of the Azure DevOps project.
`planId`required	`number`	The ID of the test plan.
`suiteId`required	`number`	The ID of the test suite.
`testCaseIds`required	`string \| array<string>`	The ID(s) of the test case(s) to add.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "testplan_add_test_cases_to_suite"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testplan_add_test_cases_to_suite",
    "arguments": {
      "project": "string",
      "planId": 1,
      "suiteId": 1,
      "testCaseIds": "string"
    }
  }
}

Write

Create Test Case

tool nametestplan_create_test_case

Creates a new test case work item.

Parameters

Parameter	Type	Description
`project`required	`string`	The unique identifier (ID or name) of the Azure DevOps project.
`title`required	`string`	The title of the test case.
`steps`	`string`	The steps to reproduce the test case. Make sure to format each step as '1. Step one\|Expected result one 2. Step two\|Expected result two. USE '\|' as the delimiter between step and expected result. DO NOT use '\|' in the description of the step or expected result.
`priority`	`number`	The priority of the test case.
`areaPath`	`string`	The area path for the test case.
`iterationPath`	`string`	The iteration path for the test case.
`testsWorkItemId`	`number`	Optional work item id that will be set as a Microsoft.VSTS.Common.TestedBy-Reverse link to the test case.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "testplan_create_test_case"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testplan_create_test_case",
    "arguments": {
      "project": "string",
      "title": "string",
      "steps": "string",
      "priority": 0,
      "areaPath": "string",
      "iterationPath": "string",
      "testsWorkItemId": 1
    }
  }
}

Write

Create Test Plan

tool nametestplan_create_test_plan

Creates a new test plan in the project.

Parameters

Parameter	Type	Description
`project`required	`string`	The unique identifier (ID or name) of the Azure DevOps project where the test plan will be created.
`name`required	`string`	The name of the test plan to be created.
`iteration`required	`string`	The iteration path for the test plan
`description`	`string`	The description of the test plan
`startDate`	`string`	The start date of the test plan
`endDate`	`string`	The end date of the test plan
`areaPath`	`string`	The area path for the test plan

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "testplan_create_test_plan"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testplan_create_test_plan",
    "arguments": {
      "project": "string",
      "name": "string",
      "iteration": "string",
      "description": "string",
      "startDate": "string",
      "endDate": "string",
      "areaPath": "string"
    }
  }
}

Write

Create Test Suite

tool nametestplan_create_test_suite

Creates a new test suite in a test plan.

Parameters

Parameter	Type	Description
`project`required	`string`	Project ID or project name
`planId`required	`number`	ID of the test plan that contains the suites
`parentSuiteId`required	`number`	ID of the parent suite under which the new suite will be created, if not given by user this can be id of a root suite of the test plan
`name`required	`string`	Name of the child test suite

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "testplan_create_test_suite"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testplan_create_test_suite",
    "arguments": {
      "project": "string",
      "planId": 1,
      "parentSuiteId": 1,
      "name": "string"
    }
  }
}

Read

List Test Cases

tool nametestplan_list_test_cases

Gets a list of test cases in the test plan.

Parameters

Parameter	Type	Description
`project`required	`string`	The unique identifier (ID or name) of the Azure DevOps project.
`planid`required	`number`	The ID of the test plan.
`suiteid`required	`number`	The ID of the test suite.
`continuationToken`	`string`	Token to continue fetching test cases from a previous request.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "testplan_list_test_cases"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testplan_list_test_cases",
    "arguments": {
      "project": "string",
      "planid": 1,
      "suiteid": 1,
      "continuationToken": "string"
    }
  }
}

Read

List Test Plans

tool nametestplan_list_test_plans

Retrieve a paginated list of test plans from an Azure DevOps project. Allows filtering for active plans and toggling detailed information.

Parameters

Parameter	Type	Description
`project`required	`string`	The unique identifier (ID or name) of the Azure DevOps project.
`filterActivePlans`	`boolean`	Filter to include only active test plans. Defaults to true. default: `true`
`includePlanDetails`	`boolean`	Include detailed information about each test plan. default: `false`
`continuationToken`	`string`	Token to continue fetching test plans from a previous request.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "testplan_list_test_plans"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testplan_list_test_plans",
    "arguments": {
      "project": "string",
      "filterActivePlans": true,
      "includePlanDetails": false,
      "continuationToken": "string"
    }
  }
}

Read

List Test Suites

tool nametestplan_list_test_suites

Retrieve a paginated list of test suites from an Azure DevOps project and Test Plan Id.

Parameters

Parameter	Type	Description
`project`required	`string`	The unique identifier (ID or name) of the Azure DevOps project.
`planId`required	`number`	The ID of the test plan.
`continuationToken`	`string`	Token to continue fetching test plans from a previous request.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "testplan_list_test_suites"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testplan_list_test_suites",
    "arguments": {
      "project": "string",
      "planId": 1,
      "continuationToken": "string"
    }
  }
}

Read

Show Test Results From Build ID

tool nametestplan_show_test_results_from_build_id

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. Efficiently handles builds with large numbers of test runs.

Parameters

Parameter	Type	Description
`project`required	`string`	The unique identifier (ID or name) of the Azure DevOps project.
`buildid`required	`number`	The ID of the build.
`outcomes`	`array<string>`	Filter results by test outcome, e.g. ['Failed', 'Passed', 'Aborted'].

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "testplan_show_test_results_from_build_id"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testplan_show_test_results_from_build_id",
    "arguments": {
      "project": "string",
      "buildid": 1,
      "outcomes": [
        "string"
      ]
    }
  }
}

Update

Update Test Case Steps

tool nametestplan_update_test_case_steps

Update an existing test case work item.

Parameters

Parameter	Type	Description
`id`required	`number`	The ID of the test case work item to update.
`steps`required	`string`	The steps to reproduce the test case. Make sure to format each step as '1. Step one\|Expected result one 2. Step two\|Expected result two. USE '\|' as the delimiter between step and expected result. DO NOT use '\|' in the description of the step or expected result.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "testplan_update_test_case_steps"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testplan_update_test_case_steps",
    "arguments": {
      "id": 1,
      "steps": "string"
    }
  }
}

Wiki

Project wikis and wiki pages.

6 tools

Write

Create Or Update Page

tool namewiki_create_or_update_page

Create or update a wiki page with content.

Parameters

Parameter	Type	Description
`wikiIdentifier`required	`string`	The unique identifier or name of the wiki.
`path`required	`string`	The path of the wiki page (e.g., '/Home' or '/Documentation/Setup').
`content`required	`string`	The content of the wiki page in markdown format.
`project`	`string`	The project name or ID where the wiki is located. If not provided, the default project will be used.
`etag`	`string`	ETag for editing existing pages (optional, will be fetched if not provided).
`branch`	`string`	The branch name for the wiki repository. Defaults to 'wikiMaster' which is the default branch for Azure DevOps wikis. default: `"wikiMaster"`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wiki_create_or_update_page"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wiki_create_or_update_page",
    "arguments": {
      "wikiIdentifier": "string",
      "path": "string",
      "content": "string",
      "project": "string",
      "etag": "string",
      "branch": "wikiMaster"
    }
  }
}

Read

Get Page

tool namewiki_get_page

Retrieve wiki page metadata by path. This tool does not return page content.

Parameters

Parameter	Type	Description
`wikiIdentifier`required	`string`	The unique identifier of the wiki.
`project`required	`string`	The project name or ID where the wiki is located.
`path`required	`string`	The path of the wiki page (e.g., '/Home' or '/Documentation/Setup').
`recursionLevel`	`enum`	Recursion level for subpages. 'None' returns only the specified page. 'OneLevel' includes direct children. 'Full' includes all descendants. `NoneOneLevelOneLevelPlusNestedEmptyFoldersFull`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wiki_get_page"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wiki_get_page",
    "arguments": {
      "wikiIdentifier": "string",
      "project": "string",
      "path": "string",
      "recursionLevel": "None"
    }
  }
}

Read

Get Page Content

tool namewiki_get_page_content

Retrieve wiki page content. Provide either a 'url' parameter OR the combination of 'wikiIdentifier' and 'project' parameters.

Parameters

Parameter	Type	Description
`url`	`string`	The full URL of the wiki page to retrieve content for. If provided, wikiIdentifier, project, and path are ignored. Supported patterns: https://dev.azure.com/{org}/{project}/_wiki/wikis/{wikiIdentifier}?pagePath=%2FMy%20Page and https://dev.azure.com/{org}/{project}/_wiki/wikis/{wikiIdentifier}/{pageId}/Page-Title
`wikiIdentifier`	`string`	The unique identifier of the wiki. Required if url is not provided.
`project`	`string`	The project name or ID where the wiki is located. Required if url is not provided.
`path`	`string`	The path of the wiki page to retrieve content for. Optional, defaults to root page if not provided.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wiki_get_page_content"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wiki_get_page_content",
    "arguments": {
      "url": "string",
      "wikiIdentifier": "string",
      "project": "string",
      "path": "string"
    }
  }
}

Read

Get Wiki

tool namewiki_get_wiki

Get the wiki by wikiIdentifier

Parameters

Parameter	Type	Description
`wikiIdentifier`required	`string`	The unique identifier of the wiki.
`project`	`string`	The project name or ID where the wiki is located. If not provided, the default project will be used.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wiki_get_wiki"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wiki_get_wiki",
    "arguments": {
      "wikiIdentifier": "string",
      "project": "string"
    }
  }
}

Read

List Pages

tool namewiki_list_pages

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

Parameters

Parameter	Type	Description
`wikiIdentifier`required	`string`	The unique identifier of the wiki.
`project`required	`string`	The project name or ID where the wiki is located.
`top`	`number`	The maximum number of pages to return. Defaults to 20. default: `20`
`continuationToken`	`string`	Token for pagination to retrieve the next set of pages.
`pageViewsForDays`	`number`	Number of days to retrieve page views for. If not specified, page views are not included.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wiki_list_pages"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wiki_list_pages",
    "arguments": {
      "wikiIdentifier": "string",
      "project": "string",
      "top": 20,
      "continuationToken": "string",
      "pageViewsForDays": 0
    }
  }
}

Read

List Wikis

tool namewiki_list_wikis

Retrieve a list of wikis for an organization or project.

Parameters

Parameter	Type	Description
`project`	`string`	The project name or ID to filter wikis. If not provided, all wikis in the organization will be returned.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "wiki_list_wikis"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "wiki_list_wikis",
    "arguments": {
      "project": "string"
    }
  }
}

Search

Code, work item, and wiki search.

3 tools

Read

Code

tool namesearch_code

Search Azure DevOps Repositories for a given search text

Parameters

Parameter	Type	Description
`searchText`required	`string`	Keywords to search for in code repositories
`project`	`string \| array<string>`	Filter by projects
`repository`	`array<string>`	Filter by repositories
`path`	`array<string>`	Filter by paths
`branch`	`array<string>`	Filter by branches
`includeFacets`	`boolean`	Include facets in the search results default: `false`
`skip`	`number`	Number of results to skip default: `0`
`top`	`number`	Maximum number of results to return default: `5`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "search_code"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_code",
    "arguments": {
      "searchText": "string",
      "project": "string",
      "repository": [
        "string"
      ],
      "path": [
        "string"
      ],
      "branch": [
        "string"
      ],
      "includeFacets": false,
      "skip": 0,
      "top": 5
    }
  }
}

Read

Wiki

tool namesearch_wiki

Search Azure DevOps Wiki for a given search text

Parameters

Parameter	Type	Description
`searchText`required	`string`	Keywords to search for wiki pages
`project`	`array<string>`	Filter by projects
`wiki`	`array<string>`	Filter by wiki names
`includeFacets`	`boolean`	Include facets in the search results default: `false`
`skip`	`number`	Number of results to skip default: `0`
`top`	`number`	Maximum number of results to return default: `10`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "search_wiki"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_wiki",
    "arguments": {
      "searchText": "string",
      "project": [
        "string"
      ],
      "wiki": [
        "string"
      ],
      "includeFacets": false,
      "skip": 0,
      "top": 10
    }
  }
}

Read

Workitem

tool namesearch_workitem

Get Azure DevOps Work Item search results for a given search text

Parameters

Parameter	Type	Description
`searchText`required	`string`	Search text to find in work items
`project`	`array<string>`	Filter by projects
`areaPath`	`array<string>`	Filter by area paths
`workItemType`	`array<string>`	Filter by work item types
`state`	`array<string>`	Filter by work item states
`assignedTo`	`array<string>`	Filter by assigned to users
`includeFacets`	`boolean`	Include facets in the search results default: `false`
`skip`	`number`	Number of results to skip for pagination default: `0`
`top`	`number`	Number of results to return default: `10`

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "search_workitem"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_workitem",
    "arguments": {
      "searchText": "string",
      "project": [
        "string"
      ],
      "areaPath": [
        "string"
      ],
      "workItemType": [
        "string"
      ],
      "state": [
        "string"
      ],
      "assignedTo": [
        "string"
      ],
      "includeFacets": false,
      "skip": 0,
      "top": 10
    }
  }
}

Advanced Security

Advanced Security alerts and analysis.

2 tools

Read

Get Alert Details

tool nameadvsec_get_alert_details

Get detailed information about a specific Advanced Security alert.

Parameters

Parameter	Type	Description
`project`required	`string`	The name or ID of the Azure DevOps project.
`repository`required	`string`	The name or ID of the repository containing the alert.
`alertId`required	`number`	The ID of the alert to retrieve details for.
`ref`	`string`	Git reference (branch) to filter the alert.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "advsec_get_alert_details"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "advsec_get_alert_details",
    "arguments": {
      "project": "string",
      "repository": "string",
      "alertId": 1,
      "ref": "string"
    }
  }
}

Read

Get Alerts

tool nameadvsec_get_alerts

Retrieve Advanced Security alerts for a repository.

Parameters

Parameter	Type	Description
`project`required	`string`	The name or ID of the Azure DevOps project.
`repository`required	`string`	The name or ID of the repository to get alerts for.
`alertType`	`enum`	Filter alerts by type. If not specified, returns all alert types. `UnknownDependencySecretCodeLicense`
`states`	`array<enum>`	Filter alerts by state. If not specified, returns alerts in any state.
`severities`	`array<enum>`	Filter alerts by severity level. If not specified, returns alerts at any severity.
`ruleId`	`string`	Filter alerts by rule ID.
`ruleName`	`string`	Filter alerts by rule name.
`toolName`	`string`	Filter alerts by tool name.
`ref`	`string`	Filter alerts by git reference (branch). If not provided and onlyDefaultBranch is true, only includes alerts from default branch.
`onlyDefaultBranch`	`boolean`	If true, only return alerts found on the default branch. Defaults to true. default: `true`
`confidenceLevels`required	`array<enum>`	Filter alerts by confidence levels. Only applicable for secret alerts. Defaults to both 'high' and 'other'. default: `["high","other"]`
`validity`	`array<enum>`	Filter alerts by validity status. Only applicable for secret alerts.
`top`	`number`	Maximum number of alerts to return. Defaults to 100. default: `100`
`orderBy`	`enum`	Order results by specified field. Defaults to 'severity'. `idfirstSeenlastSeenfixedOnseverity` default: `"severity"`
`continuationToken`	`string`	Continuation token for pagination.

.vscode/mcp.json · remote, this tool only

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/<your-org>",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "advsec_get_alerts"
      }
    }
  },
  "inputs": []
}

Raw JSON-RPC · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "advsec_get_alerts",
    "arguments": {
      "project": "string",
      "repository": "string",
      "confidenceLevels": [
        "high",
        "other"
      ],
      "alertType": "Unknown",
      "states": [
        "Unknown"
      ],
      "severities": [
        "Low"
      ],
      "ruleId": "string",
      "ruleName": "string",
      "toolName": "string",
      "ref": "string",
      "onlyDefaultBranch": true,
      "validity": [
        "None"
      ],
      "top": 100,
      "orderBy": "severity",
      "continuationToken": "string"
    }
  }
}