@azure-devops/mcp 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/README.md

@@ -0,0 +1,247 @@
+# ⭐ Azure DevOps MCP Server
+
+Easily install the Azure DevOps MCP Server for VS Code or VS Code Insiders:
+
+[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-Install_AzureDevops_MCP_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ado&config=%7B%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22-y%22%2C%20%22%40ado%2Fazure-devops-mcp%22%2C%20%22%24%7Binput%3Aado_org%7D%22%5D%7D&inputs=%5B%7B%22id%22%3A%20%22ado_org%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22Azure%20DevOps%20organization%20name%20%20%28e.g.%20%27contoso%27%29%22%7D%5D)
+[![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_AzureDevops_MCP_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ado&quality=insiders&config=%7B%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22-y%22%2C%20%22%40ado%2Fazure-devops-mcp%22%2C%20%22%24%7Binput%3Aado_org%7D%22%5D%7D&inputs=%5B%7B%22id%22%3A%20%22ado_org%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22Azure%20DevOps%20organization%20name%20%20%28e.g.%20%27contoso%27%29%22%7D%5D)
+
+This TypeScript project defines the **local** MCP server for Azure DevOps, enabling you to perform a wide range of Azure DevOps tasks directly from your code editor.
+
+> 🚨 **Public Preview:** This project is in public preview. You can expect that the tools will change before general availability.
+
+## 📄 Table of contents
+
+1. [📺 Overview](#-overview)
+2. [⚙️ Supported tools](#️-supported-tools)
+3. [🔌 Installation & getting started](#-installation--getting-started)
+4. [🔦 Usage](#-usage)
+5. [📝 Troubleshooting](#-troubleshooting)
+6. [🎩 Samples & best practices](#-samples--best-practices)
+7. [📌 Contributing](#️-contributing)
+
+## 📺 Overview
+
+The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prompts like:
+
+- "List my ADO projects"
+- "List ADO Builds for 'Contoso'"
+- "List ADO Releases for 'Contoso'"
+- "List ADO Repos for 'Contoso'"
+- "List test plans for 'Contoso'"
+- "List teams for project 'Contoso'"
+- "List iterations for project 'Contoso'"
+- "List my work items for project 'Contoso'"
+- "List work items in current iteration for 'Contoso' project and 'Contoso Team'"
+
+## ⚙️ Supported tools
+
+Interact with these Azure DevOps services:
+
+### 🧿 Core
+
+- **core_list_project_teams**: Retrieve a list of teams for the specified Azure DevOps project.
+- **core_list_projects**: Retrieve a list of projects in your Azure DevOps organization.
+
+### ⚒️ Work
+
+- **work_list_team_iterations**: Retrieve a list of iterations for a specific team in a project.
+- **work_create_iterations**: Create new iterations in a specified Azure DevOps project.
+- **work_assign_iterations**: Assign existing iterations to a specific team in a project.
+
+### 📅 Work Items
+
+- **wit_my_work_items**: Retrieve a list of work items relevent to the authenticated user.
+- **wit_list_backlogs**: Revieve a list of backlogs for a given project and team.
+- **wit_list_backlog_work_items**: Retrieve a list of backlogs of for a given project, team, and backlog category.
+- **wit_get_work_item**: Get a single work item by ID.
+- **wit_get_work_items_batch_by_ids**: Retrieve list of work items by IDs in batch.
+- **wit_update_work_item**: Update a work item by ID with specified fields.
+- **wit_create_work_item**: Create a new work item in a specified project and work item type.
+- **wit_list_work_item_comments**: Retrieve list of comments for a work item by ID.
+- **wit_get_work_items_for_iteration**: Retrieve a list of work items for a specified iteration.
+- **wit_add_work_item_comment**: Add comment to a work item by ID.
+- **wit_add_child_work_item**: Create a child work item from a parent by ID.
+- **wit_link_work_item_to_pull_request**: Link a single work item to an existing pull request.
+- **wit_get_work_item_type**: Get a specific work item type.
+- **wit_get_query**: Get a query by its ID or path.
+- **wit_get_query_results_by_id**: Retrieve the results of a work item query given the query ID.
+- **wit_update_work_items_batch**: Update work items in batch.
+- **wit_close_and_link_workitem_duplicates**: Close duplicate work items by id.
+- **wit_work_items_link**: Link work items together in batch.
+
+### 📁 Repositories
+
+- **repo_list_repos_by_project**: Retrieve a list of repositories for a given project.
+- **repo_list_pull_requests_by_repo**: Retrieve a list of pull requests for a given repository.
+- **repo_list_pull_requests_by_project**: Retrieve a list of pull requests for a given project Id or Name.
+- **repo_list_branches_by_repo**: Retrieve a list of branches for a given repository.
+- **repo_list_my_branches_by_repo**: Retrieve a list of my branches for a given repository Id.
+- **repo_list_pull_request_threads**: Retrieve a list of comment threads for a pull request.
+- **repo_list_pull_request_thread_comments**: Retrieve a list of comments in a pull request thread.
+- **repo_get_repo_by_name_or_id**: Get the repository by project and repository name or ID.
+- **repo_get_branch_by_name**: Get a branch by its name.
+- **repo_get_pull_request_by_id**: Get a pull request by its ID.
+- **repo_create_pull_request**: Create a new pull request.
+- **repo_update_pull_request_status**: Update status of an existing pull request to active or abandoned.
+- **repo_reply_to_comment**: Replies to a specific comment on a pull request.
+- **repo_resolve_comment**: Resolves a specific comment thread on a pull request.
+
+### 🛰️ Builds
+
+- **build_get_definitions**: Retrieves a list of build definitions for a given project.
+- **build_get_definition_revisions**: Retrieves a list of revisions for a specific build definition.
+- **build_get_builds**: Retrieves a list of builds for a given project.
+- **build_get_log**: Retrieves the logs for a specific build.
+- **build_get_log_by_id**: Get a specific build log by log ID.
+- **build_get_changes**: Get the changes associated with a specific build.
+- **build_run_build**: Triggers a new build for a specified definition.
+- **build_get_status**: Fetches the status of a specific build.
+
+### 🚀 Releases
+
+- **release_get_definitions**: Retrieves list of release definitions for a given project.
+- **release_get_releases**: Retrieves a list of releases for a given project.
+
+### 🧪 Test Plans
+
+- **testplan_create_test_plan**: Creates a new test plan in the project.
+- **testplan_create_test_case**: Creates a new test case work item.
+- **testplan_add_test_cases_to_suite**: Adds existing test cases to a test suite.
+- **testplan_list_test_plans**: Retrieve a paginated list of test plans from an Azure DevOps project. Allows filtering for active plans and toggling detailed information.
+- **testplan_list_test_cases**: Gets a list of test cases in the test plan.
+- **testplan_show_test_results_from_build_id**: Gets a list of test results for a given project and build ID.
+
+### 🔎 Search
+
+- **search_code**: Get the code search results for a given search text.
+- **search_wiki**: Get wiki search results for a given search text.
+- **search_workitem**: Get work item search results for a given search text.
+
+## 🔌 Installation & getting started
+
+Clone the repository, install dependencies, and add it to your MCP client configuration.
+
+### Visual Studio Code & GitHub Copilot
+
+For the best experience, use Visual Studio Code and GitHub Copilot.
+
+### Prerequisites
+
+1. Install [VS Code](https://code.visualstudio.com/download) or [VS Code Insiders](https://code.visualstudio.com/insiders)
+2. Install [Node.js](https://nodejs.org/en/download) 20+
+3. Open VS Code in an empty folder
+
+### Azure Login
+
+Ensure you are logged in to Azure DevOps via the Azure CLI:
+
+```sh
+az login
+```
+
+### Installation
+
+#### ✨ One-Click install
+
+[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-Install_AzureDevops_MCP_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ado&config=%7B%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22-y%22%2C%20%22%40ado%2Fazure-devops-mcp%22%2C%20%22%24%7Binput%3Aado_org%7D%22%5D%7D&inputs=%5B%7B%22id%22%3A%20%22ado_org%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22Azure%20DevOps%20organization%20name%20%20%28e.g.%20%27contoso%27%29%22%7D%5D)
+[![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_AzureDevops_MCP_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ado&quality=insiders&config=%7B%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22-y%22%2C%20%22%40ado%2Fazure-devops-mcp%22%2C%20%22%24%7Binput%3Aado_org%7D%22%5D%7D&inputs=%5B%7B%22id%22%3A%20%22ado_org%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22Azure%20DevOps%20organization%20name%20%20%28e.g.%20%27contoso%27%29%22%7D%5D)
+
+After installation, select GitHub Copilot Agent Mode and refresh the tools list. Learn more about Agent Mode in the [VS Code Documentation](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode).
+
+#### 🛠️ Installing from source (dev mode)
+
+This installation method is recommended for advanced users and contributors who want immediate access to the latest updates from the main branch. It is ideal if you are developing new tools, enhancing existing features, or maintaining a custom fork.
+
+> **Note:** For most users, installing from the public feed is simpler and preferred. Use source installation only if you need the latest changes or are actively contributing to the project.
+
+##### Steps
+
+1. Clone the repository.
+2. Install dependencies:
+   ```sh
+   npm install
+   ```
+3. Edit or add `.vscode/mcp.json`:
+
+   ```json
+   {
+     "inputs": [
+        {
+           "id": "ado_org",
+           "type": "promptString",
+           "description": "Azure DevOps organization name  (e.g. 'contoso')"
+        }
+     ],
+     "servers": {
+        "ado": {
+            "type": "stdio",
+            "command": "mcp-server-azuredevops",
+            "args": ["${input:ado_org}"]
+        }
+     }
+   }
+   ```
+
+4. Start the Azure DevOps MCP Server:
+5. In chat, switch to [Agent Mode](https://code.visualstudio.com/blogs/2025/02/24/introducing-copilot-agent-mode).
+6. Click "Select Tools" and choose the available `ado_` tools.
+
+See [How To](./docs/HOWTO.md) section for details
+
+#### Placeholder for public feed
+
+Update for Public Feed
+
+## 🔦 Usage
+
+### Visual Studio Code + GitHub Copilot
+
+1. Open GitHub Copilot in VS Code and switch to Agent mode.
+2. Start the Azure DevOps MCP Server.
+3. The server appears in the tools list.
+4. Try prompts like "List ADO projects".
+
+### Visual Studio + GitHub Copilot
+
+> *Prerequisites:* Visual Studio 2022 v17.14+, Agent mode enabled in Tools > Options > GitHub > Copilot > Copilot Chat.
+
+1. Switch to Agent mode in the Copilot Chat window.
+2. Enter your Azure DevOps organization name.
+3. Select desired `ado` tools.
+4. Try prompts like "List ADO projects".
+
+For more details, see [Visual Studio MCP Servers documentation](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022) and [Getting Started Video](https://www.youtube.com/watch?v=oPFecZHBCkg).
+
+## 📝 Troubleshooting
+
+See the [Troubleshooting guide](./docs/TROUBLESHOOTING.md) for help with common issues and logging.
+
+## 🎩 Samples & best practices
+
+Find sample prompts and best practices in our [How-to Guide](./docs/HOWTO.md).
+
+## 📌 Contributing
+
+We welcome contributions! During preview, please file Issues for bugs, enhancements, or documentation improvements.
+
+See our [Contributions Guide](./CONTRIBUTING.md) for:
+
+ - 🛠️ Development setup
+ - ✨ Adding new tools
+ - 📝 Code style & testing
+ - 🔄 Pull request process
+
+## 🤝 Code of conduct
+
+This project follows the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For questions, see the [FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [open@microsoft.com](mailto:open@microsoft.com).
+
+## License
+
+Licensed under the [MIT License](./LICENSE.md).
+
+---
+
+_Trademarks: This project may include trademarks or logos for Microsoft or third parties. Use of Microsoft trademarks or logos must follow [Microsoft’s Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Third-party trademarks are subject to their respective policies._
+
+<!-- version: 2023-04-07 [Do not delete this line, it is used for analytics that drive template improvements] -->

package/dist/index.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import * as azdev from "azure-devops-node-api";
+import { DefaultAzureCredential } from "@azure/identity";
+import { configurePrompts } from "./prompts.js";
+import { configureAllTools } from "./tools.js";
+import { userAgent } from "./utils.js";
+import { packageVersion } from "./version.js";
+const args = process.argv.slice(2);
+if (args.length === 0) {
+    console.error("Usage: mcp-server-azuredevops <organization_name>");
+    process.exit(1);
+}
+export const orgName = args[0];
+const orgUrl = "https://dev.azure.com/" + orgName;
+async function getAzureDevOpsToken() {
+    process.env.AZURE_TOKEN_CREDENTIALS = "dev";
+    const credential = new DefaultAzureCredential(); // CodeQL [SM05138] resolved by explicitly setting AZURE_TOKEN_CREDENTIALS
+    const token = await credential.getToken("499b84ac-1321-427f-aa17-267ca6975798/.default");
+    return token;
+}
+async function getAzureDevOpsClient() {
+    const token = await getAzureDevOpsToken();
+    const authHandler = azdev.getBearerHandler(token.token);
+    const connection = new azdev.WebApi(orgUrl, authHandler, undefined, {
+        productName: "AzureDevOps.MCP",
+        productVersion: packageVersion,
+        userAgent: userAgent
+    });
+    return connection;
+}
+async function main() {
+    console.error("Starting Azure DevOps MCP Server...");
+    const server = new McpServer({
+        name: "Azure DevOps MCP Server",
+        version: "1.0.0",
+    });
+    configurePrompts(server);
+    configureAllTools(server, getAzureDevOpsToken, getAzureDevOpsClient);
+    const transport = new StdioServerTransport();
+    console.error("Connecting server to transport...");
+    await server.connect(transport);
+    console.error("Azure DevOps MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});

package/dist/prompts.js

@@ -0,0 +1,25 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { z } from "zod";
+import { REPO_TOOLS } from "./tools/repos.js";
+function configurePrompts(server) {
+    server.prompt("relevant_pull_requests", "Presents the list of relevant pull requests for a given repository.", { repositoryId: z.string() }, ({ repositoryId }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: String.raw `
+# Prerequisites
+1. Unless already provided, ask user for the project name
+2. Unless already provided, use '${REPO_TOOLS.list_repos_by_project}' tool to get a summarized response of the repositories in this project and ask user to select one
+
+# Task
+Find all pull requests for repository ${repositoryId} using '${REPO_TOOLS.list_pull_requests_by_repo}' tool and summarize them in a table.
+Include the following columns: ID, Title, Status, Created Date, Author and Reviewers.`,
+                },
+            },
+        ],
+    }));
+}
+export { configurePrompts };

package/dist/tools/auth.js

@@ -0,0 +1,20 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+async function getCurrentUserDetails(tokenProvider, connectionProvider) {
+    const connection = await connectionProvider();
+    const url = `${connection.serverUrl}/_apis/connectionData`;
+    const token = (await tokenProvider()).token;
+    const response = await fetch(url, {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+    });
+    const data = await response.json();
+    if (!response.ok) {
+        throw new Error(`Error fetching user details: ${data.message}`);
+    }
+    return data;
+}
+export { getCurrentUserDetails };

package/dist/tools/builds.js

@@ -0,0 +1,146 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { BuildQueryOrder, DefinitionQueryOrder } from "azure-devops-node-api/interfaces/BuildInterfaces.js";
+import { z } from "zod";
+const BUILD_TOOLS = {
+    get_definitions: "build_get_definitions",
+    get_definition_revisions: "build_get_definition_revisions",
+    get_builds: "build_get_builds",
+    get_log: "build_get_log",
+    get_log_by_id: "build_get_log_by_id",
+    get_changes: "build_get_changes",
+    run_build: "build_run_build",
+    get_status: "build_get_status"
+};
+function configureBuildTools(server, tokenProvider, connectionProvider) {
+    server.tool(BUILD_TOOLS.get_definitions, "Retrieves a list of build definitions for a given project.", {
+        project: z.string().describe("Project ID or name to get build definitions for"),
+        repositoryId: z.string().optional().describe("Repository ID to filter build definitions"),
+        repositoryType: z.enum(["TfsGit", "GitHub", "BitbucketCloud"]).optional().describe("Type of repository to filter build definitions"),
+        name: z.string().optional().describe("Name of the build definition to filter"),
+        path: z.string().optional().describe("Path of the build definition to filter"),
+        queryOrder: z.nativeEnum(DefinitionQueryOrder).optional().describe("Order in which build definitions are returned"),
+        top: z.number().optional().describe("Maximum number of build definitions to return"),
+        continuationToken: z.string().optional().describe("Token for continuing paged results"),
+        minMetricsTime: z.date().optional().describe("Minimum metrics time to filter build definitions"),
+        definitionIds: z.array(z.number()).optional().describe("Array of build definition IDs to filter"),
+        builtAfter: z.date().optional().describe("Return definitions that have builds after this date"),
+        notBuiltAfter: z.date().optional().describe("Return definitions that do not have builds after this date"),
+        includeAllProperties: z.boolean().optional().describe("Whether to include all properties in the results"),
+        includeLatestBuilds: z.boolean().optional().describe("Whether to include the latest builds for each definition"),
+        taskIdFilter: z.string().optional().describe("Task ID to filter build definitions"),
+        processType: z.number().optional().describe("Process type to filter build definitions"),
+        yamlFilename: z.string().optional().describe("YAML filename to filter build definitions"),
+    }, async ({ project, repositoryId, repositoryType, name, path, queryOrder, top, continuationToken, minMetricsTime, definitionIds, builtAfter, notBuiltAfter, includeAllProperties, includeLatestBuilds, taskIdFilter, processType, yamlFilename, }) => {
+        const connection = await connectionProvider();
+        const buildApi = await connection.getBuildApi();
+        const buildDefinitions = await buildApi.getDefinitions(project, name, repositoryId, repositoryType, queryOrder, top, continuationToken, minMetricsTime, definitionIds, path, builtAfter, notBuiltAfter, includeAllProperties, includeLatestBuilds, taskIdFilter, processType, yamlFilename);
+        return {
+            content: [{ type: "text", text: JSON.stringify(buildDefinitions, null, 2) }],
+        };
+    });
+    server.tool(BUILD_TOOLS.get_definition_revisions, "Retrieves a list of revisions for a specific build definition.", {
+        project: z.string().describe("Project ID or name to get the build definition revisions for"),
+        definitionId: z.number().describe("ID of the build definition to get revisions for"),
+    }, async ({ project, definitionId }) => {
+        const connection = await connectionProvider();
+        const buildApi = await connection.getBuildApi();
+        const revisions = await buildApi.getDefinitionRevisions(project, definitionId);
+        return {
+            content: [{ type: "text", text: JSON.stringify(revisions, null, 2) }],
+        };
+    });
+    server.tool(BUILD_TOOLS.get_builds, "Retrieves a list of builds for a given project.", {
+        project: z.string().describe("Project ID or name to get builds for"),
+        definitions: z.array(z.number()).optional().describe("Array of build definition IDs to filter builds"),
+        queues: z.array(z.number()).optional().describe("Array of queue IDs to filter builds"),
+        buildNumber: z.string().optional().describe("Build number to filter builds"),
+        minTime: z.date().optional().describe("Minimum finish time to filter builds"),
+        maxTime: z.date().optional().describe("Maximum finish time to filter builds"),
+        requestedFor: z.string().optional().describe("User ID or name who requested the build"),
+        reasonFilter: z.number().optional().describe("Reason filter for the build (see BuildReason enum)"),
+        statusFilter: z.number().optional().describe("Status filter for the build (see BuildStatus enum)"),
+        resultFilter: z.number().optional().describe("Result filter for the build (see BuildResult enum)"),
+        tagFilters: z.array(z.string()).optional().describe("Array of tags to filter builds"),
+        properties: z.array(z.string()).optional().describe("Array of property names to include in the results"),
+        top: z.number().optional().describe("Maximum number of builds to return"),
+        continuationToken: z.string().optional().describe("Token for continuing paged results"),
+        maxBuildsPerDefinition: z.number().optional().describe("Maximum number of builds per definition"),
+        deletedFilter: z.number().optional().describe("Filter for deleted builds (see QueryDeletedOption enum)"),
+        queryOrder: z.nativeEnum(BuildQueryOrder).default(BuildQueryOrder.QueueTimeDescending).optional().describe("Order in which builds are returned"),
+        branchName: z.string().optional().describe("Branch name to filter builds"),
+        buildIds: z.array(z.number()).optional().describe("Array of build IDs to retrieve"),
+        repositoryId: z.string().optional().describe("Repository ID to filter builds"),
+        repositoryType: z.enum(["TfsGit", "GitHub", "BitbucketCloud"]).optional().describe("Type of repository to filter builds"),
+    }, async ({ project, definitions, queues, buildNumber, minTime, maxTime, requestedFor, reasonFilter, statusFilter, resultFilter, tagFilters, properties, top, continuationToken, maxBuildsPerDefinition, deletedFilter, queryOrder, branchName, buildIds, repositoryId, repositoryType, }) => {
+        const connection = await connectionProvider();
+        const buildApi = await connection.getBuildApi();
+        const builds = await buildApi.getBuilds(project, definitions, queues, buildNumber, minTime, maxTime, requestedFor, reasonFilter, statusFilter, resultFilter, tagFilters, properties, top, continuationToken, maxBuildsPerDefinition, deletedFilter, queryOrder, branchName, buildIds, repositoryId, repositoryType);
+        return {
+            content: [{ type: "text", text: JSON.stringify(builds, null, 2) }],
+        };
+    });
+    server.tool(BUILD_TOOLS.get_log, "Retrieves the logs for a specific build.", {
+        project: z.string().describe("Project ID or name to get the build log for"),
+        buildId: z.number().describe("ID of the build to get the log for"),
+    }, async ({ project, buildId }) => {
+        const connection = await connectionProvider();
+        const buildApi = await connection.getBuildApi();
+        const logs = await buildApi.getBuildLogs(project, buildId);
+        return {
+            content: [{ type: "text", text: JSON.stringify(logs, null, 2) }],
+        };
+    });
+    server.tool(BUILD_TOOLS.get_log_by_id, "Get a specific build log by log ID.", {
+        project: z.string().describe("Project ID or name to get the build log for"),
+        buildId: z.number().describe("ID of the build to get the log for"),
+        logId: z.number().describe("ID of the log to retrieve"),
+        startLine: z.number().optional().describe("Starting line number for the log content, defaults to 0"),
+        endLine: z.number().optional().describe("Ending line number for the log content, defaults to the end of the log"),
+    }, async ({ project, buildId, logId, startLine, endLine }) => {
+        const connection = await connectionProvider();
+        const buildApi = await connection.getBuildApi();
+        const logLines = await buildApi.getBuildLogLines(project, buildId, logId, startLine, endLine);
+        return {
+            content: [{ type: "text", text: JSON.stringify(logLines, null, 2) }],
+        };
+    });
+    server.tool(BUILD_TOOLS.get_changes, "Get the changes associated with a specific build.", {
+        project: z.string().describe("Project ID or name to get the build changes for"),
+        buildId: z.number().describe("ID of the build to get changes for"),
+        continuationToken: z.string().optional().describe("Continuation token for pagination"),
+        top: z.number().default(100).describe("Number of changes to retrieve, defaults to 100"),
+        includeSourceChange: z.boolean().optional().describe("Whether to include source changes in the results, defaults to false"),
+    }, async ({ project, buildId, continuationToken, top, includeSourceChange }) => {
+        const connection = await connectionProvider();
+        const buildApi = await connection.getBuildApi();
+        const changes = await buildApi.getBuildChanges(project, buildId, continuationToken, top, includeSourceChange);
+        return {
+            content: [{ type: "text", text: JSON.stringify(changes, null, 2) }],
+        };
+    });
+    server.tool(BUILD_TOOLS.run_build, "Triggers a new build for a specified definition.", {
+        project: z.string().describe("Project ID or name to run the build in"),
+        definitionId: z.number().describe("ID of the build definition to run"),
+        sourceBranch: z.string().optional().describe("Source branch to run the build from. If not provided, the default branch will be used."),
+    }, async ({ project, definitionId, sourceBranch }) => {
+        const connection = await connectionProvider();
+        const buildApi = await connection.getBuildApi();
+        const build = await buildApi.queueBuild({ definition: { id: definitionId }, sourceBranch }, project);
+        return {
+            content: [{ type: "text", text: JSON.stringify(build, null, 2) }],
+        };
+    });
+    server.tool(BUILD_TOOLS.get_status, "Fetches the status of a specific build.", {
+        project: z.string().describe("Project ID or name to get the build status for"),
+        buildId: z.number().describe("ID of the build to get the status for"),
+    }, async ({ project, buildId }) => {
+        const connection = await connectionProvider();
+        const buildApi = await connection.getBuildApi();
+        const build = await buildApi.getBuildReport(project, buildId);
+        return {
+            content: [{ type: "text", text: JSON.stringify(build, null, 2) }],
+        };
+    });
+}
+export { BUILD_TOOLS, configureBuildTools };

package/dist/tools/core.js

@@ -0,0 +1,36 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { z } from "zod";
+const CORE_TOOLS = {
+    list_project_teams: "core_list_project_teams",
+    list_projects: "core_list_projects",
+};
+function configureCoreTools(server, tokenProvider, connectionProvider) {
+    server.tool(CORE_TOOLS.list_project_teams, "Retrieve a list of teams for the specified Azure DevOps project.", {
+        project: z.string().describe("The name or ID of the Azure DevOps project."),
+        mine: z.boolean().optional().describe("If true, only return teams that the authenticated user is a member of."),
+        top: z.number().optional().describe("The maximum number of teams to return. Defaults to 100."),
+        skip: z.number().optional().describe("The number of teams to skip for pagination. Defaults to 0."),
+    }, async ({ project, mine, top, skip }) => {
+        const connection = await connectionProvider();
+        const coreApi = await connection.getCoreApi();
+        const teams = await coreApi.getTeams(project, mine, top, skip, false);
+        return {
+            content: [{ type: "text", text: JSON.stringify(teams, null, 2) }],
+        };
+    });
+    server.tool(CORE_TOOLS.list_projects, "Retrieve a list of projects in your Azure DevOps organization.", {
+        stateFilter: z.enum(["all", "wellFormed", "createPending", "deleted"]).default("wellFormed").describe("Filter projects by their state. Defaults to 'wellFormed'."),
+        top: z.number().optional().describe("The maximum number of projects to return. Defaults to 100."),
+        skip: z.number().optional().describe("The number of projects to skip for pagination. Defaults to 0."),
+        continuationToken: z.number().optional().describe("Continuation token for pagination. Used to fetch the next set of results if available."),
+    }, async ({ stateFilter, top, skip, continuationToken }) => {
+        const connection = await connectionProvider();
+        const coreApi = await connection.getCoreApi();
+        const projects = await coreApi.getProjects(stateFilter, top, skip, continuationToken, false);
+        return {
+            content: [{ type: "text", text: JSON.stringify(projects, null, 2) }],
+        };
+    });
+}
+export { CORE_TOOLS, configureCoreTools };

package/dist/tools/releases.js

@@ -0,0 +1,72 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { ReleaseDefinitionExpands, ReleaseDefinitionQueryOrder, ReleaseExpands, ReleaseStatus, ReleaseQueryOrder, } from "azure-devops-node-api/interfaces/ReleaseInterfaces.js";
+import { z } from "zod";
+const RELEASE_TOOLS = {
+    get_release_definitions: "release_get_definitions",
+    get_releases: "release_get_releases",
+};
+function configureReleaseTools(server, tokenProvider, connectionProvider) {
+    server.tool(RELEASE_TOOLS.get_release_definitions, "Retrieves list of release definitions for a given project.", {
+        project: z.string().describe("Project ID or name to get release definitions for"),
+        searchText: z.string().optional().describe("Search text to filter release definitions"),
+        expand: z.nativeEnum(ReleaseDefinitionExpands).default(ReleaseDefinitionExpands.None).describe("Expand options for release definitions"),
+        artifactType: z.string().optional().describe("Filter by artifact type"),
+        artifactSourceId: z.string().optional().describe("Filter by artifact source ID"),
+        top: z.number().optional().describe("Number of results to return (for pagination)"),
+        continuationToken: z.string().optional().describe("Continuation token for pagination"),
+        queryOrder: z.nativeEnum(ReleaseDefinitionQueryOrder).default(ReleaseDefinitionQueryOrder.NameAscending).describe("Order of the results"),
+        path: z.string().optional().describe("Path to filter release definitions"),
+        isExactNameMatch: z.boolean().optional().default(false).describe("Whether to match the exact name of the release definition. Default is false."),
+        tagFilter: z.array(z.string()).optional().describe("Filter by tags associated with the release definitions"),
+        propertyFilters: z.array(z.string()).optional().describe("Filter by properties associated with the release definitions"),
+        definitionIdFilter: z.array(z.string()).optional().describe("Filter by specific release definition IDs"),
+        isDeleted: z.boolean().default(false).describe("Whether to include deleted release definitions. Default is false."),
+        searchTextContainsFolderName: z.boolean().optional().describe("Whether to include folder names in the search text"),
+    }, async ({ project, searchText, expand, artifactType, artifactSourceId, top, continuationToken, queryOrder, path, isExactNameMatch, tagFilter, propertyFilters, definitionIdFilter, isDeleted, searchTextContainsFolderName, }) => {
+        const connection = await connectionProvider();
+        const releaseApi = await connection.getReleaseApi();
+        const releaseDefinitions = await releaseApi.getReleaseDefinitions(project, searchText, expand, artifactType, artifactSourceId, top, continuationToken, queryOrder, path, isExactNameMatch, tagFilter, propertyFilters, definitionIdFilter, isDeleted, searchTextContainsFolderName);
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(releaseDefinitions, null, 2) },
+            ],
+        };
+    });
+    server.tool(RELEASE_TOOLS.get_releases, "Retrieves a list of releases for a given project.", {
+        project: z.string().optional().describe("Project ID or name to get releases for"),
+        definitionId: z.number().optional().describe("ID of the release definition to filter releases"),
+        definitionEnvironmentId: z.number().optional().describe("ID of the definition environment to filter releases"),
+        searchText: z.string().optional().describe("Search text to filter releases"),
+        createdBy: z.string().optional().describe("User ID or name who created the release"),
+        statusFilter: z.nativeEnum(ReleaseStatus).optional().default(ReleaseStatus.Active).describe("Status of the releases to filter (default: Active)"),
+        environmentStatusFilter: z.number().optional().describe("Environment status to filter releases"),
+        minCreatedTime: z.date().optional().default(() => {
+            const sevenDaysAgo = new Date();
+            sevenDaysAgo.setDate(sevenDaysAgo.getDate() - 7);
+            return sevenDaysAgo;
+        }).describe("Minimum created time for releases (default: 7 days ago)"),
+        maxCreatedTime: z.date().optional().default(() => new Date()).describe("Maximum created time for releases (default: now)"),
+        queryOrder: z.nativeEnum(ReleaseQueryOrder).optional().default(ReleaseQueryOrder.Ascending).describe("Order in which to return releases (default: Ascending)"),
+        top: z.number().optional().describe("Number of releases to return"),
+        continuationToken: z.number().optional().describe("Continuation token for pagination"),
+        expand: z.nativeEnum(ReleaseExpands).optional().default(ReleaseExpands.None).describe("Expand options for releases"),
+        artifactTypeId: z.string().optional().describe("Filter releases by artifact type ID"),
+        sourceId: z.string().optional().describe("Filter releases by artifact source ID"),
+        artifactVersionId: z.string().optional().describe("Filter releases by artifact version ID"),
+        sourceBranchFilter: z.string().optional().describe("Filter releases by source branch"),
+        isDeleted: z.boolean().optional().default(false).describe("Whether to include deleted releases (default: false)"),
+        tagFilter: z.array(z.string()).optional().describe("Filter releases by tags"),
+        propertyFilters: z.array(z.string()).optional().describe("Filter releases by properties"),
+        releaseIdFilter: z.array(z.number()).optional().describe("Filter by specific release IDs"),
+        path: z.string().optional().describe("Path to filter releases"),
+    }, async ({ project, definitionId, definitionEnvironmentId, searchText, createdBy, statusFilter, environmentStatusFilter, minCreatedTime, maxCreatedTime, queryOrder, top, continuationToken, expand, artifactTypeId, sourceId, artifactVersionId, sourceBranchFilter, isDeleted, tagFilter, propertyFilters, releaseIdFilter, path, }) => {
+        const connection = await connectionProvider();
+        const releaseApi = await connection.getReleaseApi();
+        const releases = await releaseApi.getReleases(project, definitionId, definitionEnvironmentId, searchText, createdBy, statusFilter, environmentStatusFilter, minCreatedTime, maxCreatedTime, queryOrder, top, continuationToken, expand, artifactTypeId, sourceId, artifactVersionId, sourceBranchFilter, isDeleted, tagFilter, propertyFilters, releaseIdFilter, path);
+        return {
+            content: [{ type: "text", text: JSON.stringify(releases, null, 2) }],
+        };
+    });
+}
+export { RELEASE_TOOLS, configureReleaseTools };