ado-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port for HTTP transport (default '3000'). | |
| ADO_ORG | No | Azure DevOps organization name. | |
| ADO_PAT | No | Personal Access Token for PAT authentication mode. | |
| AUTH_MODE | No | Authentication mode: 'azcli' (Azure CLI), 'pat' (Personal Access Token), or 'obo' (On-Behalf-Of with Entra). | |
| LOG_LEVEL | No | Logging level (e.g., 'info', 'debug'). | |
| TRANSPORT | No | Transport mode: 'stdio' or 'http'. | |
| LOCAL_ROLE | No | Effective RBAC role in pat/azcli modes: 'admin', 'editor', or 'viewer'. | |
| ADO_API_VERSION | No | Azure DevOps API version. | |
| AZURE_CLIENT_ID | No | Azure client ID for OBO authentication mode. | |
| AZURE_TENANT_ID | No | Azure tenant ID for OBO authentication mode. | |
| ALLOW_DESTRUCTIVE | No | Set to 'true' to allow destructive operations. | |
| ADO_DEFAULT_PROJECT | No | Default Azure DevOps project name. | |
| AZURE_CLIENT_SECRET | No | Azure client secret for OBO authentication mode. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ado_get_meA | Return the authenticated identity and Azure DevOps organization connection data. Use this to verify connectivity and auth before other calls. |
| ado_list_projectsA | List all projects in the Azure DevOps organization, with optional state filter and paging. |
| ado_get_projectA | Get details for a single project, including process and version-control capabilities. |
| ado_create_projectA | Create a new project (async operation; returns an OperationReference). Resolves the process template by name when an explicit ID is not given. |
| ado_update_projectA | Update a project's name, description, or visibility (async operation; returns an OperationReference). |
| ado_list_teamsB | List teams in a project. |
| ado_list_team_membersB | List the members of a team within a project. |
| ado_list_reposB | List Git repositories in a project. |
| ado_get_repoB | Get a single Git repository by name or ID. |
| ado_create_repoB | Create a new Git repository in a project. |
| ado_delete_repoA | Permanently delete a Git repository. Destructive. |
| ado_list_branchesC | List branches (refs) in a repository. |
| ado_get_branchA | Get details (tip commit, stats) of a branch. |
| ado_create_branchA | Create a new branch from the tip of an existing source branch. |
| ado_list_tagsB | List tags in a repository. |
| ado_create_tagB | Create an annotated tag pointing at a commit. |
| ado_list_commitsC | List commits in a repository, optionally filtered by branch. |
| ado_get_commitA | Get a single commit by SHA. |
| ado_get_fileA | Read a file's content and metadata from a repository at an optional branch. |
| ado_list_itemsB | List files and folders at a path in a repository. |
| ado_create_pushB | Commit and push one or more file add/edit/delete changes to a branch in a single push. |
| ado_get_diffsA | Get the diff (changed files/commits) between two branches. |
| ado_list_pull_requestsA | List pull requests in a repository, filterable by status and source/target branch. |
| ado_get_pull_requestA | Get a single pull request by ID. |
| ado_create_pull_requestB | Create a pull request from a source branch into a target branch. |
| ado_update_pull_requestA | Update a pull request: title, description, target branch, or draft state. |
| ado_add_pr_reviewersB | Add reviewers (by identity ID) to a pull request. |
| ado_set_pr_voteB | Cast a vote on a pull request (approve, approve-with-suggestions, reset, wait-for-author, reject). Defaults to the caller. |
| ado_complete_pull_requestA | Complete (merge) a pull request. Destructive — merges code and optionally deletes the source branch. |
| ado_abandon_pull_requestA | Abandon (close without merging) a pull request. Destructive. |
| ado_list_pr_threadsB | List comment threads on a pull request. |
| ado_create_pr_threadA | Start a new comment thread on a pull request (optionally anchored to a file). |
| ado_reply_pr_threadB | Reply to an existing comment thread on a pull request. |
| ado_list_pr_commitsA | List the commits included in a pull request. |
| ado_get_work_itemA | Get a single work item by ID (org-wide lookup; project optional). Optionally expand relations. |
| ado_get_work_itemsA | Get multiple work items by their IDs. |
| ado_create_work_itemB | Create a work item (Bug, Task, User Story, Epic, …). Pass fields as a map; optionally set a parent. |
| ado_update_work_itemC | Update a work item's fields. |
| ado_delete_work_itemA | Delete a work item (recycle bin by default; destroy=true is permanent). Destructive. |
| ado_query_work_itemsA | Run a WIQL query and return matching work item references. |
| ado_list_queriesA | List saved/shared queries in a project. |
| ado_get_queryA | Get a saved query by GUID or folder path (includes its WIQL). |
| ado_get_work_item_typesA | List the work item types available in a project. |
| ado_get_work_item_type_fieldsA | List the fields defined for a given work item type. |
| ado_link_work_itemsB | Link two work items (parent/child/related/duplicate/successor/predecessor or a raw link ref). |
| ado_add_work_item_commentB | Add a comment to a work item. |
| ado_get_work_item_commentsA | List the comments on a work item. |
| ado_add_work_item_attachmentC | Upload a text attachment and link it to a work item. |
| ado_bulk_export_work_itemsA | Export work items selected by a WIQL query (batched for large result sets). |
| ado_bulk_create_work_itemsB | Create multiple work items in one call. |
| ado_list_backlogsA | List backlog levels (Epics, Features, Stories) for a team. |
| ado_get_backlog_work_itemsC | Get the work items at a given backlog level for a team. |
| ado_list_boardsA | List the boards available to a team. |
| ado_get_board_columnsB | Get the columns configured on a board. |
| ado_list_sprintsA | List a team's sprints (iterations), optionally only the current one. |
| ado_get_sprint_work_itemsA | Get the work items assigned to a sprint (iteration). |
| ado_get_team_capacityB | Get a team's capacity for a sprint (iteration). |
| ado_list_area_pathsA | List the area path classification tree for a project. |
| ado_list_iteration_pathsB | List the iteration path classification tree for a project. |
| ado_create_classification_nodeA | Create an area or iteration path node (admin). For iterations, pass start/finish dates in attributes. |
| ado_list_pipelinesA | List YAML pipelines in a project. |
| ado_get_pipelineB | Get a single pipeline by ID. |
| ado_run_pipelineA | Queue a run of a YAML pipeline, optionally on a branch and with variables/template parameters. |
| ado_get_pipeline_runB | Get the status/result of a specific pipeline run. |
| ado_list_pipeline_runsC | List recent runs of a pipeline. |
| ado_list_build_definitionsA | List build/pipeline definitions in a project. |
| ado_list_buildsB | List builds, optionally filtered by definition and branch. |
| ado_get_buildA | Get a single build by ID (status, result, timing). |
| ado_queue_buildB | Queue a build from a build definition, optionally on a source branch. |
| ado_cancel_buildB | Cancel an in-progress build. |
| ado_get_build_logsA | List the available logs for a build. |
| ado_get_build_logA | Get the content (lines) of a specific build log. |
| ado_get_build_changesC | List the source changes (commits/work items) associated with a build. |
| ado_list_release_definitionsA | List classic release definitions in a project. |
| ado_get_release_definitionA | Get a single release definition (stages, artifacts, triggers). |
| ado_list_releasesC | List releases, optionally filtered by definition. |
| ado_get_releaseA | Get a single release (environments, status, artifacts). |
| ado_create_releaseC | Create a release from a release definition. |
| ado_deploy_releaseB | Trigger deployment of a release to an environment/stage. Destructive — initiates a deployment. |
| ado_list_release_approvalsB | List pending release approvals in a project. |
| ado_approve_releaseA | Approve or reject a pending release approval. Destructive — gates a deployment. |
| ado_list_test_plansB | List test plans in a project. |
| ado_get_test_planB | Get a single test plan by ID. |
| ado_create_test_planC | Create a test plan. |
| ado_list_test_suitesB | List the test suites in a test plan. |
| ado_create_test_suiteA | Create a test suite under a parent suite in a plan (static/requirement/query). |
| ado_list_test_casesB | List the test cases in a suite. |
| ado_add_test_casesC | Add existing test case work items to a suite. |
| ado_create_test_runB | Create a test run for a plan (optionally over specific test points). |
| ado_get_test_runA | Get a test run by ID (status, totals). |
| ado_get_test_resultsB | Get the results of a test run. |
| ado_list_wikisA | List wikis in a project. |
| ado_get_wikiA | Get a single wiki by ID or name. |
| ado_create_wikiB | Create a project wiki. |
| ado_get_wiki_pageA | Read a wiki page's content (and ETag) by path. |
| ado_create_wiki_pageB | Create a wiki page at a path with markdown content. |
| ado_update_wiki_pageA | Update an existing wiki page's content (handles the required ETag automatically). |
| ado_delete_wiki_pageB | Delete a wiki page by path. Destructive. |
| ado_code_searchA | Full-text search across code in the organization (or a project). Requires the Code Search extension. |
| ado_work_item_searchA | Full-text search across work items. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| pr-review | Summarize a PR, inspect its diff and threads, and recommend a vote. |
| release-readiness | Check recent builds, open PRs, and test results to judge if a project is ready to ship. |
| sprint-planning | Pull the backlog, current sprint, and team capacity to help plan. |
| bug-triage | Query open bugs and propose priority/assignment. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| ado-projects | All projects in the organization. |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/og-mcp/ado-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server