Skip to main content
Glama
Microsoft Active Directory MCP Server

Microsoft Active Directory MCP Server

by nks1097

Microsoft Active Directory MCP Server — 100 Essential Tools

CI Pipeline Python Version MCP Specification Tools Count License: MIT

A complete, production-ready, open-source Model Context Protocol (MCP) server for Microsoft Active Directory Domain Services (AD DS) featuring exactly 100 functional tools for directory administration, automation, security auditing, health diagnostics, and compliance reporting.

Designed to allow AI agents (Claude Desktop, Cursor, Antigravity, custom agents) to securely interact with Active Directory using natural language while enforcing least-privilege, write-approval workflows, and immutable audit logs.


1. Destaques e Funcionalidades (Key Features)

  • 100 Ferramentas 100% Funcionais: Nenhuma ferramenta fictícia ou apenas mock. Todas possuem validação estrita, tratamento de erro, timeouts e saída estruturada.

  • Três Modos de Operação:

    • READ_ONLY (Padrão): Consultas, pesquisas e relatórios. Operações de alteração são bloqueadas por segurança.

    • WRITE_APPROVAL: Ações administrativas geram tokens criptográficos de confirmação de uso único com expiração (5 min) exigindo aprovação explícita.

    • FULL_ADMIN: Execuções administrativas diretas para pipelines de automação, respeitando proteções contra exclusão acidental.

  • Proteção de Objetos Críticos: Proteção nativa contra exclusão ou alteração de contas e grupos vitais (Administrator, krbtgt, Domain Admins, Enterprise Admins, OU=Domain Controllers, etc.).

  • Arquitetura Híbrida: Executa nativamente no Windows com módulos RSAT e fallback via .NET DirectoryServices/ADSI, além de suportar conexões remotas via LDAP/LDAPS multiplataforma.

  • Prevenção contra Injeção: Higienização contra LDAP Injection (RFC 4515) e execução segura de comandos PowerShell com -EncodedCommand UTF-16LE.

  • Modo Dry-Run: Permite simulação prévia (dry_run=true) em qualquer ferramenta de escrita para avaliar impacto antes de aplicar alterações.

  • Auditoria Estruturada em JSON: Registro em tempo real com correlation_id, timestamps, operador e mascaramento de senhas e dados sensíveis.


Related MCP server: safe-runbook-mcp

2. Arquitetura do Sistema

┌────────────────────────────────────────────────────────┐
│             AI Agent (Claude, Cursor, etc.)            │
└──────────────────────────┬─────────────────────────────┘
                           │ MCP Protocol (JSON-RPC)
┌──────────────────────────▼─────────────────────────────┐
│                 AD MCP SERVER (Python 3.12)            │
├────────────────────────────────────────────────────────┤
│ • 100 Tools Registry                                  │
│ • Authorization Gatekeeper (READ_ONLY / APPROVAL)     │
│ • Approval Token Manager (HMAC-SHA256 Single-Use)     │
│ • Guardrails & Injection Prevention                   │
│ • Structured Audit Logger (JSON Lines)                │
└──────────────────────────┬─────────────────────────────┘
                           │
             ┌─────────────┴─────────────┐
             ▼                           ▼
┌─────────────────────────┐ ┌─────────────────────────┐
│ PowerShell RSAT & ADSI  │ │   LDAP / LDAPS (ldap3)  │
│ (Windows Server / 11)   │ │ (Cross-Platform Remote) │
└────────────┬────────────┘ └────────────┬────────────┘
             │                           │
             ▼                           ▼
┌────────────────────────────────────────────────────────┐
│   Microsoft Active Directory Domain Controllers (DCs)  │
└────────────────────────────────────────────────────────┘

3. Catálogo das 100 Ferramentas

O servidor MCP implementa exatamente 100 ferramentas organizadas em 10 categorias essenciais (10 ferramentas por categoria):

Categoria 1 — Domínio e Controladores de Domínio (1 a 10)

  1. ad_get_domain_info — Consultar informações detalhadas do domínio atual.

  2. ad_list_domains — Listar domínios disponíveis na floresta.

  3. ad_get_forest_info — Consultar informações da floresta Active Directory.

  4. ad_list_domain_controllers — Listar controladores de domínio (DCs).

  5. ad_get_domain_controller_info — Consultar detalhes de um DC específico.

  6. ad_test_domain_controller — Verificar disponibilidade de portas e serviços de um DC.

  7. ad_get_domain_functional_level — Consultar nível funcional do domínio.

  8. ad_get_forest_functional_level — Consultar nível funcional da floresta.

  9. ad_get_fsmo_roles — Consultar detentores das 5 funções FSMO.

  10. ad_get_domain_trusts — Consultar relações de confiança (Trusts).

