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. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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