@azure-devops/mcp 1.3.1 → 2.0.0-nightly.20250825

package/LICENSE.md

@@ -1,21 +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
+    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

@@ -16,7 +16,7 @@ This TypeScript project provides a **local** MCP server for Azure DevOps, enabli
 3. [⚙️ Supported Tools](#️-supported-tools)
 4. [🔌 Installation & Getting Started](#-installation--getting-started)
 5. [📝 Troubleshooting](#-troubleshooting)
-6. [🎩 Examples & Best Practices](#-samples--best-practices)
+6. [🎩 Examples & Best Practices](#-examples--best-practices)
 7. [🙋‍♀️ Frequently Asked Questions](#️-frequently-asked-questions)
 8. [📌 Contributing](#-contributing)
 
@@ -33,6 +33,10 @@ 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
 
@@ -74,11 +78,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 +133,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.
@@ -196,19 +204,41 @@ In your project, add a `.vscode\mcp.json` file with the following content:
 }
 ```
 
+🔥 To stay up to date with the latest features, you can use our nightly builds. Simply update your `mcp.json` configuration to use `@azure-devops/mcp@next`. Here is an updated example:
+
+```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@next", "${input:ado_org}"]
+    }
+  }
+}
+```
+
 Save the file, then click 'Start'.
 
-<img src="./docs/media/start-mcp-server.gif" alt="start mcp server" width="250"/>
+![start mcp server](./docs/media/start-mcp-server.gif)
 
 In chat, switch to [Agent Mode](https://code.visualstudio.com/blogs/2025/02/24/introducing-copilot-agent-mode).
 
 Click "Select Tools" and choose the available tools.
 
-<img src="./docs/media/configure-mcp-server-tools.gif" alt="configure mcp server tools" width="300"/>
+![configure mcp server tools](./docs/media/configure-mcp-server-tools.gif)
 
 Open GitHub Copilot Chat and try a prompt like `List ADO projects`.
 
-> 💥 We strongly recommend creating a `.github\copilot-instructions.md` in your project and copying the contents from this [copilot-instructions.md](./.github/copilot-instructions.md) file. This will enhance your experience using the Azure DevOps MCP Server with GitHub Copilot Chat.
+> 💥 We strongly recommend creating a `.github\copilot-instructions.md` in your project. This will enhance your experience using the Azure DevOps MCP Server with GitHub Copilot Chat.
+> To start, just include "`This project uses Azure DevOps. Always check to see if the Azure DevOps MCP server has a tool relevant to the user's request`" in your copilot instructions file.
 
 See the [getting started documentation](./docs/GETTINGSTARTED.md) to use our MCP Server with other tools such as Visual Studio 2022, Claude Code, and Cursor.
 

package/dist/index.js

@@ -11,16 +11,25 @@ import { configurePrompts } from "./prompts.js";
 import { configureAllTools } from "./tools.js";
 import { UserAgentComposer } from "./useragent.js";
 import { packageVersion } from "./version.js";
+import { DomainsManager } from "./shared/domains.js";
 // Parse command line arguments using yargs
 const argv = yargs(hideBin(process.argv))
     .scriptName("mcp-server-azuredevops")
     .usage("Usage: $0 <organization> [options]")
     .version(packageVersion)
-    .command("$0 <organization>", "Azure DevOps MCP Server", (yargs) => {
+    .command("$0 <organization> [options]", "Azure DevOps MCP Server", (yargs) => {
     yargs.positional("organization", {
         describe: "Azure DevOps organization name",
         type: "string",
+        demandOption: true,
     });
+})
+    .option("domains", {
+    alias: "d",
+    describe: "Domain(s) to enable: 'all' for everything, or specific domains like 'repositories builds work'. Defaults to 'all'.",
+    type: "string",
+    array: true,
+    default: "all",
 })
     .option("tenant", {
     alias: "t",
@@ -29,9 +38,11 @@ const argv = yargs(hideBin(process.argv))
 })
     .help()
     .parseSync();
-export const orgName = argv.organization;
 const tenantId = argv.tenant;
+export const orgName = argv.organization;
 const orgUrl = "https://dev.azure.com/" + orgName;
+const domainsManager = new DomainsManager(argv.domains);
+export const enabledDomains = domainsManager.getEnabledDomains();
 async function getAzureDevOpsToken() {
     if (process.env.ADO_MCP_AZURE_TOKEN_CREDENTIALS) {
         process.env.AZURE_TOKEN_CREDENTIALS = process.env.ADO_MCP_AZURE_TOKEN_CREDENTIALS;
@@ -73,7 +84,7 @@ async function main() {
         userAgentComposer.appendMcpClientInfo(server.server.getClientVersion());
     };
     configurePrompts(server);
-    configureAllTools(server, getAzureDevOpsToken, getAzureDevOpsClient(userAgentComposer), () => userAgentComposer.userAgent);
+    configureAllTools(server, getAzureDevOpsToken, getAzureDevOpsClient(userAgentComposer), () => userAgentComposer.userAgent, enabledDomains);
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/prompts.js

@@ -2,9 +2,9 @@
 // Licensed under the MIT License.
 import { z } from "zod";
 import { CORE_TOOLS } from "./tools/core.js";
-import { WORKITEM_TOOLS } from "./tools/workitems.js";
+import { WORKITEM_TOOLS } from "./tools/work-items.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/shared/domains.js

@@ -0,0 +1,122 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Available Azure DevOps MCP domains
+ */
+export var Domain;
+(function (Domain) {
+    Domain["ADVANCED_SECURITY"] = "advanced-security";
+    Domain["BUILDS"] = "builds";
+    Domain["CORE"] = "core";
+    Domain["RELEASES"] = "releases";
+    Domain["REPOSITORIES"] = "repositories";
+    Domain["SEARCH"] = "search";
+    Domain["TEST_PLANS"] = "test-plans";
+    Domain["WIKI"] = "wiki";
+    Domain["WORK"] = "work";
+    Domain["WORK_ITEMS"] = "work-items";
+})(Domain || (Domain = {}));
+export const ALL_DOMAINS = "all";
+/**
+ * Manages domain parsing and validation for Azure DevOps MCP server tools
+ */
+export class DomainsManager {
+    static AVAILABLE_DOMAINS = Object.values(Domain);
+    enabledDomains;
+    constructor(domainsInput) {
+        this.enabledDomains = new Set();
+        const normalizedInput = DomainsManager.parseDomainsInput(domainsInput);
+        this.parseDomains(normalizedInput);
+    }
+    /**
+     * Parse and validate domains from input
+     * @param domainsInput - Either "all", single domain name, array of domain names, or undefined (defaults to "all")
+     */
+    parseDomains(domainsInput) {
+        if (!domainsInput) {
+            this.enableAllDomains();
+            return;
+        }
+        if (Array.isArray(domainsInput)) {
+            this.handleArrayInput(domainsInput);
+            return;
+        }
+        this.handleStringInput(domainsInput);
+    }
+    handleArrayInput(domainsInput) {
+        if (domainsInput.length === 0 || domainsInput.includes(ALL_DOMAINS)) {
+            this.enableAllDomains();
+            return;
+        }
+        if (domainsInput.length === 1 && domainsInput[0] === ALL_DOMAINS) {
+            this.enableAllDomains();
+            return;
+        }
+        const domains = domainsInput.map((d) => d.trim().toLowerCase());
+        this.validateAndAddDomains(domains);
+    }
+    handleStringInput(domainsInput) {
+        if (domainsInput === ALL_DOMAINS) {
+            this.enableAllDomains();
+            return;
+        }
+        const domains = [domainsInput.trim().toLowerCase()];
+        this.validateAndAddDomains(domains);
+    }
+    validateAndAddDomains(domains) {
+        const availableDomainsAsStringArray = Object.values(Domain);
+        domains.forEach((domain) => {
+            if (availableDomainsAsStringArray.includes(domain)) {
+                this.enabledDomains.add(domain);
+            }
+            else if (domain === ALL_DOMAINS) {
+                this.enableAllDomains();
+            }
+            else {
+                console.error(`Error: Specified invalid domain '${domain}'. Please specify exactly as available domains: ${Object.values(Domain).join(", ")}`);
+            }
+        });
+        if (this.enabledDomains.size === 0) {
+            this.enableAllDomains();
+        }
+    }
+    enableAllDomains() {
+        Object.values(Domain).forEach((domain) => this.enabledDomains.add(domain));
+    }
+    /**
+     * Check if a specific domain is enabled
+     * @param domain - Domain name to check
+     * @returns true if domain is enabled
+     */
+    isDomainEnabled(domain) {
+        return this.enabledDomains.has(domain);
+    }
+    /**
+     * Get all enabled domains
+     * @returns Set of enabled domain names
+     */
+    getEnabledDomains() {
+        return new Set(this.enabledDomains);
+    }
+    /**
+     * Get list of all available domains
+     * @returns Array of available domain names
+     */
+    static getAvailableDomains() {
+        return Object.values(Domain);
+    }
+    /**
+     * Parse domains input from string or array to a normalized array of strings
+     * @param domainsInput - Domains input to parse
+     * @returns Normalized array of domain strings
+     */
+    static parseDomainsInput(domainsInput) {
+        if (!domainsInput) {
+            return [];
+        }
+        if (typeof domainsInput === "string") {
+            return domainsInput.split(",").map((d) => d.trim().toLowerCase());
+        }
+        return domainsInput.map((d) => d.trim().toLowerCase());
+    }
+}

package/dist/tools/auth.js

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-async function getCurrentUserDetails(tokenProvider, connectionProvider) {
+import { apiVersion } from "../utils.js";
+async function getCurrentUserDetails(tokenProvider, connectionProvider, userAgentProvider) {
     const connection = await connectionProvider();
     const url = `${connection.serverUrl}/_apis/connectionData`;
     const token = (await tokenProvider()).token;
@@ -9,6 +10,7 @@ async function getCurrentUserDetails(tokenProvider, connectionProvider) {
         headers: {
             "Authorization": `Bearer ${token}`,
             "Content-Type": "application/json",
+            "User-Agent": userAgentProvider(),
         },
     });
     const data = await response.json();
@@ -17,4 +19,44 @@ async function getCurrentUserDetails(tokenProvider, connectionProvider) {
     }
     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/builds.js

@@ -15,7 +15,7 @@ const BUILD_TOOLS = {
     get_status: "build_get_status",
     update_build_stage: "build_update_build_stage",
 };
-function configureBuildTools(server, tokenProvider, connectionProvider) {
+function configureBuildTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     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"),
@@ -191,6 +191,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider) {
             headers: {
                 "Content-Type": "application/json",
                 "Authorization": `Bearer ${token.token}`,
+                "User-Agent": userAgentProvider(),
             },
             body: JSON.stringify(body),
         });

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",
@@ -11,7 +11,7 @@ function filterProjectsByName(projects, projectNameFilter) {
     const lowerCaseFilter = projectNameFilter.toLowerCase();
     return projects.filter((project) => project.name?.toLowerCase().includes(lowerCaseFilter));
 }
-function configureCoreTools(server, tokenProvider, connectionProvider) {
+function configureCoreTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     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."),
@@ -68,26 +68,7 @@ function configureCoreTools(server, tokenProvider, connectionProvider) {
         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",
-                },
-            });
-            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 → repositories.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",
@@ -73,7 +73,7 @@ function filterReposByName(repositories, repoNameFilter) {
     const filteredByName = repositories?.filter((repo) => repo.name?.toLowerCase().includes(lowerCaseFilter));
     return filteredByName;
 }
-function configureRepoTools(server, tokenProvider, connectionProvider) {
+function configureRepoTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(REPO_TOOLS.create_pull_request, "Create a new pull request.", {
         repositoryId: z.string().describe("The ID of the repository where the pull request will be created."),
         sourceRefName: z.string().describe("The source branch name for the pull request, e.g., 'refs/heads/feature-branch'."),
@@ -197,12 +197,13 @@ function configureRepoTools(server, tokenProvider, connectionProvider) {
         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,8 +211,25 @@ function configureRepoTools(server, tokenProvider, connectionProvider) {
             status: pullRequestStatusStringToInt(status),
             repositoryId: repositoryId,
         };
-        if (created_by_me || i_am_reviewer) {
-            const data = await getCurrentUserDetails(tokenProvider, connectionProvider);
+        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) {
                 searchCriteria.creatorId = userId;
@@ -235,6 +253,8 @@ function configureRepoTools(server, tokenProvider, connectionProvider) {
             creationDate: pr.creationDate,
             title: pr.title,
             isDraft: pr.isDraft,
+            sourceRefName: pr.sourceRefName,
+            targetRefName: pr.targetRefName,
         }));
         return {
             content: [{ type: "text", text: JSON.stringify(filteredPullRequests, null, 2) }],
@@ -245,20 +265,38 @@ function configureRepoTools(server, tokenProvider, connectionProvider) {
         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) {
-            const data = await getCurrentUserDetails(tokenProvider, connectionProvider);
+        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) {
                 gitPullRequestSearchCriteria.creatorId = userId;
@@ -282,6 +320,8 @@ function configureRepoTools(server, tokenProvider, connectionProvider) {
             creationDate: pr.creationDate,
             title: pr.title,
             isDraft: pr.isDraft,
+            sourceRefName: pr.sourceRefName,
+            targetRefName: pr.targetRefName,
         }));
         return {
             content: [{ type: "text", text: JSON.stringify(filteredPullRequests, null, 2) }],
@@ -346,10 +386,11 @@ function configureRepoTools(server, tokenProvider, connectionProvider) {
     server.tool(REPO_TOOLS.list_branches_by_repo, "Retrieve a list of branches for a given repository.", {
         repositoryId: z.string().describe("The ID of the repository where the branches are located."),
         top: z.number().default(100).describe("The maximum number of branches to return. Defaults to 100."),
-    }, async ({ repositoryId, top }) => {
+        filterContains: z.string().optional().describe("Filter to find branches that contain this string in their name."),
+    }, async ({ repositoryId, top, filterContains }) => {
         const connection = await connectionProvider();
         const gitApi = await connection.getGitApi();
-        const branches = await gitApi.getRefs(repositoryId, undefined);
+        const branches = await gitApi.getRefs(repositoryId, undefined, "heads/", undefined, undefined, undefined, undefined, undefined, filterContains);
         const filteredBranches = branchesFilterOutIrrelevantProperties(branches, top);
         return {
             content: [{ type: "text", text: JSON.stringify(filteredBranches, null, 2) }],
@@ -358,10 +399,11 @@ function configureRepoTools(server, tokenProvider, connectionProvider) {
     server.tool(REPO_TOOLS.list_my_branches_by_repo, "Retrieve a list of my branches for a given repository Id.", {
         repositoryId: z.string().describe("The ID of the repository where the branches are located."),
         top: z.number().default(100).describe("The maximum number of branches to return."),
-    }, async ({ repositoryId, top }) => {
+        filterContains: z.string().optional().describe("Filter to find branches that contain this string in their name."),
+    }, async ({ repositoryId, top, filterContains }) => {
         const connection = await connectionProvider();
         const gitApi = await connection.getGitApi();
-        const branches = await gitApi.getRefs(repositoryId, undefined, undefined, undefined, undefined, true);
+        const branches = await gitApi.getRefs(repositoryId, undefined, "heads/", undefined, undefined, true, undefined, undefined, filterContains);
         const filteredBranches = branchesFilterOutIrrelevantProperties(branches, top);
         return {
             content: [{ type: "text", text: JSON.stringify(filteredBranches, null, 2) }],
@@ -388,8 +430,8 @@ function configureRepoTools(server, tokenProvider, connectionProvider) {
     }, async ({ repositoryId, branchName }) => {
         const connection = await connectionProvider();
         const gitApi = await connection.getGitApi();
-        const branches = await gitApi.getRefs(repositoryId);
-        const branch = branches?.find((branch) => branch.name === `refs/heads/${branchName}`);
+        const branches = await gitApi.getRefs(repositoryId, undefined, "heads/", false, false, undefined, false, undefined, branchName);
+        const branch = branches.find((branch) => branch.name === `refs/heads/${branchName}` || branch.name === branchName);
         if (!branch) {
             return {
                 content: [
@@ -398,6 +440,7 @@ function configureRepoTools(server, tokenProvider, connectionProvider) {
                         text: `Branch ${branchName} not found in repository ${repositoryId}`,
                     },
                 ],
+                isError: true,
             };
         }
         return {

package/dist/tools/{testplans.js → test-plans.js}

@@ -79,7 +79,10 @@ function configureTestPlanTools(server, tokenProvider, connectionProvider) {
     server.tool(Test_Plan_Tools.create_test_case, "Creates a new test case work item.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         title: z.string().describe("The title of the test case."),
-        steps: z.string().optional().describe("The steps to reproduce the test case. Make sure to format each step as '1. Step one|Expected result one\n2. Step two|Expected result two"),
+        steps: z
+            .string()
+            .optional()
+            .describe("The steps to reproduce the test case. Make sure to format each step as '1. Step one|Expected result one\n2. Step two|Expected result two. USE '|' as the delimiter between step and expected result. DO NOT use '|' in the description of the step or expected result."),
         priority: z.number().optional().describe("The priority of the test case."),
         areaPath: z.string().optional().describe("The area path for the test case."),
         iterationPath: z.string().optional().describe("The iteration path for the test case."),