@azure-devops/mcp 1.3.1-nightly.20250813 → 1.3.1-nightly.20250815

package/README.md

@@ -33,11 +33,25 @@ The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prom
 - "List iterations for project 'Contoso'"
 - "List my work items for project 'Contoso'"
 - "List work items in current iteration for 'Contoso' project and 'Contoso Team'"
+- "List all wikis in the 'Contoso' project"
+- "Create a wiki page '/Architecture/Overview' with content about system design"
+- "Update the wiki page '/Getting Started' with new onboarding instructions"
+- "Get the content of the wiki page '/API/Authentication' from the Documentation wiki"
 
 ## 🏆 Expectations
 
 The Azure DevOps MCP Server is built from tools that are concise, simple, focused, and easy to use—each designed for a specific scenario. We intentionally avoid complex tools that try to do too much. The goal is to provide a thin abstraction layer over the REST APIs, making data access straightforward and letting the language model handle complex reasoning.
 
+## ✨ Recent Enhancements
+
+### 📖 **Enhanced Wiki Support**
+
+- **Full Content Management**: Create and update wiki pages with complete content using the native Azure DevOps REST API
+- **Automatic ETag Handling**: Safe updates with built-in conflict resolution for concurrent edits
+- **Immediate Visibility**: Pages appear instantly in the Azure DevOps wiki interface
+- **Hierarchical Structure**: Support for organized page structures within existing folder hierarchies
+- **Robust Error Handling**: Comprehensive error management for various HTTP status codes and edge cases
+
 ## ⚙️ Supported Tools
 
 Interact with these Azure DevOps services:
@@ -74,11 +88,7 @@ Interact with these Azure DevOps services:
 - **wit_update_work_items_batch**: Update work items in batch.
 - **wit_work_items_link**: Link work items together in batch.
 - **wit_work_item_unlink**: Unlink one or many links from a work item.
-
-#### Deprecated Tools
-
-- **wit_add_child_work_item**: Replaced by `wit_add_child_work_items` to allow creating one or more child items per call.
-- **wit_close_and_link_workitem_duplicates**: This tool is no longer needed. Finding and marking duplicates can be done with other tools.
+- **wit_add_artifact_link**: Link to artifacts like branch, pull request, commit, and build.
 
 ### 📁 Repositories
 
@@ -133,6 +143,14 @@ Interact with these Azure DevOps services:
 - **testplan_list_test_cases**: Get a list of test cases in the test plan.
 - **testplan_show_test_results_from_build_id**: Get a list of test results for a given project and build ID.
 
+### 📖 Wiki
+
+- **wiki_list_wikis**: Retrieve a list of wikis for an organization or project.
+- **wiki_get_wiki**: Get the wiki by wikiIdentifier.
+- **wiki_list_pages**: Retrieve a list of wiki pages for a specific wiki and project.
+- **wiki_get_page_content**: Retrieve wiki page content by wikiIdentifier and path.
+- **wiki_create_or_update_page**: Create or update wiki pages with full content support.
+
 ### 🔎 Search
 
 - **search_code**: Get code search results for a given search text.

package/dist/prompts.js