Categoria 2 — Usuários (11 a 20)

  1. ad_list_users — Listar usuários com filtros configuráveis.

  2. ad_get_user — Consultar detalhes completos de um usuário.

  3. ad_search_users — Pesquisar usuários por nome, login, e-mail ou atributo.

  4. ad_create_user — Criar novo usuário no Active Directory.

  5. ad_update_user — Atualizar atributos de usuário existente.

  6. ad_disable_user — Desabilitar conta de usuário.

  7. ad_enable_user — Habilitar conta de usuário.

  8. ad_delete_user — Excluir conta de usuário com confirmação obrigatória.

  9. ad_unlock_user — Desbloquear conta travada por tentativas de senha.

  10. ad_reset_user_password — Redefinir senha de usuário com segurança.

Categoria 3 — Grupos e Membros (21 a 30)

  1. ad_list_groups — Listar grupos com filtros de escopo e categoria.

  2. ad_get_group — Consultar detalhes e contagem de membros de grupo.

  3. ad_create_group — Criar novo grupo no Active Directory.

  4. ad_update_group — Atualizar atributos de um grupo.

  5. ad_delete_group — Excluir grupo do Active Directory.

  6. ad_add_group_member — Adicionar membro(s) a um grupo.

  7. ad_remove_group_member — Remover membro(s) de um grupo.

  8. ad_list_group_members — Listar membros de grupo (diretos ou recursivos).

  9. ad_get_user_groups — Consultar grupos dos quais um usuário faz parte.

  10. ad_get_nested_group_membership — Consultar associação recursiva a grupos (aninhados).

Categoria 4 — Computadores e Dispositivos (31 a 40)

  1. ad_list_computers — Listar computadores registrados no domínio.

  2. ad_get_computer — Consultar detalhes de um computador.

  3. ad_search_computers — Pesquisar computadores por nome, sistema operacional ou OU.

  4. ad_create_computer — Criar objeto de computador.

  5. ad_update_computer — Atualizar atributos de computador.

  6. ad_disable_computer — Desabilitar conta de computador.

  7. ad_enable_computer — Habilitar conta de computador.

  8. ad_delete_computer — Excluir conta de computador.

  9. ad_move_computer — Mover computador entre OUs.

  10. ad_get_stale_computers — Identificar computadores inativos há determinado período.

Categoria 5 — Organizational Units (OU) (41 a 50)

  1. ad_list_ous — Listar Unidades Organizacionais (OUs).

  2. ad_get_ou — Consultar detalhes de uma OU.

  3. ad_create_ou — Criar nova Unidade Organizacional.

  4. ad_update_ou — Atualizar atributos de uma OU.

  5. ad_delete_ou — Excluir OU com validação de proteção e conteúdo.

  6. ad_move_object — Mover qualquer objeto entre OUs.

  7. ad_list_ou_objects — Listar objetos contidos em uma OU.

  8. ad_get_ou_hierarchy — Consultar árvore da hierarquia de OUs.

  9. ad_get_ou_protection_status — Consultar estado da proteção contra exclusão acidental.

  10. ad_set_ou_protection — Habilitar ou desabilitar proteção contra exclusão acidental.

Categoria 6 — Group Policy Objects (GPO) (51 a 60)

  1. ad_list_gpos — Listar todas as Group Policy Objects (GPOs).

  2. ad_get_gpo — Consultar detalhes de uma GPO.

  3. ad_create_gpo — Criar nova GPO.

  4. ad_update_gpo — Atualizar configurações suportadas de GPO.

  5. ad_delete_gpo — Excluir GPO com confirmação.

  6. ad_link_gpo — Vincular GPO a site, domínio ou OU.

  7. ad_unlink_gpo — Remover vínculo de GPO.

  8. ad_get_gpo_links — Consultar vínculos de GPO em um site, domínio ou OU.

  9. ad_get_gpo_report — Gerar relatório detalhado XML ou HTML de GPO.

  10. ad_compare_gpos — Comparar configurações de duas GPOs.

Categoria 7 — DNS e Infraestrutura (61 a 70)

  1. ad_list_dns_zones — Listar zonas DNS integradas ao Active Directory.

  2. ad_get_dns_zone — Consultar detalhes e configurações de zona DNS.

  3. ad_list_dns_records — Listar registros DNS de uma zona.

  4. ad_get_dns_record — Consultar registro DNS específico.

  5. ad_create_dns_record — Criar registro DNS (A, CNAME, etc.).

  6. ad_update_dns_record — Atualizar registro DNS existente.

  7. ad_delete_dns_record — Excluir registro DNS de uma zona.

  8. ad_test_dns_resolution — Testar resolução de nomes DNS.

  9. ad_test_ldap_connectivity — Testar conectividade na porta LDAP/LDAPS.

  10. ad_test_kerberos_connectivity — Verificar conectividade Kerberos e estado do cache.

