ado-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ADO_MODE | No | read (default, só lê) | write (habilita mutações). Relido ao vivo do .env a cada escrita. | read |
| DEVOPS_PAT | Yes | Personal Access Token de privilégio mínimo (obrigatório). Escopos: Work Items Read & Write, Code Read & Write, Pull Request Threads Read & Write. | |
| DEVOPS_URL | Yes | Base da coleção, ex. https://servidor/colecao. Prefira https — sobre http o PAT viaja em Basic auth sem TLS. | |
| API_VERSION | No | Versão da REST API do DevOps on-prem (default 6.0). | 6.0 |
| ADO_AUDIT_LOG | No | Caminho da trilha de auditoria (relativo = a partir do diretório do server; default ./ado-mcp-audit.log). | ./ado-mcp-audit.log |
| ADO_TIMEOUT_MS | No | Timeout das chamadas HTTP em ms (default 30000). | 30000 |
| DEVOPS_PROJECT | Yes | Projeto padrão de toda tool. | |
| ADO_ATTACH_MAX_MB | No | Limite de tamanho por anexo em wit_attach (default 25). | 25 |
| ADO_REPO_ALLOWLIST | No | Repos permitidos, separados por vírgula (vazio = todos). | |
| ADO_PROJECT_ALLOWLIST | No | Outros projetos alcançáveis pelo parâmetro project das tools, separados por vírgula (vazio = só DEVOPS_PROJECT; * = todos da coleção). | |
| ADO_PROTECTED_BRANCHES | No | Branches sob sinalização reforçada em pr_create/pr_update (default main,master,develop,release/*). | main,master,develop,release/* |
| ADO_WIT_AREA_ALLOWLIST | No | Area paths onde a escrita de work item é permitida, por prefixo (vazio = todo o projeto). | |
| ADO_WIT_TYPE_ALLOWLIST | No | Tipos que wit_create pode criar (vazio = todos os do processo). | |
| ADO_ATTACH_EXT_ALLOWLIST | No | Extensões de anexo permitidas (vazio = todas). |
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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| wit_queryA | Busca work items via WIQL, preset (my_active | my_recent) ou query salva. Leitura. |
| wit_getA | Detalha work items por id, com campos e relações opcionais. Leitura. |
| wit_treeA | Executa WIQL de hierarquia (FROM WorkItemLinks) e devolve a árvore epic → feature → item. Leitura. |
| wit_commentsB | Lê a discussão de um work item (autor, data, texto). Leitura. |
| wit_historyC | Lê o histórico de revisões de um work item, campo a campo. Leitura. |
| wit_metaA | Metadados do processo: types | states | fields | categories | relationtypes | areas | iterations | tags. Use antes de criar/atualizar para descobrir tipos, estados e campos válidos. Leitura. |
| wit_createA | Cria work item (epic, feature, PBI, task, bug...) com campos, tags, área, iteração, pai e links. Escrita: exige ADO_MODE=write e confirm:true. |
| wit_updateB | Atualiza campos, estado e tags de um ou mais work items. Escrita: write + confirm. |
| wit_linkA | Cria link em um work item: hierarquia, relacionado, dependência, duplicado, hyperlink ou artefato de código (PR, commit, branch). Escrita: write + confirm. |
| wit_unlinkB | Remove um link de um work item, resolvendo o índice da relação no momento da escrita. Escrita: write + confirm. |
| wit_commentA | Publica comentário na discussão do work item (API de comments, com fallback para System.History). Escrita: write + confirm. |
| wit_attachB | Anexa um arquivo local ao work item (upload + relação AttachedFile). Escrita: write + confirm. |
| pr_listB | Lista pull requests de um repo. Leitura. |
| pr_getB | Detalha um pull request. Leitura. |
| pr_createA | Cria um pull request (NÃO faz merge). Escrita: write + confirm. |
| pr_updateA | Edita título, descrição, rascunho ou branch de destino de um PR. NÃO altera status: abandonar e mergear não passam por aqui. Escrita: write + confirm. |
| pr_add_reviewersB | Adiciona reviewers a um PR. Escrita: write + confirm. |
| pr_commentB | Comenta num PR (abre thread). Escrita: write + confirm. |
| repo_listA | Lista repositórios do projeto. Leitura. |
| branch_listB | Lista branches de um repo. Leitura. |
| commit_listA | Lista commits recentes de um repo/branch. Leitura. |
| project_listA | Lista os projetos da coleção e marca quais podem ser usados no parâmetro project das demais tools. Leitura. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 22 tools
Tools are clearly grouped by domain prefix (wit_, pr_, repo_, branch_, commit_, project_) and each maps to a distinct resource or action. The only mild ambiguity is wit_comments (read) vs wit_comment (write), but their descriptions clearly separate discussion reading from comment posting.
The snake_case domain-prefixed naming is consistent and predictable overall, but verb placement varies: reads use both generic verbs (wit_get, pr_get) and resource nouns (wit_comments, wit_history, repo_list). This is a minor deviation rather than a chaotic mix.
At 22 tools, the server sits in the heavy 16-25 band, though the count is partially justified by covering work items, PRs, repos, branches, commits, and projects. Each tool appears non-redundant, so the set is broad rather than bloated.
Work item coverage is strong: query, get, tree, comments, history, meta, create, update, link/unlink, comment, and attach are all present. However, the PR lifecycle has a notable gap: pr_update explicitly cannot change status and there is no merge or abandon tool, leaving PRs incomplete after creation.