@azure-devops/mcp 1.3.1-nightly.20250821 → 1.3.1-nightly.20250822

package/dist/tools/auth.js

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
+import { apiVersion } from "../utils.js";
 async function getCurrentUserDetails(tokenProvider, connectionProvider, userAgentProvider) {
     const connection = await connectionProvider();
     const url = `${connection.serverUrl}/_apis/connectionData`;
@@ -18,4 +19,44 @@ async function getCurrentUserDetails(tokenProvider, connectionProvider, userAgen
     }
     return data;
 }
-export { getCurrentUserDetails };
+/**
+ * Searches for identities using Azure DevOps Identity API
+ */
+async function searchIdentities(identity, tokenProvider, connectionProvider, userAgentProvider) {
+    const token = await tokenProvider();
+    const connection = await connectionProvider();
+    const orgName = connection.serverUrl.split("/")[3];
+    const baseUrl = `https://vssps.dev.azure.com/${orgName}/_apis/identities`;
+    const params = new URLSearchParams({
+        "api-version": apiVersion,
+        "searchFilter": "General",
+        "filterValue": identity,
+    });
+    const response = await fetch(`${baseUrl}?${params}`, {
+        headers: {
+            "Authorization": `Bearer ${token.token}`,
+            "Content-Type": "application/json",
+            "User-Agent": userAgentProvider(),
+        },
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`HTTP ${response.status}: ${errorText}`);
+    }
+    return await response.json();
+}
+/**
+ * Gets the user ID from email or unique name using Azure DevOps Identity API
+ */
+async function getUserIdFromEmail(userEmail, tokenProvider, connectionProvider, userAgentProvider) {
+    const identities = await searchIdentities(userEmail, tokenProvider, connectionProvider, userAgentProvider);
+    if (!identities || identities.value?.length === 0) {
+        throw new Error(`No user found with email/unique name: ${userEmail}`);
+    }
+    const firstIdentity = identities.value[0];
+    if (!firstIdentity.id) {
+        throw new Error(`No ID found for user with email/unique name: ${userEmail}`);
+    }
+    return firstIdentity.id;
+}
+export { getCurrentUserDetails, getUserIdFromEmail, searchIdentities };

