ado-mcp-server

What is ado-mcp-server?

ado-mcp-server is a Model Context Protocol (MCP) server for Azure DevOps. It integrates with the Azure DevOps Work Item Tracking (WIT) REST API, providing create, get, update, delete, list, query, batch, revisions, comments, attachments, and relation operations. It is built with the official @modelcontextprotocol/sdk and targeted at developers and AI agents that manage work items programmatically.

How to use ado-mcp-server?

Clone the repository, install dependencies with npm install, and start the server with npm start. It runs over STDIO and can be integrated with MCP-compatible clients. Testing can be done using the MCP Inspector: npx @modelcontextprotocol/inspector. No additional configuration is required for basic usage.

Key features of ado-mcp-server

• Full support for Azure DevOps WIT REST API endpoints
• Extensible architecture for registering project and work item tools
• Provides linkWorkItems and unlinkWorkItems tools with configurable link types
• Runs over STDIO for integration with other systems
• Built using the official @modelcontextprotocol/sdk and zod for validation

Use cases of ado-mcp-server

• Link two Azure DevOps work items as parent-child or with custom link types
• Remove existing links between work items
• Automate work item creation, updates, and queries via MCP clients
• Integrate with AI assistants to manage Azure DevOps work items conversationally
• Extend the server with custom tools by adding modules to the features/ directory

FAQ from ado-mcp-server

What runtime and dependencies are required?

Node.js version 16 or later and npm. The key dependencies are @modelcontextprotocol/sdk and zod.

Does ado-mcp-server require any configuration?

No additional configuration is required for basic usage. You can extend functionality by adding new tools in the features directory.

How can I test the server?

Use the Model Context Protocol Inspector: npx @modelcontextprotocol/inspector.

What transport does ado-mcp-server use?

It runs over STDIO.

Is ado-mcp-server affiliated with Microsoft or Azure DevOps?

No. The project is not affiliated with Microsoft or Azure DevOps.