@@ -4,7 +4,7 @@ import { z } from "zod";
 import { CORE_TOOLS } from "./tools/core.js";
 import { WORKITEM_TOOLS } from "./tools/workitems.js";
 function configurePrompts(server) {
-    server.prompt("listProjects", "Lists all projects in the Azure DevOps organization.", {}, () => ({
+    server.prompt("Projects", "Lists all projects in the Azure DevOps organization.", {}, () => ({
         messages: [
             {
                 role: "user",
@@ -12,13 +12,13 @@ function configurePrompts(server) {
                     type: "text",
                     text: String.raw `
 # Task
-Use the '${CORE_TOOLS.list_projects}' tool to retrieve all projects in the current Azure DevOps organization.
-Present the results in a table with the following columns: Project ID, Name, and Description.`,
+Use the '${CORE_TOOLS.list_projects}' tool to retrieve all 'wellFormed' projects in the current Azure DevOps organization.
+Present the results in alphabetical order in a table with the following columns: Name and ID.`,
                 },
             },
         ],
     }));
-    server.prompt("listTeams", "Retrieves all teams for a given Azure DevOps project.", { project: z.string() }, ({ project }) => ({
+    server.prompt("Teams", "Retrieves all teams for a given Azure DevOps project.", { project: z.string() }, ({ project }) => ({
         messages: [
             {
                 role: "user",
@@ -27,7 +27,7 @@ Present the results in a table with the following columns: Project ID, Name, and
                     text: String.raw `
   # Task
   Use the '${CORE_TOOLS.list_project_teams}' tool to retrieve all teams for the project '${project}'.
-  Present the results in a table with the following columns: Team ID, and Name`,
+  Present the results in alphabetical order in a table with the following columns: Name and Id`,
                 },
             },
         ],

package/dist/tools/wiki.js

@@ -6,6 +6,7 @@ const WIKI_TOOLS = {
     get_wiki: "wiki_get_wiki",
     list_wiki_pages: "wiki_list_pages",
     get_wiki_page_content: "wiki_get_page_content",
+    create_or_update_page: "wiki_create_or_update_page",
 };
 function configureWikiTools(server, tokenProvider, connectionProvider) {
     server.tool(WIKI_TOOLS.get_wiki, "Get the wiki by wikiIdentifier", {
@@ -109,6 +110,110 @@ function configureWikiTools(server, tokenProvider, connectionProvider) {
             };
         }
     });
+    server.tool(WIKI_TOOLS.create_or_update_page, "Create or update a wiki page with content.", {
+        wikiIdentifier: z.string().describe("The unique identifier or name of the wiki."),
+        path: z.string().describe("The path of the wiki page (e.g., '/Home' or '/Documentation/Setup')."),
+        content: z.string().describe("The content of the wiki page in markdown format."),
+        project: z.string().optional().describe("The project name or ID where the wiki is located. If not provided, the default project will be used."),
+        etag: z.string().optional().describe("ETag for editing existing pages (optional, will be fetched if not provided)."),
+    }, async ({ wikiIdentifier, path, content, project, etag }) => {
+        try {
+            const connection = await connectionProvider();
+            const accessToken = await tokenProvider();
+            // Normalize the path
+            const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+            const encodedPath = encodeURIComponent(normalizedPath);
+            // Build the URL for the wiki page API
+            const baseUrl = connection.serverUrl;
+            const projectParam = project || "";
+            const url = `${baseUrl}/${projectParam}/_apis/wiki/wikis/${wikiIdentifier}/pages?path=${encodedPath}&api-version=7.1`;
+            // First, try to create a new page (PUT without ETag)
+            try {
+                const createResponse = await fetch(url, {
+                    method: "PUT",
+                    headers: {
+                        "Authorization": `Bearer ${accessToken.token}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({ content: content }),
+                });
+                if (createResponse.ok) {
+                    const result = await createResponse.json();
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Successfully created wiki page at path: ${normalizedPath}. Response: ${JSON.stringify(result, null, 2)}`,
+                            },
+                        ],
+                    };
+                }
+                // If creation failed with 409 (Conflict) or 500 (Page exists), try to update it
+                if (createResponse.status === 409 || createResponse.status === 500) {
+                    // Page exists, we need to get the ETag and update it
+                    let currentEtag = etag;
+                    if (!currentEtag) {
+                        // Fetch current page to get ETag
+                        const getResponse = await fetch(url, {
+                            method: "GET",
+                            headers: {
+                                Authorization: `Bearer ${accessToken.token}`,
+                            },
+                        });
+                        if (getResponse.ok) {
+                            currentEtag = getResponse.headers.get("etag") || getResponse.headers.get("ETag") || undefined;
+                            if (!currentEtag) {
+                                const pageData = await getResponse.json();
+                                currentEtag = pageData.eTag;
+                            }
+                        }
+                        if (!currentEtag) {
+                            throw new Error("Could not retrieve ETag for existing page");
+                        }
+                    }
+                    // Now update the existing page with ETag
+                    const updateResponse = await fetch(url, {
+                        method: "PUT",
+                        headers: {
+                            "Authorization": `Bearer ${accessToken.token}`,
+                            "Content-Type": "application/json",
+                            "If-Match": currentEtag,
+                        },
+                        body: JSON.stringify({ content: content }),
+                    });
+                    if (updateResponse.ok) {
+                        const result = await updateResponse.json();
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Successfully updated wiki page at path: ${normalizedPath}. Response: ${JSON.stringify(result, null, 2)}`,
+                                },
+                            ],
+                        };
+                    }
+                    else {
+                        const errorText = await updateResponse.text();
+                        throw new Error(`Failed to update page (${updateResponse.status}): ${errorText}`);
+                    }
+                }
+                else {
+                    const errorText = await createResponse.text();
+                    throw new Error(`Failed to create page (${createResponse.status}): ${errorText}`);
+                }
+            }
+            catch (fetchError) {
+                throw fetchError;
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error creating/updating wiki page: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
 }
 function streamToString(stream) {
     return new Promise((resolve, reject) => {

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "1.3.1-nightly.20250813";
+export const packageVersion = "1.3.1-nightly.20250815";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "1.3.1-nightly.20250813",
+  "version": "1.3.1-nightly.20250815",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",
   "author": "Microsoft Corporation",