⭐ Azure DevOps MCP Server

[!IMPORTANT] The Azure DevOps Remote MCP Server is now available in public preview for all organizations. We recommend migrating to the Remote MCP Server going forward.

Learn more

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

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)

The Azure DevOps Remote MCP Server is now available in public preview.

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.

[!WARNING] Internal Microsoft users of the Remote MCP Server should not create issues in this repository. Please use the dedicated Teams channel instead.

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

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.

After saving .vscode/mcp.json, start the server from the MCP view in

... View full README on GitHub