Which integrations are available for this server?

Provides comprehensive tools for managing Git repositories, including branch creation, commit searching, and repository structure exploration. Enables management of Markdown-native wikis, allowing for the creation, updating, and retrieval of wiki pages and directory structures.

adtk

by zach-snell

Overview Schema Source Related Servers Discussions Admin

Remote

adtk — Azure DevOps Toolkit

A dual-mode Go CLI & MCP server for Azure DevOps. Single binary, PAT-first auth, 14 MCP tools with 91 actions, 4 MCP prompts.

The most comprehensive Azure DevOps MCP server. A single Go binary — CLI for humans, MCP for AI agents.

Comparison: adtk vs Microsoft azure-devops-mcp

Feature	adtk	microsoft/azure-devops-mcp
Language	Go (single static binary)	TypeScript (Node.js)
MCP Tools / Actions	14 tools / 91 actions	~75 individual tools
MCP Prompts	4 built-in prompts	None
CLI mode	Full CLI with 15 command groups	No
Auth	PAT (self-service, no admin)	Azure AD (requires admin consent)
Startup	~50ms	~2s
Response flattening	`System.Title` → `title`	Raw API responses
Boards & Iterations	Full support	No
Test Plans	Full support	No
Advanced Security	Alert listing & details	No
Metrics	Cycle time, lead time, time-in-status	No
Git branch detection	Auto-detect work items from branch	No
Branch policies & tags	List policies, list/create tags	No
Variable groups & environments	List/get variable groups, environments	No
Saved queries	Get and run saved queries	No
Attachments	Upload, download, list	No
Write protection	`ADTK_ENABLE_WRITES` gate	None
Rate limiting	Built-in token bucket	None
Binary size	~15 MB	`npm install` (~200+ MB)

Related MCP server: ctk

Features

Dual-mode — Full CLI with table output + MCP server for AI agents
14 consolidated MCP tools with 91 actions covering every Azure DevOps domain
4 MCP prompts — sprint_summary, pr_review_digest, pipeline_health, release_readiness
Git branch detection — Auto-detect work item IDs from branch names (e.g., feature/12345-description)
Work item metrics — Cycle time, lead time, time-in-status computed from revision history
PAT-first auth — Self-service Personal Access Tokens, no Azure AD admin approval
Single binary — No Node.js, Python, or Docker required
Response flattening — Strips _links and converts System.* fields to readable names
Write protection — All mutations gated behind ADTK_ENABLE_WRITES=true
Rate limiting — Built-in token bucket respecting Azure DevOps TSTU limits
Token-optimized — AI agents get clean, concise payloads (40-60% fewer tokens)

Installation

go install

go install github.com/zach-snell/adtk/cmd/adtk@latest

Build from source

git clone https://github.com/zach-snell/adtk.git
cd adtk
./install.sh

Pre-built binaries

Download from the Releases page.

Quick Start

Authenticate

adtk auth
# Or use environment variables:
export AZURE_DEVOPS_ORG=myorg
export AZURE_DEVOPS_PAT=your-pat-here

CLI Usage

# Projects
adtk projects list
adtk projects get MyProject
adtk projects teams MyProject

# Work items
adtk work-items get 42
adtk work-items list -p MyProject

# Repositories
adtk repos list -p MyProject
adtk repos branches myrepo -p MyProject
adtk repos tree myrepo /src -p MyProject
adtk repos policies myrepo -p MyProject
adtk repos tags myrepo -p MyProject

# Pull requests
adtk pull-requests list myrepo -p MyProject
adtk pull-requests get myrepo 1

# Pipelines
adtk pipelines list -p MyProject
adtk pipelines runs 42 -p MyProject
adtk pipelines var-groups -p MyProject
adtk pipelines var-group 1 -p MyProject
adtk pipelines environments -p MyProject

# Iterations & boards
adtk iterations current -p MyProject
adtk boards list -p MyProject
adtk boards columns Stories -p MyProject

# Wiki
adtk wiki list -p MyProject
adtk wiki get ProjectWiki /Home -p MyProject