Categoria 8 — Segurança e Auditoria (71 a 80)

  1. ad_get_locked_accounts — Listar contas bloqueadas por tentativas de senha.

  2. ad_get_disabled_accounts — Listar todas as contas desabilitadas do domínio.

  3. ad_get_password_expiring_users — Identificar senhas próximas do vencimento.

  4. ad_get_password_never_expires_users — Identificar contas com 'Senha Nunca Expira'.

  5. ad_get_privileged_users — Identificar usuários em grupos privilegiados.

  6. ad_get_domain_admins — Consultar membros do grupo 'Domain Admins'.

  7. ad_get_admin_count_users — Identificar contas com atributo adminCount=1.

  8. ad_get_inactive_users — Identificar usuários sem atividade recente.

  9. ad_get_delegated_permissions — Auditar permissões delegadas em objeto ou OU.

  10. ad_get_security_group_changes — Consultar alterações em grupos nos logs de eventos.

Categoria 9 — Replicação, Saúde e Diagnóstico (81 a 90)

  1. ad_get_replication_status — Consultar estado geral da replicação.

  2. ad_get_replication_partners — Listar parceiros de replicação.

  3. ad_get_replication_failures — Identificar falhas de replicação do AD.

  4. ad_sync_replication — Solicitar sincronização imediata de replicação.

  5. ad_get_dc_services_status — Consultar estado dos serviços essenciais (NTDS, DNS, KDC, etc.).

  6. ad_get_dc_event_logs — Consultar eventos recentes nos logs do controlador.

  7. ad_get_directory_health — Executar verificações de integridade e saúde do AD.

  8. ad_test_secure_channel — Testar canal seguro entre computador e domínio.

  9. ad_get_time_sync_status — Verificar sincronização de horário com o PDC Emulator.

  10. ad_get_sysvol_status — Verificar disponibilidade das pastas SYSVOL e Netlogon.

Categoria 10 — Relatórios, Inventário e Automação (91 a 100)

  1. ad_generate_domain_inventory — Gerar inventário completo consolidado do domínio.

  2. ad_generate_user_report — Gerar relatório detalhado de usuários.

  3. ad_generate_group_report — Gerar relatório de grupos e membros.

  4. ad_generate_computer_report — Gerar relatório de computadores e sistemas operacionais.

  5. ad_generate_gpo_report — Gerar relatório consolidado de todas as GPOs.

  6. ad_generate_security_audit_report — Gerar relatório de auditoria de segurança.

  7. ad_generate_inactive_accounts_report — Relatório de contas inativas (usuários e computadores).

  8. ad_generate_domain_health_report — Relatório executivo de saúde do domínio.

  9. ad_compare_directory_snapshots — Comparar inventários de períodos diferentes.

  10. ad_run_compliance_assessment — Executar avaliação de conformidade (regras de segurança).


4. Instalação e Configuração Passo a Passo

Pré-requisitos

  • Python 3.11 ou 3.12+ (Download Python)

  • Sistema Operacional:

    • Windows 10/11 ou Windows Server (Recomendado para integração completa via RSAT/ADSI e Credential Vault).

    • Linux / macOS (Suportado para consultas remotas via LDAP/LDAPS).

  • Ferramentas RSAT do Active Directory (opcional no cliente, mas altamente recomendado):

    # Instalação automática do RSAT no Windows 10/11:
    powershell -ExecutionPolicy Bypass -File scripts/install_rsat.ps1

Passo 1: Clonar e Instalar Dependências

# 1. Clone o repositório
git clone https://github.com/nks1097/microsoft-active-directory-mcp.git
cd microsoft-active-directory-mcp

# 2. Executar o instalador automático (Windows):
.\scripts\setup_env.bat

# OU fazer a instalação manual com virtualenv:
python -m venv .venv
.\.venv\Scripts\activate
pip install -e ".[dev]"

Passo 2: Configurar o Arquivo .env

Copie o modelo .env.example para .env:

copy .env.example .env

Edite o arquivo .env com os dados do seu controlador de domínio:

# Modo de Operação (READ_ONLY por padrão para segurança)
AD_MCP_MODE=READ_ONLY

# Endereço e Domínio do Active Directory
AD_SERVER=dc01.corp.contoso.com
AD_DOMAIN=corp.contoso.com
AD_PORT=636
AD_USE_SSL=true
AD_TLS_VALIDATE_CERT=true

# Método de Autenticação Escolhido
AD_AUTH_METHOD=credential_manager
AD_CREDENTIAL_TARGET=AD_MCP_CREDENTIAL

Passo 3: Onde e Como Colocar a Senha?

O servidor suporta 3 métodos de autenticação. Escolha o mais adequado para o seu cenário:

