Azure DevOps MCP Server v2.7.0-liventus.15

A Model Context Protocol server that brings Azure DevOps context to AI assistants. Browse projects, work items, repositories, pipelines, wikis, and more using natural language — powered by your own Microsoft identity.

Endpoints

POST/org/{orgName}/mcp
Org-scoped MCP endpoint — organization name is part of the URL. Best for single-org configurations.
POST/mcp
Multi-org MCP endpoint — every tool accepts an organization parameter. Best for general-purpose clients.
GET/health
Health check — returns { "status": "ok", "version": "..." }.

Quick Start: VS Code + GitHub Copilot

Add a .vscode/mcp.json file to your project:

Org-scoped (single organization)

{
  "servers": {
    "ado": {
      "type": "http",
      "url": "https://ado-mcp.liventus.com/org/{your-org}/mcp"
    }
  }
}

Replace {your-org} with your Azure DevOps organization name (e.g. Contoso).

Multi-org (generic endpoint)

{
  "servers": {
    "ado": {
      "type": "http",
      "url": "https://ado-mcp.liventus.com/mcp"
    }
  }
}
On first connection VS Code will open a browser window for Microsoft account sign-in. Your existing Microsoft 365 / Entra ID session may authenticate automatically.

Quick Start: Claude Code

Add a .mcp.json file to your project:

Org-scoped (single organization)

{
  "mcpServers": {
    "ado": {
      "type": "http",
      "url": "https://ado-mcp.liventus.com/org/{your-org}/mcp"
    }
  }
}

Replace {your-org} with your Azure DevOps organization name (e.g. Contoso).

Multi-org (recommended for general use)

{
  "mcpServers": {
    "ado": {
      "type": "http",
      "url": "https://ado-mcp.liventus.com/mcp"
    }
  }
}

With the multi-org endpoint you can say "List my open tasks for Contoso" — the LLM calls ado_list_organizations, matches the name, then queries work items with the correct org identifier.

Authentication

Authentication is handled via Microsoft Entra ID OAuth. No personal access tokens or environment variables are required for the hosted server — just sign in with your Microsoft account and your existing Azure DevOps permissions apply automatically.

Documentation

Full documentation is available at https://ado-mcp.liventus.com/README.md.