package/dist/tools/core.js

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 import { z } from "zod";
-import { apiVersion } from "../utils.js";
+import { searchIdentities } from "./auth.js";
 const CORE_TOOLS = {
     list_project_teams: "core_list_project_teams",
     list_projects: "core_list_projects",
@@ -68,27 +68,7 @@ function configureCoreTools(server, tokenProvider, connectionProvider, userAgent
         searchFilter: z.string().describe("Search filter (unique namme, display name, email) to retrieve identity IDs for."),
     }, async ({ searchFilter }) => {
         try {
-            const token = await tokenProvider();
-            const connection = await connectionProvider();
-            const orgName = connection.serverUrl.split("/")[3];
-            const baseUrl = `https://vssps.dev.azure.com/${orgName}/_apis/identities`;
-            const params = new URLSearchParams({
-                "api-version": apiVersion,
-                "searchFilter": "General",
-                "filterValue": searchFilter,
-            });
-            const response = await fetch(`${baseUrl}?${params}`, {
-                headers: {
-                    "Authorization": `Bearer ${token.token}`,
-                    "Content-Type": "application/json",
-                    "User-Agent": userAgentProvider(),
-                },
-            });
-            if (!response.ok) {
-                const errorText = await response.text();
-                throw new Error(`HTTP ${response.status}: ${errorText}`);
-            }
-            const identities = await response.json();
+            const identities = await searchIdentities(searchFilter, tokenProvider, connectionProvider, userAgentProvider);
             if (!identities || identities.value?.length === 0) {
                 return { content: [{ type: "text", text: "No identities found" }], isError: true };
             }

package/dist/tools/repos.js

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 import { PullRequestStatus, GitVersionType, GitPullRequestQueryType, CommentThreadStatus, } from "azure-devops-node-api/interfaces/GitInterfaces.js";
 import { z } from "zod";
-import { getCurrentUserDetails } from "./auth.js";
+import { getCurrentUserDetails, getUserIdFromEmail } from "./auth.js";
 import { getEnumKeys } from "../utils.js";
 const REPO_TOOLS = {
     list_repos_by_project: "repo_list_repos_by_project",
@@ -197,12 +197,13 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
         top: z.number().default(100).describe("The maximum number of pull requests to return."),
         skip: z.number().default(0).describe("The number of pull requests to skip."),
         created_by_me: z.boolean().default(false).describe("Filter pull requests created by the current user."),
+        created_by_user: z.string().optional().describe("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: z.boolean().default(false).describe("Filter pull requests where the current user is a reviewer."),
         status: z
             .enum(getEnumKeys(PullRequestStatus))
             .default("Active")
             .describe("Filter pull requests by status. Defaults to 'Active'."),
-    }, async ({ repositoryId, top, skip, created_by_me, i_am_reviewer, status }) => {
+    }, async ({ repositoryId, top, skip, created_by_me, created_by_user, i_am_reviewer, status }) => {
         const connection = await connectionProvider();
         const gitApi = await connection.getGitApi();
         // Build the search criteria
@@ -210,7 +211,24 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             status: pullRequestStatusStringToInt(status),
             repositoryId: repositoryId,
         };
-        if (created_by_me || i_am_reviewer) {
+        if (created_by_user) {
+            try {
+                const userId = await getUserIdFromEmail(created_by_user, tokenProvider, connectionProvider, userAgentProvider);
+                searchCriteria.creatorId = userId;
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error finding user with email ${created_by_user}: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        else if (created_by_me || i_am_reviewer) {
             const data = await getCurrentUserDetails(tokenProvider, connectionProvider, userAgentProvider);
             const userId = data.authenticatedUser.id;
             if (created_by_me) {
@@ -247,19 +265,37 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
         top: z.number().default(100).describe("The maximum number of pull requests to return."),
         skip: z.number().default(0).describe("The number of pull requests to skip."),
         created_by_me: z.boolean().default(false).describe("Filter pull requests created by the current user."),
+        created_by_user: z.string().optional().describe("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: z.boolean().default(false).describe("Filter pull requests where the current user is a reviewer."),
         status: z
             .enum(getEnumKeys(PullRequestStatus))
             .default("Active")
             .describe("Filter pull requests by status. Defaults to 'Active'."),
-    }, async ({ project, top, skip, created_by_me, i_am_reviewer, status }) => {
+    }, async ({ project, top, skip, created_by_me, created_by_user, i_am_reviewer, status }) => {
         const connection = await connectionProvider();
         const gitApi = await connection.getGitApi();
         // Build the search criteria
         const gitPullRequestSearchCriteria = {
             status: pullRequestStatusStringToInt(status),
         };
-        if (created_by_me || i_am_reviewer) {
+        if (created_by_user) {
+            try {
+                const userId = await getUserIdFromEmail(created_by_user, tokenProvider, connectionProvider, userAgentProvider);
+                gitPullRequestSearchCriteria.creatorId = userId;
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error finding user with email ${created_by_user}: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        else if (created_by_me || i_am_reviewer) {
             const data = await getCurrentUserDetails(tokenProvider, connectionProvider, userAgentProvider);
             const userId = data.authenticatedUser.id;
             if (created_by_me) {

package/dist/tools/wiki.js

@@ -85,22 +85,82 @@ function configureWikiTools(server, tokenProvider, connectionProvider) {
             };
         }
     });
-    server.tool(WIKI_TOOLS.get_wiki_page_content, "Retrieve wiki page content by wikiIdentifier and path.", {
-        wikiIdentifier: z.string().describe("The unique identifier of the wiki."),
-        project: z.string().describe("The project name or ID where the wiki is located."),
-        path: z.string().describe("The path of the wiki page to retrieve content for."),
-    }, async ({ wikiIdentifier, project, path }) => {
+    server.tool(WIKI_TOOLS.get_wiki_page_content, "Retrieve wiki page content. Provide either a 'url' parameter OR the combination of 'wikiIdentifier' and 'project' parameters.", {
+        url: z
+            .string()
+            .optional()
+            .describe("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: z.string().optional().describe("The unique identifier of the wiki. Required if url is not provided."),
+        project: z.string().optional().describe("The project name or ID where the wiki is located. Required if url is not provided."),
+        path: z.string().optional().describe("The path of the wiki page to retrieve content for. Optional, defaults to root page if not provided."),
+    }, async ({ url, wikiIdentifier, project, path }) => {
         try {
+            const hasUrl = !!url;
+            const hasPair = !!wikiIdentifier && !!project;
+            if (hasUrl && hasPair) {
+                return { content: [{ type: "text", text: "Error fetching wiki page content: Provide either 'url' OR 'wikiIdentifier' with 'project', not both." }], isError: true };
+            }
+            if (!hasUrl && !hasPair) {
+                return { content: [{ type: "text", text: "Error fetching wiki page content: You must provide either 'url' OR both 'wikiIdentifier' and 'project'." }], isError: true };
+            }
             const connection = await connectionProvider();
             const wikiApi = await connection.getWikiApi();
-            const stream = await wikiApi.getPageText(project, wikiIdentifier, path, undefined, undefined, true);
-            if (!stream) {
-                return { content: [{ type: "text", text: "No wiki page content found" }], isError: true };
+            let resolvedProject = project;
+            let resolvedWiki = wikiIdentifier;
+            let resolvedPath = path;
+            let pageContent;
+            if (url) {
+                const parsed = parseWikiUrl(url);
+                if ("error" in parsed) {
+                    return { content: [{ type: "text", text: `Error fetching wiki page content: ${parsed.error}` }], isError: true };
+                }
+                resolvedProject = parsed.project;
+                resolvedWiki = parsed.wikiIdentifier;
+                if (parsed.pagePath) {
+                    resolvedPath = parsed.pagePath;
+                }
+                if (parsed.pageId) {
+                    try {
+                        let accessToken;
+                        try {
+                            accessToken = await tokenProvider();
+                        }
+                        catch { }
+                        const baseUrl = connection.serverUrl.replace(/\/$/, "");
+                        const restUrl = `${baseUrl}/${resolvedProject}/_apis/wiki/wikis/${resolvedWiki}/pages/${parsed.pageId}?includeContent=true&api-version=7.1`;
+                        const resp = await fetch(restUrl, {
+                            headers: accessToken?.token ? { Authorization: `Bearer ${accessToken.token}` } : {},
+                        });
+                        if (resp.ok) {
+                            const json = await resp.json();
+                            if (json && typeof json.content === "string") {
+                                pageContent = json.content;
+                            }
+                            else if (json && json.path) {
+                                resolvedPath = json.path;
+                            }
+                        }
+                        else if (resp.status === 404) {
+                            return { content: [{ type: "text", text: `Error fetching wiki page content: Page with id ${parsed.pageId} not found` }], isError: true };
+                        }
+                    }
+                    catch { }
+                }
             }
-            const content = await streamToString(stream);
-            return {
-                content: [{ type: "text", text: JSON.stringify(content, null, 2) }],
-            };
+            if (!pageContent) {
+                if (!resolvedPath) {
+                    resolvedPath = "/";
+                }
+                if (!resolvedProject || !resolvedWiki) {
+                    return { content: [{ type: "text", text: "Project and wikiIdentifier must be defined to fetch wiki page content." }], isError: true };
+                }
+                const stream = await wikiApi.getPageText(resolvedProject, resolvedWiki, resolvedPath, undefined, undefined, true);
+                if (!stream) {
+                    return { content: [{ type: "text", text: "No wiki page content found" }], isError: true };
+                }
+                pageContent = await streamToString(stream);
+            }
+            return { content: [{ type: "text", text: JSON.stringify(pageContent, null, 2) }] };
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
@@ -224,4 +284,47 @@ function streamToString(stream) {
         stream.on("error", reject);
     });
 }
+// Helper to parse Azure DevOps wiki page URLs.
+// Supported examples:
+//  - https://dev.azure.com/org/project/_wiki/wikis/wikiIdentifier?wikiVersion=GBmain&pagePath=%2FHome
+//  - https://dev.azure.com/org/project/_wiki/wikis/wikiIdentifier/123/Title-Of-Page
+// Returns either a structured object OR an error message inside { error }.
+function parseWikiUrl(url) {
+    try {
+        const u = new URL(url);
+        // Path segments after host
+        // Expect pattern: /{project}/_wiki/wikis/{wikiIdentifier}[/{pageId}/...]
+        const segments = u.pathname.split("/").filter(Boolean); // remove empty
+        const idx = segments.findIndex((s) => s === "_wiki");
+        if (idx < 1 || segments[idx + 1] !== "wikis") {
+            return { error: "URL does not match expected wiki pattern (missing /_wiki/wikis/ segment)." };
+        }
+        const project = segments[idx - 1];
+        const wikiIdentifier = segments[idx + 2];
+        if (!project || !wikiIdentifier) {
+            return { error: "Could not extract project or wikiIdentifier from URL." };
+        }
+        // Query form with pagePath
+        const pagePathParam = u.searchParams.get("pagePath");
+        if (pagePathParam) {
+            let decoded = decodeURIComponent(pagePathParam);
+            if (!decoded.startsWith("/"))
+                decoded = "/" + decoded;
+            return { project, wikiIdentifier, pagePath: decoded };
+        }
+        // Path ID form: .../wikis/{wikiIdentifier}/{pageId}/...
+        const afterWiki = segments.slice(idx + 3); // elements after wikiIdentifier
+        if (afterWiki.length >= 1) {
+            const maybeId = parseInt(afterWiki[0], 10);
+            if (!isNaN(maybeId)) {
+                return { project, wikiIdentifier, pageId: maybeId };
+            }
+        }
+        // If nothing else specified, treat as root page
+        return { project, wikiIdentifier, pagePath: "/" };
+    }
+    catch {
+        return { error: "Invalid URL format." };
+    }
+}
 export { WIKI_TOOLS, configureWikiTools };

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "1.3.1-nightly.20250821";
+export const packageVersion = "1.3.1-nightly.20250822";

package/package.json

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