⭐ Azure DevOps MCP Server

[!WARNING] We recently completed a full tool consolidation that includes renaming of existing tools. Please see the Toolset documentation for the complete list of new tool names.

If this is a breaking change for your agents or skills, you can temporarily pin the version to @azure-devops/[email protected]

This project provides Azure DevOps MCP tooling for AI agents, with a remote-first onboarding experience and a local server option when you need it.

📄 Table of Contents

[!IMPORTANT] We recommend using the Remote MCP Server instead of this local server. It requires no installation and gets new features first.

Learn more

1. 📺 Overview
2. 🏆 Expectations
3. 🚀 Remote MCP Server (Recommended)
4. ⚙️ Supported Tools
5. 🔌 Local MCP Server Installation (Optional)
6. 🌏 Using Domains (local)
7. 🐥 Project and Team Defaults (local)
8. 📝 Troubleshooting
9. 🎩 Examples & Best Practices
10. 🙋‍♀️ Frequently Asked Questions
11. 📌 Contributing

📺 Overview

The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prompts like:

• "List my ADO projects"
• "List ADO Builds for 'Contoso'"
• "List ADO Repos for 'Contoso'"
• "List test plans for 'Contoso'"
• "List teams for project 'Contoso'"
• "List iterations for project 'Contoso'"
• "List my work items for project 'Contoso'"
• "List work items in current iteration for 'Contoso' project and 'Contoso Team'"
• "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 around tools that are concise, simple, focused, and easy to use, with each one designed for a specific scenario. We intentionally avoid creating complex tools that try to do too much. The goal is to provide a thin abstraction layer over the REST APIs that makes data access straightforward while allowing the language model to handle the more complex reasoning.

🚀 Remote MCP Server (Recommended)

For complete instructions, see the Remote MCP Server onboarding documentation.

Over time, the Remote MCP Server will replace this local MCP Server. We will continue to support the local server for now, but future investments will primarily focus on the remote experience.

We encourage all users of the local MCP Server to begin migrating to the Remote MCP Server.

If you encounter issues with tools, need support, or have a feature request, you can report an issue using the Remote MCP Server issue template. During the preview period, we will track Remote MCP Server issues through this repository.

Quick start with .vscode/mcp.json

Use this configuration to connect directly to the Azure DevOps-hosted endpoint using streamable HTTP transport:

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http"
    }
  },
  "inputs": []
}

See documentation for additional configuration options.