Método A: Windows Credential Vault (Recomendado para Produção — Sem Senhas em Texto Puro)

Para evitar que senhas administrativas fiquem expostas em arquivos de texto (.env ou mcp_config.json), o servidor utiliza o Cofre de Credenciais do Windows com criptografia DPAPI.

  1. Mantenha no seu .env:

    AD_AUTH_METHOD=credential_manager
    AD_CREDENTIAL_TARGET=AD_MCP_CREDENTIAL
  2. No terminal PowerShell, execute o assistente de gravação segura:

    powershell -ExecutionPolicy Bypass -File scripts/set_production_credentials.ps1
  3. O terminal solicitará as credenciais (a digitação da senha fica oculta):

    === Active Directory MCP - Credential Setup ===
    Digite as credenciais da conta de servico do Active Directory.
    Usuario (ex: CONTOSO\svc_ad_mcp ou svc_ad@corp.contoso.com): CONTOSO\svc_ad_mcp
    Senha da conta (a digitacao ficara oculta): **************
    Credencial para 'CONTOSO\svc_ad_mcp' armazenada com sucesso no Windows Credential Manager.

Pronto! A senha foi gravada com criptografia de sistema operacional vinculada ao seu usuário Windows. O servidor MCP lê a senha da memória criptografada automaticamente em tempo de execução. Você não precisa colocar senha no .env nem no arquivo de configuração do Claude/Cursor.


Método B: Autenticação Integrada Windows / Kerberos / SSPI (Sem Senha!)

Se você está executando em uma máquina ingressada no domínio (domain-joined) com um usuário que já possui permissão de leitura no Active Directory:

  1. Configure no .env:

    AD_AUTH_METHOD=windows_integrated
  2. Deixe usuário e senha em branco! O servidor utilizará o próprio token de segurança Kerberos da sua sessão Windows ativa via SSPI.


Método C: Variáveis de Ambiente Diretas (Para Linux, Docker, Containers ou CI/CD)

Se você estiver executando em Linux, Docker ou ambientes onde o Windows Credential Vault não está disponível:

  1. Configure no .env (ou injete nas variáveis do container/orquestrador):

    AD_AUTH_METHOD=env
    AD_USERNAME=CONTOSO\svc_ad_mcp
    AD_PASSWORD=SuaSenhaForteAqui

Passo 4: Validar a Conectividade

Antes de conectar ao Claude Desktop ou Antigravity, valide se a comunicação com o Active Directory está perfeita executando o diagnóstico integrado:

powershell -ExecutionPolicy Bypass -File scripts/test_connectivity.ps1

O diagnóstico validará automaticamente:

  • Resolução de nomes DNS do domínio e do DC.

  • Portas de rede (53 DNS, 88 Kerberos, 389 LDAP, 445 SMB, 636 LDAPS, 3268 Global Catalog).

  • Handshake TLS e certificados digitais.

  • Consulta real ao RootDSE do Active Directory.


5. Como Conectar aos Clientes de IA

A. Antigravity IDE / VS Code MCP

Abra seu arquivo de configuração MCP (~/.gemini/config/mcp_config.json) e insira:

{
  "mcpServers": {
    "active-directory": {
      "command": "C:\\caminho\\para\\microsoft-active-directory-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "ad_mcp"],
      "env": {
        "AD_MCP_MODE": "READ_ONLY",
        "AD_SERVER": "dc01.corp.contoso.com",
        "AD_DOMAIN": "corp.contoso.com",
        "AD_AUTH_METHOD": "credential_manager",
        "AD_CREDENTIAL_TARGET": "AD_MCP_CREDENTIAL"
      }
    }
  }
}

B. Claude Desktop

No Claude Desktop, edite %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "active-directory": {
      "command": "C:\\caminho\\para\\microsoft-active-directory-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "ad_mcp"],
      "env": {
        "AD_MCP_MODE": "READ_ONLY",
        "AD_SERVER": "dc01.corp.contoso.com",
        "AD_DOMAIN": "corp.contoso.com",
        "AD_AUTH_METHOD": "credential_manager",
        "AD_CREDENTIAL_TARGET": "AD_MCP_CREDENTIAL"
      }
    }
  }
}

VIDEO DE CONFIGURAÇÃO DE FORMA SIMPLIFICADA

▶️ Clique aqui para assistir ao vídeo completo no Google Drive Assiste em Full Hd (1080P)

C. Cursor AI

No Cursor, configure em Features > MCP Servers apontando para o binário Python do .venv com argumento -m ad_mcp.


6. Exemplos de Consultas em Linguagem Natural

