@azure-devops/mcp 0.1.0 → 1.0.0

package/README.md

@@ -2,8 +2,8 @@
 
 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)
+[![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%40azure-devops%2Fmcp%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%40azure-devops%2Fmcp%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.
 
@@ -17,7 +17,8 @@ This TypeScript project defines the **local** MCP server for Azure DevOps, enabl
 4. [🔦 Usage](#-usage)
 5. [📝 Troubleshooting](#-troubleshooting)
 6. [🎩 Samples & best practices](#-samples--best-practices)
-7. [📌 Contributing](#️-contributing)
+7. [🙋‍♀️ Frequently asked questions](#️-frequently-asked-questions)
+8. [📌 Contributing](#️-contributing)
 
 ## 📺 Overview
 
@@ -129,7 +130,8 @@ For the best experience, use Visual Studio Code and GitHub Copilot.
 
 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
+3. Install [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest)
+4. Open VS Code in an empty folder
 
 ### Azure Login
 
@@ -143,11 +145,51 @@ az login
 
 #### ✨ 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)
+[![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%40azure-devops%2Fmcp%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%40azure-devops%2Fmcp%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 public feed (recommended)
+
+This installation method is the easiest for all users using Visual Studio Code.
+
+🎥 [Watch this quick start video to get up and running in under two minutes!](https://youtu.be/EUmFM6qXoYk)
+
+##### Steps
+
+1. In your project, add a `.vscode\mcp.json` file and add the following:
+
+   ``` json
+   {
+      "inputs": [
+        {
+            "id": "ado_org",
+            "type": "promptString",
+            "description": "Azure DevOps organization name  (e.g. 'contoso')"
+        }
+      ],
+      "servers": {
+        "ado": {
+            "type": "stdio",
+            "command": "npx",
+            "args": [
+                "-y",
+                "@azure-devops/mcp",
+                "${input:ado_org}"
+            ]
+         }
+      }
+   }
+   ```
+2. Save the file and click 'Start`
+
+   <img src="./docs/media/start-mcp-server.gif" alt="start mcp server" width="250"/>
+
+3. In chat, switch to [Agent Mode](https://code.visualstudio.com/blogs/2025/02/24/introducing-copilot-agent-mode).
+4. Click "Select Tools" and choose the available tools.
+5. We strongly recommend that you create a `.github\copilot-instructions.md` in your project and copy and paste the contents from this [copilot-instructions.md](./.github/copilot-instructions.md) file. This will help your experience when it comes to using the Azure DevOps MCP Server in GitHub Copilot Chat.
+
 #### 🛠️ 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.
@@ -182,16 +224,16 @@ This installation method is recommended for advanced users and contributors who
    }
    ```
 
-4. Start the Azure DevOps MCP Server:
+4. Start the Azure DevOps MCP Server
+
+   <img src="./docs/media/start-mcp-server.gif" alt="start mcp server" width="250"/>
+  
 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.
+6. Click "Select Tools" and choose the available tools.
+7. We strongly recommend that you create a `.github\copilot-instructions.md` in your project and copy and paste the contents from this [copilot-instructions.md](./.github/copilot-instructions.md) file. This will help your experience when it comes to using the Azure DevOps MCP Server in GitHub Copilot Chat.
 
 See [How To](./docs/HOWTO.md) section for details
 
-#### Placeholder for public feed
-
-Update for Public Feed
-
 ## 🔦 Usage
 
 ### Visual Studio Code + GitHub Copilot
@@ -220,6 +262,10 @@ See the [Troubleshooting guide](./docs/TROUBLESHOOTING.md) for help with common
 
 Find sample prompts and best practices in our [How-to Guide](./docs/HOWTO.md).
 
+## 🙋‍♀️ Frequently asked questions
+
+For answers to common questions about the Azure DevOps MCP Server, see the [Frequently Asked Questions](./docs/FAQ.md).
+
 ## 📌 Contributing
 
 We welcome contributions! During preview, please file Issues for bugs, enhancements, or documentation improvements.

package/dist/http.js

@@ -0,0 +1,52 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import express from "express";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { serverBuildAndConnect } from "./server.js";
+import { packageVersion } from "./version.js";
+const app = express();
+app.use(express.json());
+app.post('/mcp/:orgName', async (req, res) => {
+    // In stateless mode, create a new instance of transport and server for each request
+    // to ensure complete isolation. A single instance would cause request ID collisions
+    // when multiple clients connect concurrently.
+    try {
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+        const server = await serverBuildAndConnect(req.params.orgName, transport);
+        res.on('close', () => {
+            transport.close();
+            server.close();
+        });
+        await transport.handleRequest(req, res, req.body);
+    }
+    catch (error) {
+        console.error('Error handling MCP request:', error);
+        if (!res.headersSent) {
+            res.status(500).json({
+                jsonrpc: '2.0',
+                error: {
+                    code: -32603,
+                    message: 'Internal server error',
+                },
+                id: null,
+            });
+        }
+    }
+});
+app.get('/mcp/:orgName', async (req, res) => {
+    console.log('Received GET MCP request');
+    res.writeHead(405).end(JSON.stringify({
+        jsonrpc: "2.0",
+        error: {
+            code: -32000,
+            message: "Method not allowed."
+        },
+        id: null
+    }));
+});
+const PORT = 3000;
+app.listen(PORT, () => {
+    console.log(`Azure DevOps MCP Server with http transport listening on port ${PORT}. Version: ${packageVersion}`);
+});

package/dist/index.js

@@ -33,17 +33,15 @@ async function getAzureDevOpsClient() {
     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",
+        version: packageVersion,
     });
     configurePrompts(server);
     configureAllTools(server, getAzureDevOpsToken, getAzureDevOpsClient);
     const transport = new StdioServerTransport();
-    console.error("Connecting server to transport...");
+    console.log("Azure DevOps MCP Server version : " + packageVersion);
     await server.connect(transport);
-    console.error("Azure DevOps MCP Server running on stdio");
 }
 main().catch((error) => {
     console.error("Fatal error in main():", error);

package/dist/server.js

@@ -0,0 +1,36 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.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";
+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(orgUrl) {
+    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;
+}
+export async function serverBuildAndConnect(orgName, transport) {
+    const server = new McpServer({
+        name: "Azure DevOps MCP Server",
+        version: packageVersion,
+    });
+    const orgUrl = "https://dev.azure.com/" + orgName;
+    configurePrompts(server);
+    configureAllTools(server, () => orgName, getAzureDevOpsToken, () => getAzureDevOpsClient(orgUrl));
+    await server.connect(transport);
+    return server;
+}

package/dist/tools/core.js

@@ -12,12 +12,24 @@ function configureCoreTools(server, tokenProvider, connectionProvider) {
         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) }],
-        };
+        try {
+            const connection = await connectionProvider();
+            const coreApi = await connection.getCoreApi();
+            const teams = await coreApi.getTeams(project, mine, top, skip, false);
+            if (!teams) {
+                return { content: [{ type: "text", text: "No teams found" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(teams, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                content: [{ type: "text", text: `Error fetching project teams: ${errorMessage}` }],
+                isError: true
+            };
+        }
     });
     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'."),
@@ -25,12 +37,24 @@ function configureCoreTools(server, tokenProvider, connectionProvider) {
         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) }],
-        };
+        try {
+            const connection = await connectionProvider();
+            const coreApi = await connection.getCoreApi();
+            const projects = await coreApi.getProjects(stateFilter, top, skip, continuationToken, false);
+            if (!projects) {
+                return { content: [{ type: "text", text: "No projects found" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(projects, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                content: [{ type: "text", text: `Error fetching projects: ${errorMessage}` }],
+                isError: true
+            };
+        }
     });
 }
 export { CORE_TOOLS, configureCoreTools };

package/dist/tools/work.js

@@ -13,12 +13,24 @@ function configureWorkTools(server, tokenProvider, connectionProvider) {
         team: z.string().describe("The name or ID of the Azure DevOps team."),
         timeframe: z.enum(["current"]).optional().describe("The timeframe for which to retrieve iterations. Currently, only 'current' is supported."),
     }, async ({ project, team, timeframe }) => {
-        const connection = await connectionProvider();
-        const workApi = await connection.getWorkApi();
-        const iterations = await workApi.getTeamIterations({ project, team }, timeframe);
-        return {
-            content: [{ type: "text", text: JSON.stringify(iterations, null, 2) }],
-        };
+        try {
+            const connection = await connectionProvider();
+            const workApi = await connection.getWorkApi();
+            const iterations = await workApi.getTeamIterations({ project, team }, timeframe);
+            if (!iterations) {
+                return { content: [{ type: "text", text: "No iterations found" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(iterations, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                content: [{ type: "text", text: `Error fetching team iterations: ${errorMessage}` }],
+                isError: true
+            };
+        }
     });
     server.tool(WORK_TOOLS.create_iterations, "Create new iterations in a specified Azure DevOps project.", {
         project: z.string().describe("The name or ID of the Azure DevOps project."),
@@ -28,23 +40,37 @@ function configureWorkTools(server, tokenProvider, connectionProvider) {
             finishDate: z.string().optional().describe("The finish date of the iteration in ISO format (e.g., '2023-01-31T23:59:59Z'). Optional.")
         })).describe("An array of iterations to create. Each iteration must have a name and can optionally have start and finish dates in ISO format.")
     }, async ({ project, iterations }) => {
-        const connection = await connectionProvider();
-        const workItemTrackingApi = await connection.getWorkItemTrackingApi();
-        const results = [];
-        for (const { iterationName, startDate, finishDate } of iterations) {
-            // Step 1: Create the iteration
-            const iteration = await workItemTrackingApi.createOrUpdateClassificationNode({
-                name: iterationName,
-                attributes: {
-                    startDate: startDate ? new Date(startDate) : undefined,
-                    finishDate: finishDate ? new Date(finishDate) : undefined,
-                },
-            }, project, TreeStructureGroup.Iterations);
-            results.push(iteration);
+        try {
+            const connection = await connectionProvider();
+            const workItemTrackingApi = await connection.getWorkItemTrackingApi();
+            const results = [];
+            for (const { iterationName, startDate, finishDate } of iterations) {
+                // Step 1: Create the iteration
+                const iteration = await workItemTrackingApi.createOrUpdateClassificationNode({
+                    name: iterationName,
+                    attributes: {
+                        startDate: startDate ? new Date(startDate) : undefined,
+                        finishDate: finishDate ? new Date(finishDate) : undefined,
+                    },
+                }, project, TreeStructureGroup.Iterations);
+                if (iteration) {
+                    results.push(iteration);
+                }
+            }
+            if (results.length === 0) {
+                return { content: [{ type: "text", text: "No iterations were created" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                content: [{ type: "text", text: `Error creating iterations: ${errorMessage}` }],
+                isError: true
+            };
         }
-        return {
-            content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
-        };
     });
     server.tool(WORK_TOOLS.assign_iterations, "Assign existing iterations to a specific team in a project.", {
         project: z.string().describe("The name or ID of the Azure DevOps project."),
@@ -54,17 +80,31 @@ function configureWorkTools(server, tokenProvider, connectionProvider) {
             path: z.string().describe("The path of the iteration to assign, e.g., 'Project/Iteration'.")
         })).describe("An array of iterations to assign. Each iteration must have an identifier and a path."),
     }, async ({ project, team, iterations }) => {
-        const connection = await connectionProvider();
-        const workApi = await connection.getWorkApi();
-        const teamContext = { project, team };
-        const results = [];
-        for (const { identifier, path } of iterations) {
-            const assignment = await workApi.postTeamIteration({ path: path, id: identifier }, teamContext);
-            results.push(assignment);
+        try {
+            const connection = await connectionProvider();
+            const workApi = await connection.getWorkApi();
+            const teamContext = { project, team };
+            const results = [];
+            for (const { identifier, path } of iterations) {
+                const assignment = await workApi.postTeamIteration({ path: path, id: identifier }, teamContext);
+                if (assignment) {
+                    results.push(assignment);
+                }
+            }
+            if (results.length === 0) {
+                return { content: [{ type: "text", text: "No iterations were assigned to the team" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                content: [{ type: "text", text: `Error assigning iterations: ${errorMessage}` }],
+                isError: true
+            };
         }
-        return {
-            content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
-        };
     });
 }
 export { WORK_TOOLS, configureWorkTools };

package/dist/tools/workitems.js

@@ -194,14 +194,14 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider) {
         };
     });
     server.tool(WORKITEM_TOOLS.link_work_item_to_pull_request, "Link a single work item to an existing pull request.", {
-        project: z.string().describe,
+        project: z.string().describe("The name or ID of the Azure DevOps project."),
         repositoryId: z.string().describe("The ID of the repository containing the pull request. Do not use the repository name here, use the ID instead."),
         pullRequestId: z.number().describe("The ID of the pull request to link to."),
         workItemId: z.number().describe("The ID of the work item to link to the pull request."),
     }, async ({ project, repositoryId, pullRequestId, workItemId }) => {
-        const connection = await connectionProvider();
-        const workItemTrackingApi = await connection.getWorkItemTrackingApi();
         try {
+            const connection = await connectionProvider();
+            const workItemTrackingApi = await connection.getWorkItemTrackingApi();
             // Create artifact link relation using vstfs format
             // Format: vstfs:///Git/PullRequestId/{project}/{repositoryId}/{pullRequestId}
             const artifactPathValue = `${project}/${repositoryId}/${pullRequestId}`;
@@ -221,7 +221,10 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider) {
                 },
             ];
             // Use the WorkItem API to update the work item with the new relation
-            await workItemTrackingApi.updateWorkItem({}, patchDocument, workItemId, project);
+            const workItem = await workItemTrackingApi.updateWorkItem({}, patchDocument, workItemId, project);
+            if (!workItem) {
+                return { content: [{ type: "text", text: "Work item update failed" }], isError: true };
+            }
             return {
                 content: [
                     {
@@ -236,18 +239,10 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider) {
             };
         }
         catch (error) {
-            console.error(`Error linking work item ${workItemId} to PR ${pullRequestId}:`, error);
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
             return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            workItemId,
-                            pullRequestId,
-                            success: false,
-                        }, null, 2),
-                    },
-                ],
+                content: [{ type: "text", text: `Error linking work item to pull request: ${errorMessage}` }],
+                isError: true
             };
         }
     });
@@ -299,17 +294,29 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider) {
         workItemType: z.string().describe("The type of work item to create, e.g., 'Task', 'Bug', etc."),
         fields: z.record(z.string(), z.string()).describe("A record of field names and values to set on the new work item. Each key is a field name, and each value is the corresponding value to set for that field."),
     }, async ({ project, workItemType, fields }) => {
-        const connection = await connectionProvider();
-        const workItemApi = await connection.getWorkItemTrackingApi();
-        const document = Object.entries(fields).map(([key, value]) => ({
-            op: "add",
-            path: `/fields/${key}`,
-            value,
-        }));
-        const newWorkItem = await workItemApi.createWorkItem(null, document, project, workItemType);
-        return {
-            content: [{ type: "text", text: JSON.stringify(newWorkItem, null, 2) }],
-        };
+        try {
+            const connection = await connectionProvider();
+            const workItemApi = await connection.getWorkItemTrackingApi();
+            const document = Object.entries(fields).map(([key, value]) => ({
+                op: "add",
+                path: `/fields/${key}`,
+                value,
+            }));
+            const newWorkItem = await workItemApi.createWorkItem(null, document, project, workItemType);
+            if (!newWorkItem) {
+                return { content: [{ type: "text", text: "Work item was not created" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(newWorkItem, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                content: [{ type: "text", text: `Error creating work item: ${errorMessage}` }],
+                isError: true
+            };
+        }
     });
     server.tool(WORKITEM_TOOLS.get_query, "Get a query by its ID or path.", {
         project: z.string().describe("The name or ID of the Azure DevOps project."),

package/dist/tools.js

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 import { configureCoreTools } from "./tools/core.js";
+import { configureWorkTools } from "./tools/work.js";
 import { configureBuildTools } from "./tools/builds.js";
 import { configureRepoTools } from "./tools/repos.js";
 import { configureWorkItemTools } from "./tools/workitems.js";
@@ -10,6 +11,7 @@ import { configureTestPlanTools } from "./tools/testplans.js";
 import { configureSearchTools } from "./tools/search.js";
 function configureAllTools(server, tokenProvider, connectionProvider) {
     configureCoreTools(server, tokenProvider, connectionProvider);
+    configureWorkTools(server, tokenProvider, connectionProvider);
     configureBuildTools(server, tokenProvider, connectionProvider);
     configureRepoTools(server, tokenProvider, connectionProvider);
     configureWorkItemTools(server, tokenProvider, connectionProvider);

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "0.1.0";
+export const packageVersion = "1.0.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",
   "author": "Microsoft Corporation",
@@ -31,23 +31,22 @@
   },
   "dependencies": {
     "@azure/identity": "^4.10.0",
-    "@modelcontextprotocol/sdk": "1.12.1",
+    "@modelcontextprotocol/sdk": "1.13.0",
     "azure-devops-extension-api": "^4.252.0",
     "azure-devops-extension-sdk": "^4.0.2",
     "azure-devops-node-api": "^15.1.0",
-    "save-dev": "^0.0.1-security",
-    "zod": "^3.25.55",
+    "zod": "^3.25.63",
     "zod-to-json-schema": "^3.24.5"
   },
   "devDependencies": {
     "@modelcontextprotocol/inspector": "^0.14.0",
     "@types/node": "^22",
-    "@types/jest": "^29.5.14",
+    "@types/jest": "^30.0.0",
     "eslint-plugin-header": "^3.1.1",
-    "jest": "^29.7.0",
+    "jest": "^30.0.2",
     "jest-extended": "^6.0.0",
     "shx": "^0.4.0",
-    "ts-jest": "^29.3.4",
+    "ts-jest": "^29.4.0",
     "tsconfig-paths": "^4.2.0",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.32.1"