# Work item metrics
adtk work-items metrics 42 -p MyProject

# Work item auto-detect from git branch
adtk work-items get          # auto-detects work item ID from branch name

# Search
adtk search code "func main" -p MyProject
adtk search work-items "login bug" -p MyProject
adtk search wiql "SELECT [System.Id] FROM WorkItems WHERE [System.State] = 'Active'"
adtk search query "My Saved Queries/Active Bugs" -p MyProject

# Test plans
adtk test-plans list -p MyProject

# Security alerts
adtk security alerts myrepo -p MyProject

# Attachments
adtk attachments list 42 -p MyProject

# All commands support --json for raw output
adtk projects list --json

MCP Server

stdio mode (for AI agents)

adtk mcp

HTTP Streamable mode

adtk mcp --port 8080

MCP Client Configuration

Claude Desktop / Cursor / Claude Code:

{
  "mcpServers": {
    "adtk": {
      "command": "adtk",
      "args": ["mcp"],
      "env": {
        "AZURE_DEVOPS_ORG": "myorg",
        "AZURE_DEVOPS_PAT": "your-pat-here",
        "ADTK_ENABLE_WRITES": "true"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`AZURE_DEVOPS_ORG`	Yes	Azure DevOps organization name
`AZURE_DEVOPS_PAT`	Yes	Personal Access Token
`ADTK_ENABLE_WRITES`	No	Set to `true` to enable write operations (default: `false`)
`AZURE_DEVOPS_DISABLED_TOOLS`	No	Comma-separated list of tools to disable

MCP Tools

adtk exposes 14 MCP tools with 91 actions and 4 MCP prompts:

Tool	Actions	Description
`manage_work_items`	get, batch_get, create, update, delete, add_comment, update_comment, list_comments, get_links, list_types, get_history, batch_update, add_children, link, unlink, add_artifact_link, my_items, iteration_items	Full work item lifecycle (18 actions)
`manage_projects`	list, get, list_teams, get_team, create	Projects and teams (5 actions)
`manage_users`	get_current, search	Identity and user lookup (2 actions)
`manage_search`	wiql, code, work_items, wiki, get_query, run_query	Multi-domain search + saved queries (6 actions)
`manage_repos`	list, get, list_branches, get_file, get_tree, create_branch, search_commits, list_policies, list_tags, create_tag	Git repositories, policies, and tags (10 actions)
`manage_pull_requests`	list, get, create, update, add_comment, list_comments, vote, list_reviewers, update_reviewers, create_thread, update_thread, reply_to_comment	Pull request management (12 actions)
`manage_iterations`	list, get, get_current, create, get_team_settings	Sprint/iteration tracking (5 actions)
`manage_boards`	list, get, get_columns	Kanban board management (3 actions)
`manage_wiki`	list, get_page, list_pages, create_page, update_page, delete_page	Markdown-native wiki (6 actions)
`manage_pipelines`	list, get, list_runs, get_run, trigger, get_logs, get_log, get_build_changes, list_definitions, list_variable_groups, get_variable_group, list_environments	CI/CD pipelines, variable groups, and environments (12 actions)
`manage_test_plans`	list_plans, create_plan, list_suites, create_suite, list_cases, get_test_results	Test plan management (6 actions)
`manage_advanced_security`	list_alerts, get_alert	Security alert management (2 actions)
`manage_metrics`	get_metrics	Work item lifecycle metrics — cycle time, lead time, time-in-status (1 action)
`manage_attachments`	list, upload, download	Work item attachments (3 actions)

MCP Prompts

Prompt	Arguments	Description
`sprint_summary`	`project` (required), `team`, `iteration`	Generate a sprint/iteration status report
`pr_review_digest`	`project` (required), `repo` (required)	Generate a PR review digest for a repository
`pipeline_health`	`project` (required), `pipeline_id`	Analyze CI/CD pipeline health and failure trends
`release_readiness`	`project` (required), `iteration`	Assess release readiness with go/no-go recommendation

Security

Write Protection

adtk is read-only by default. All create, update, delete, and trigger operations require:

export ADTK_ENABLE_WRITES=true

PAT Auth

Uses HTTP Basic Auth with empty username: Authorization: Basic base64(":" + pat). No Azure AD admin consent required.

Rate Limiting

Built-in token bucket rate limiter (30 tokens, refill 1/2s) prevents hitting Azure DevOps TSTU throttling limits.

Architecture

Custom HTTP client — Direct REST API calls, no third-party SDK
Multi-base-URL routing — dev.azure.com, vssps.dev.azure.com, almsearch.dev.azure.com, vsrm.dev.azure.com
JSON Patch for work item writes — Content-Type: application/json-patch+json
WIQL 2-step — Query IDs, then batch fetch fields (max 200 per request)
Response flattener — System.Title → title, Microsoft.VSTS.Common.Priority → priority
ETag concurrency — Wiki updates use If-Match headers for optimistic concurrency
Team-scoped APIs — Iterations/boards use {project}/{team} URL routing

Development

# Build
go build -o adtk ./cmd/adtk

# Test
go test -race ./...

# Lint
golangci-lint run ./...

# Vulnerability check
govulncheck ./...

See the development guide for full details.

Documentation

Full documentation: zach-snell.github.io/adtk

License

Apache 2.0 — see LICENSE

Available Tools

14 tools

manage_advanced_securityB

Manage Azure DevOps Advanced Security alerts. Actions: 'list_alerts', 'get_alert'

Inputs: action (required), project_key, repo_id, alert_id, +2 more.

manage_attachmentsB

Manage Azure DevOps work item attachments. Actions: 'list', 'upload', 'download'

Inputs: action (required), project_key, work_item_id, file_path, +2 more.

manage_boardsB

Manage Azure DevOps Kanban boards. Actions: 'list', 'get', 'get_columns'

Inputs: action (required), project_key, team, board_id.

manage_iterationsB

Manage Azure DevOps iterations (sprints). Actions: 'list', 'get', 'get_current', 'create', 'get_team_settings'

Inputs: action (required), project_key, team, iteration_id, +3 more.

manage_metricsC

Get issue lifecycle metrics for dashboards and visualizations. Actions: 'get_metrics'

Inputs: action (required), project_key, work_item_id.

manage_pipelinesC

Manage Azure DevOps CI/CD pipelines. Actions: 'list', 'get', 'list_runs', 'get_run', 'get_logs', 'get_log', 'get_build_changes', 'list_definitions', 'list_variable_groups', 'get_variable_group', 'list_environments', 'trigger'

Inputs: action (required), project_key, pipeline_id, run_id, +5 more.

manage_projectsB

Manage Azure DevOps projects and teams. Actions: 'list', 'get', 'list_teams', 'get_team', 'create'

Inputs: action (required), project_key, team_id, name, +1 more.

manage_pull_requestsC

Manage Azure DevOps pull requests. Actions: 'list', 'get', 'list_comments', 'list_reviewers', 'create', 'update', 'add_comment', 'vote', 'update_reviewers', 'create_thread', 'update_thread', 'reply_to_comment'

Inputs: action (required), project_key, repo_id, pr_id, +14 more.

manage_reposB

Manage Azure DevOps Git repositories. Actions: 'list', 'get', 'list_branches', 'get_file', 'get_tree', 'search_commits', 'list_policies', 'list_tags', 'create_branch', 'create_tag'

Inputs: action (required), project_key, repo_id, file_path, +8 more.

manage_searchB

Search Azure DevOps using WIQL, code search, work item search, or wiki search. Actions: 'wiql', 'code', 'work_items', 'wiki', 'get_query', 'run_query'

Inputs: action (required), project_key, query, query_id, +2 more.

manage_test_plansA

Manage Azure DevOps test plans, suites, and cases. Actions: 'list_plans', 'list_suites', 'list_cases', 'get_test_results', 'create_plan', 'create_suite'

Inputs: action (required), project_key, plan_id, suite_id, +4 more.

manage_usersB

Search and get Azure DevOps users. Actions: 'get_current', 'search'

Inputs: action (required), query.

manage_wikiC

Manage Azure DevOps wiki pages (markdown-native). Actions: 'list', 'get_page', 'list_pages', 'create_page', 'update_page', 'delete_page'

Inputs: action (required), project_key, wiki_id, page_path, +2 more.

manage_work_itemsC

Manage Azure DevOps work items (tasks, bugs, user stories, epics). Actions: 'get', 'batch_get', 'list_types', 'get_links', 'get_history', 'list_comments', 'my_items', 'iteration_items', 'create', 'update', 'delete', 'add_comment', 'batch_update', 'add_children', 'link', 'unlink', 'add_artifact_link', 'update_comment'

Inputs: action (required), project_key, work_item_id, work_item_ids, +23 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.4/5.0

Scored 2026-04-29 22:05 across 14 tools

Disambiguation5/5

Each tool focuses on a distinct Azure DevOps domain (e.g., work items, repos, pipelines) with no overlapping responsibilities. Actions within each tool are specific to that resource, ensuring clear separation.

Naming Consistency5/5

All tools follow a consistent 'manage_<domain>' naming pattern, and actions inside use standard verbs like list, get, create, update, delete. No mixing of conventions.

Tool Count5/5

14 tools cover a broad range of Azure DevOps functionality without being excessive. Each tool is justified by a distinct set of operations, making the surface well-scoped.

Completeness4/5

Major Azure DevOps features are covered, but some resources lack full CRUD (e.g., test plans missing update/delete, boards only read). Core workflows are supported, with minor gaps.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Azure DevOps (ADO)
io.github.PremierInc
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
CI/CD & DevOps Version Control Project Management
22,087
https://mcp.dev.azure.com
GitLab MCP ServerA
io.github.jmrplens
Go MCP server for GitLab: 2 dynamic tools reach 1000+ REST/GraphQL actions. Free/CE, no paid tier.
CI/CD & DevOps Developer Tools Version Control
2149
https://mcp.jmrp.io/gitlab
crowvault
io.github.rajeswaran140
327 dev tools via REST API and MCP. Generate Dockerfiles, schemas, K8s, APIs, and more.
Developer Tools CI/CD & DevOps
2
https://api.crowvault.ai/mcp
serverA
io.cycloid.mcp
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Developer Tools CI/CD & DevOps Cloud Platforms
132
https://mcp.cycloid.io/mcp

Related MCP Servers

jtk
Project Management Developer Tools Version Control
zach-snell
A
license
B
quality
C
maintenance
Jira CLI & MCP Server — dual-mode Go binary for Jira Cloud with 9 tools, 4 prompts, permission introspection, and dev-status API.
Updated 5 months ago (2026-06-06 05:02 UTC)
10
1
Apache 2.0
ctk
Content Management Systems Developer Tools Project Management
zach-snell
A
license
B
quality
D
maintenance
Confluence CLI & MCP Server — dual-mode Go binary for Confluence Cloud with 7 tools, folder CRUD, page diff, and write gating.
Updated 8 months ago (2026-03-16 02:21 UTC)
8
1
Apache 2.0
Azure DevOps MCP Server
CI/CD & DevOps Version Control Developer Tools
iimsaurav
A
license
A
quality
D
maintenance
An MCP server that exposes 41 Azure DevOps tools to AI assistants, enabling management of pipelines, repositories, pull requests, releases, work items, test management, and wikis through natural language.
Updated 7 months ago (2026-04-04 05:56 UTC)
41
40 PyPI
MIT
Azure DevOps MCP Server
CI/CD & DevOps Version Control Project Management
Kshitijijari09
F
license
Not graded
quality
D
maintenance
MCP server that provides tools to interact with Azure DevOps, including querying work items, repositories, pull requests, builds, commits, and creating work items via a standardized interface.
Updated a year ago (2025-09-07 19:17 UTC)
-