Uma vez conectado, o agente de IA pode responder a perguntas como:

  • "Liste os usuários desabilitados do domínio corp.contoso.com"

  • "Quais usuários possuem privilégios administrativos no domínio?"

  • "Encontre computadores que não fazem logon há mais de 90 dias."

  • "Verifique a saúde dos controladores de domínio e o status da replicação."

  • "Gere um relatório executivo de segurança em HTML."

  • "Quais usuários estão com o atributo 'Senha Nunca Expira' ativado?"


7. Testes e Qualidade de Código

Para executar a suíte completa de testes unitários automatizados:

pytest -v

Para verificar conformidade e formatação de código com Ruff:

ruff check .
ruff format .

8. Documentação Detalhada


9. Licença

Este projeto é open source sob a licença MIT. Contribuições da comunidade são bem-vindas! Consulte o CONTRIBUTING.md.

Available Tools

100 tools
ad_compare_directory_snapshotsC

[Reports, Inventory & Automation] [READ] Comparar inventarios de periodos diferentes.

Inputs: snapshot_a (required), snapshot_b (required), correlation_id. Returns: result

ad_compare_gposC

[Group Policy Objects] [READ] Comparar configuracoes e status de duas GPOs.

Inputs: gpo_a (required), gpo_b (required), correlation_id. Returns: result

ad_create_computerC

[Computers & Devices] [WRITE] Criar objeto de computador.

Inputs: name (required), path (required), dry_run, description, +3 more. Returns: result

ad_create_dns_recordC

[DNS & Infrastructure] [WRITE] Criar registro DNS no AD.

Inputs: name (required), zone_name (required), dry_run, cname_alias, +5 more. Returns: result

ad_create_gpoC

[Group Policy Objects] [WRITE] Criar nova GPO.

Inputs: name (required), comment, dry_run, correlation_id, +1 more. Returns: result

ad_create_groupC

[Groups & Members] [WRITE] Criar novo grupo no Active Directory.

Inputs: name (required), path (required), dry_run, description, +5 more. Returns: result

ad_create_ouC

[Organizational Units] [WRITE] Criar nova Unidade Organizacional.

Inputs: name (required), path (required), dry_run, description, +3 more. Returns: result

ad_create_userC

[Users] [WRITE] Criar novo usuario no Active Directory.

Inputs: path (required), sam_account_name (required), mail, name, +10 more. Returns: result

ad_delete_computerC

[Computers & Devices] [DESTRUCTIVE] Excluir conta de computador.

Inputs: identity (required), dry_run, correlation_id, confirmation_token. Returns: result

ad_delete_dns_recordC

[DNS & Infrastructure] [DESTRUCTIVE] Excluir registro DNS de uma zona.

Inputs: name (required), zone_name (required), dry_run, record_type, +2 more. Returns: result

ad_delete_gpoC

[Group Policy Objects] [DESTRUCTIVE] Excluir GPO com confirmacao.

Inputs: identity (required), dry_run, correlation_id, confirmation_token. Returns: result

ad_delete_groupC

[Groups & Members] [DESTRUCTIVE] Excluir grupo do Active Directory.

Inputs: identity (required), dry_run, correlation_id, confirmation_token. Returns: result

ad_delete_ouC

[Organizational Units] [DESTRUCTIVE] Excluir OU com validacao de protecao e conteudo.

Inputs: identity (required), dry_run, recursive, correlation_id, +1 more. Returns: result

ad_delete_userC

[Users] [DESTRUCTIVE] Excluir conta de usuario com confirmacao.

Inputs: identity (required), dry_run, correlation_id, confirmation_token. Returns: result

ad_disable_computerC

[Computers & Devices] [WRITE] Desabilitar conta de computador.

Inputs: identity (required), dry_run, correlation_id, confirmation_token. Returns: result

ad_disable_userC

[Users] [WRITE] Desabilitar conta de usuario.

Inputs: identity (required), dry_run, correlation_id, confirmation_token. Returns: result

ad_enable_computerC

[Computers & Devices] [WRITE] Habilitar conta de computador.

Inputs: identity (required), dry_run, correlation_id, confirmation_token. Returns: result

ad_enable_userC

[Users] [WRITE] Habilitar conta de usuario.

Inputs: identity (required), dry_run, correlation_id, confirmation_token. Returns: result

ad_generate_computer_reportC

[Reports, Inventory & Automation] [READ] Gerar relatorio de computadores.

Inputs: limit, output_format, correlation_id. Returns: result

ad_generate_domain_health_reportC

[Reports, Inventory & Automation] [READ] Relatorio de saude do dominio.

Inputs: output_format, correlation_id. Returns: result

ad_generate_domain_inventoryC

[Reports, Inventory & Automation] [READ] Gerar inventario completo do dominio.

Inputs: output_format, correlation_id. Returns: result

ad_generate_gpo_reportC

[Reports, Inventory & Automation] [READ] Gerar relatorio consolidado de GPOs.

Inputs: output_format, correlation_id. Returns: result

