MCP Tools Overview
adtk exposes 14 MCP tools with 91 total actions and 4 MCP prompts for managing Azure DevOps resources. Tools are registered with a unified action-based pattern — each tool accepts an action parameter that determines the operation to perform.
Write Protection
Section titled “Write Protection”Write operations (create, update, delete, trigger) are disabled by default. Set the ADTK_ENABLE_WRITES=true environment variable to enable them. This prevents accidental modifications when used with AI agents.
Disabling Tools
Section titled “Disabling Tools”Set AZURE_DEVOPS_DISABLED_TOOLS to a comma-separated list of tool names to disable specific tools:
AZURE_DEVOPS_DISABLED_TOOLS="manage_wiki,manage_test_plans"Tools Reference
Section titled “Tools Reference”| Tool | Actions | Description |
|---|---|---|
manage_work_items | 18 | Work items: get, create, update, delete, comments, links, batch operations |
manage_search | 6 | Search: WIQL, code, work items, wiki, get/run saved queries |
manage_repos | 10 | Repositories: list, get, branches, files, tree, commits, policies, tags |
manage_pull_requests | 12 | Pull requests: CRUD, comments, threads, votes, reviewers |
manage_projects | 5 | Projects and teams: list, get, create |
manage_users | 2 | Users: get current, search |
manage_iterations | 5 | Iterations/sprints: list, get, create, team settings |
manage_boards | 3 | Kanban boards: list, get, columns |
manage_wiki | 6 | Wiki pages: list, get, create, update, delete |
manage_pipelines | 12 | Pipelines: list, get, runs, trigger, logs, build changes, variable groups, environments |
manage_test_plans | 6 | Test plans: plans, suites, cases, results |
manage_advanced_security | 2 | Advanced Security: list alerts, get alert |
manage_metrics | 1 | Work item lifecycle metrics: cycle time, lead time, time-in-status |
manage_attachments | 3 | Attachments: list, upload, download |
Prompts Reference
Section titled “Prompts Reference”adtk registers 4 MCP prompts that guide AI agents through multi-step analysis workflows. See Prompts for full documentation.
| Prompt | Description |
|---|---|
sprint_summary | Generate a sprint/iteration status report |
pr_review_digest | Generate a PR review digest for a repository |
pipeline_health | Analyze CI/CD pipeline health and failure trends |
release_readiness | Assess release readiness with go/no-go recommendation |
Read vs Write Actions
Section titled “Read vs Write Actions”Always available (read-only)
Section titled “Always available (read-only)”get, list, batch_get, list_types, get_links, get_history, list_comments, my_items, iteration_items, search, list_branches, get_file, get_tree, search_commits, list_policies, list_tags, list_reviewers, list_comments, get_current, get_team_settings, get_columns, get_page, list_pages, get_run, get_logs, get_log, get_build_changes, list_definitions, list_variable_groups, get_variable_group, list_environments, list_plans, list_suites, list_cases, get_test_results, list_alerts, get_alert, get_metrics, get_query, run_query, download
Requires ADTK_ENABLE_WRITES=true
Section titled “Requires ADTK_ENABLE_WRITES=true”create, update, delete, add_comment, update_comment, batch_update, add_children, link, unlink, add_artifact_link, create_branch, create_tag, create (PR), update (PR), add_comment (PR), vote, update_reviewers, create_thread, update_thread, reply_to_comment, create (iteration), create_page, update_page, delete_page, trigger, create_plan, create_suite, upload