ad_generate_group_reportC

[Reports, Inventory & Automation] [READ] Gerar relatorio de grupos.

Inputs: limit, output_format, correlation_id. Returns: result

ad_generate_inactive_accounts_reportC

[Reports, Inventory & Automation] [READ] Relatorio de contas inativas.

Inputs: days, output_format, correlation_id. Returns: result

ad_generate_security_audit_reportC

[Reports, Inventory & Automation] [READ] Gerar relatorio de auditoria de seguranca.

Inputs: output_format, correlation_id. Returns: result

ad_generate_user_reportC

[Reports, Inventory & Automation] [READ] Gerar relatorio de usuarios.

Inputs: limit, output_format, correlation_id. Returns: result

ad_get_admin_count_usersC

[Security & Audit] [READ] Identificar contas com atributo adminCount relevante.

Inputs: correlation_id. Returns: result

ad_get_computerC

[Computers & Devices] [READ] Consultar detalhes de um computador.

Inputs: identity (required), correlation_id. Returns: result

ad_get_dc_event_logsC

[Replication, Health & Diagnostics] [READ] Consultar eventos relevantes dos controladores.

Inputs: hours, limit, log_name, correlation_id. Returns: result

ad_get_dc_services_statusC

[Replication, Health & Diagnostics] [READ] Consultar estado dos servicos essenciais do DC.

Inputs: server, correlation_id. Returns: result

ad_get_delegated_permissionsC

[Security & Audit] [READ] Auditar delegacoes de permissoes em objetos.

Inputs: identity (required), correlation_id. Returns: result

ad_get_directory_healthC

[Replication, Health & Diagnostics] [READ] Executar verificacoes de saude do Active Directory.

Inputs: server, correlation_id. Returns: result

ad_get_disabled_accountsC

[Security & Audit] [READ] Listar contas desabilitadas.

Inputs: limit, correlation_id. Returns: result

ad_get_dns_recordC

[DNS & Infrastructure] [READ] Consultar registro DNS especifico.

Inputs: name (required), zone_name (required), record_type, correlation_id. Returns: result

ad_get_dns_zoneC

[DNS & Infrastructure] [READ] Consultar detalhes e configuracoes de zona DNS.

Inputs: zone_name (required), correlation_id. Returns: result

ad_get_domain_adminsC

[Security & Audit] [READ] Consultar membros do grupo Domain Admins.

Inputs: correlation_id. Returns: result

ad_get_domain_controller_infoC

[Domain & Domain Controllers] [READ] Consultar detalhes de um DC.

Inputs: identity (required), correlation_id. Returns: result

ad_get_domain_functional_levelC

[Domain & Domain Controllers] [READ] Consultar nivel funcional do dominio.

Inputs: correlation_id. Returns: result

ad_get_domain_infoC

[Domain & Domain Controllers] [READ] Consultar informacoes detalhadas do dominio atual.

Inputs: server, correlation_id. Returns: result

ad_get_domain_trustsC

[Domain & Domain Controllers] [READ] Consultar relacoes de confianca.

Inputs: correlation_id. Returns: result

ad_get_forest_functional_levelC

[Domain & Domain Controllers] [READ] Consultar nivel funcional da floresta.

Inputs: correlation_id. Returns: result

ad_get_forest_infoC

[Domain & Domain Controllers] [READ] Consultar informacoes da floresta Active Directory.

Inputs: correlation_id. Returns: result

ad_get_fsmo_rolesC

[Domain & Domain Controllers] [READ] Consultar detentores das funcoes FSMO.

Inputs: correlation_id. Returns: result

ad_get_gpoC

[Group Policy Objects] [READ] Consultar detalhes de uma GPO.

Inputs: identity (required), correlation_id. Returns: result

ad_get_gpo_reportC

[Group Policy Objects] [READ] Gerar relatorio XML ou HTML de GPO.

Inputs: identity (required), report_type, correlation_id. Returns: result

ad_get_groupB

[Groups & Members] [READ] Consultar detalhes e contagem de membros de grupo.

Inputs: identity (required), correlation_id. Returns: result

ad_get_inactive_usersC

[Security & Audit] [READ] Identificar usuarios sem atividade recente.

Inputs: days, limit, correlation_id. Returns: result

ad_get_locked_accountsC

[Security & Audit] [READ] Listar contas bloqueadas.

Inputs: limit, correlation_id. Returns: result

ad_get_nested_group_membershipC

[Groups & Members] [READ] Consultar associacao recursiva a grupos.

Inputs: identity (required), correlation_id. Returns: result

ad_get_ouC

[Organizational Units] [READ] Consultar detalhes de uma OU.

Inputs: identity (required), correlation_id. Returns: result

ad_get_ou_hierarchyC

[Organizational Units] [READ] Consultar hierarquia completa de OUs.

Inputs: correlation_id. Returns: result

ad_get_ou_protection_statusC

[Organizational Units] [READ] Consultar estado da protecao contra exclusao acidental.

Inputs: identity (required), correlation_id. Returns: result

ad_get_password_expiring_usersC

[Security & Audit] [READ] Identificar senhas proximas do vencimento.

Inputs: days, limit, correlation_id. Returns: result

ad_get_password_never_expires_usersC

[Security & Audit] [READ] Identificar contas com senha que nunca expira.

Inputs: limit, correlation_id. Returns: result

ad_get_privileged_usersC

[Security & Audit] [READ] Identificar usuarios em grupos privilegiados.

Inputs: correlation_id. Returns: result

ad_get_replication_failuresC

[Replication, Health & Diagnostics] [READ] Identificar falhas de replicacao.

Inputs: server, correlation_id. Returns: result

ad_get_replication_partnersC

[Replication, Health & Diagnostics] [READ] Listar parceiros de replicacao.

Inputs: server, correlation_id. Returns: result

ad_get_replication_statusC

[Replication, Health & Diagnostics] [READ] Consultar estado da replicacao.

Inputs: server, correlation_id. Returns: result

ad_get_security_group_changesC

[Security & Audit] [READ] Consultar alteracoes em grupos de seguranca nos logs.

Inputs: hours, limit, correlation_id. Returns: result

ad_get_stale_computersC

[Computers & Devices] [READ] Identificar computadores inativos ha determinado periodo.

Inputs: days, limit, correlation_id. Returns: result

ad_get_sysvol_statusC

[Replication, Health & Diagnostics] [READ] Verificar disponibilidade e estado do SYSVOL.

Inputs: server, correlation_id. Returns: result

ad_get_time_sync_statusC

[Replication, Health & Diagnostics] [READ] Verificar sincronizacao de horario.

Inputs: server, correlation_id. Returns: result

ad_get_userC

[Users] [READ] Consultar detalhes de um usuario.

Inputs: identity (required), properties, correlation_id. Returns: result

ad_get_user_groupsC

[Groups & Members] [READ] Consultar grupos de um usuario.

Inputs: identity (required), correlation_id. Returns: result

ad_list_computersC

[Computers & Devices] [READ] Listar computadores do dominio.

Inputs: limit, search_base, enabled_only, correlation_id. Returns: result

ad_list_dns_recordsC

[DNS & Infrastructure] [READ] Listar registros DNS de uma zona.

Inputs: zone_name (required), limit, record_type, correlation_id. Returns: result

ad_list_dns_zonesB

[DNS & Infrastructure] [READ] Listar zonas DNS integradas ao Active Directory.

Inputs: correlation_id. Returns: result

ad_list_domain_controllersB

[Domain & Domain Controllers] [READ] Listar controladores de dominio.

Inputs: correlation_id. Returns: result

ad_list_domainsB

[Domain & Domain Controllers] [READ] Listar dominios disponiveis na floresta.

Inputs: correlation_id. Returns: result

ad_list_gposC

[Group Policy Objects] [READ] Listar todas as Group Policy Objects (GPOs).

Inputs: limit, correlation_id. Returns: result

ad_list_group_membersC

[Groups & Members] [READ] Listar membros de grupo (diretos ou recursivos).

Inputs: identity (required), recursive, correlation_id. Returns: result

ad_list_groupsC

[Groups & Members] [READ] Listar grupos com filtros de escopo e categoria.

Inputs: limit, group_scope, search_base, correlation_id, +1 more. Returns: result

ad_list_ou_objectsC

[Organizational Units] [READ] Listar objetos de uma OU.

Inputs: ou_distinguished_name (required), limit, object_class, correlation_id. Returns: result

ad_list_ousC

[Organizational Units] [READ] Listar unidades organizacionais (OUs).

Inputs: limit, search_base, correlation_id. Returns: result

ad_list_usersC

[Users] [READ] Listar usuarios com filtros configuraveis.

Inputs: limit, search_base, enabled_only, correlation_id. Returns: result

ad_move_computerC

[Computers & Devices] [WRITE] Mover computador entre OUs.

Inputs: identity (required), target_path (required), dry_run, correlation_id, +1 more. Returns: result

ad_move_objectC

[Organizational Units] [WRITE] Mover qualquer objeto entre OUs.

Inputs: identity (required), target_ou (required), dry_run, correlation_id, +1 more. Returns: result

ad_remove_group_memberC

[Groups & Members] [WRITE] Remover membro(s) de um grupo.

Inputs: group (required), members (required), dry_run, correlation_id, +1 more. Returns: result

ad_reset_user_passwordC

[Users] [DESTRUCTIVE] Redefinir senha de usuario com seguranca.

Inputs: identity (required), new_password (required), dry_run, correlation_id, +2 more. Returns: result

ad_run_compliance_assessmentC

[Reports, Inventory & Automation] [READ] Executar avaliacao de conformidade baseada em regras.

Inputs: correlation_id. Returns: result

ad_search_computersC

[Computers & Devices] [READ] Pesquisar computadores por nome, sistema operacional ou OU.

Inputs: query (required), limit, correlation_id. Returns: result

ad_search_usersB

[Users] [READ] Pesquisar usuarios por nome, login, e-mail ou atributo.

Inputs: query (required), limit, correlation_id. Returns: result

ad_set_ou_protectionC

[Organizational Units] [WRITE] Habilitar ou desabilitar protecao contra exclusao acidental.

Inputs: identity (required), protected (required), dry_run, correlation_id, +1 more. Returns: result

ad_sync_replicationC

[Replication, Health & Diagnostics] [WRITE] Solicitar sincronizacao de replicacao.

Inputs: all_dcs, dry_run, target_dc, correlation_id, +1 more. Returns: result

ad_test_dns_resolutionC

[DNS & Infrastructure] [READ] Testar resolucao de nomes DNS.

Inputs: name (required), dns_server, correlation_id. Returns: result

ad_test_domain_controllerC

[Domain & Domain Controllers] [READ] Verificar disponibilidade de um DC.

Inputs: target_host, correlation_id. Returns: result

ad_test_kerberos_connectivityC

[DNS & Infrastructure] [READ] Verificar conectividade e funcionamento do Kerberos.

Inputs: server, correlation_id. Returns: result

ad_test_ldap_connectivityC

[DNS & Infrastructure] [READ] Testar conectividade LDAP/LDAPS.

Inputs: port, server, correlation_id. Returns: result

ad_test_secure_channelC

[Replication, Health & Diagnostics] [READ] Testar canal seguro de computadores.

Inputs: computer_name, correlation_id. Returns: result

ad_unlock_userC

[Users] [WRITE] Desbloquear conta travada.

Inputs: identity (required), dry_run, correlation_id, confirmation_token. Returns: result

ad_update_computerC

[Computers & Devices] [WRITE] Atualizar atributos de computador.

Inputs: identity (required), dry_run, location, managed_by, +3 more. Returns: result

ad_update_dns_recordC

[DNS & Infrastructure] [WRITE] Atualizar registro DNS existente.

Inputs: name (required), zone_name (required), dry_run, record_type, +4 more. Returns: result

ad_update_gpoC

[Group Policy Objects] [WRITE] Atualizar configuracoes suportadas de GPO.

Inputs: identity (required), comment, dry_run, gpo_status, +2 more. Returns: result

ad_update_groupC

[Groups & Members] [WRITE] Atualizar atributos de um grupo.

Inputs: identity (required), dry_run, managed_by, description, +3 more. Returns: result

ad_update_ouC

[Organizational Units] [WRITE] Atualizar atributos de uma OU.

Inputs: identity (required), dry_run, managed_by, description, +2 more. Returns: result

ad_update_userC

[Users] [WRITE] Atualizar atributos de usuario existente.

Inputs: identity (required), mail, title, company, +6 more. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 100 tools

    Disambiguation3/5

    Core resource tools are mostly distinguishable by resource and action, and category labels help. However, the 100-tool surface creates notable overlaps among reporting, health, replication, and move/object tools, such as ad_get_gpo_report vs ad_generate_gpo_report, ad_move_object vs ad_move_computer, and ad_get_directory_health vs ad_generate_domain_health_report.

    Naming Consistency5/5

    All tools consistently use the ad_ prefix with snake_case verb_noun naming, such as ad_list_users, ad_get_group, and ad_create_dns_record. A few longer names encode multi-word nouns, but the overall convention is predictable and uniform.

    Tool Count1/5

    A 100-tool surface is far beyond the appropriate range and creates a heavy selection and context burden. Many tools are narrow read/report variants that could be consolidated or exposed through parameters.

    Completeness4/5

    The server covers CRUD and lifecycle operations for users, groups, computers, OUs, GPOs, and DNS records, plus substantial health, replication, security audit, and reporting coverage. Minor gaps remain around sites/subnets, contacts, fine-grained password policies, and generic object/attribute operations, but major AD workflows are supported.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables controlled AI-agent access to enterprise-shaped tools with a deny-by-default gated write path, human approval, dry-run execution, and append-only audit logging.
      1
      -
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI agents to perform read-only LDAP directory queries and audits, including user searches, group membership checks, inactive-account detection, and access-list reconciliation.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to safely interact with operations systems such as cloud inventory, runbooks, and ticketing while enforcing role-based access, JWT authentication, write confirmation, secret and PII redaction, rate limits, and audit logging.
      MIT