GitHits
Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.
Active Directory / LDAP MCP server: find users, groups, memberships; read-only security audits.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 12/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Active Directory / LDAP. Sigue https://mcp.popnx.com/i/matteoredaelli-active-directory-ldap-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 18 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Active Directory / LDAP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Active Directory / LDAP para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "active-directory-ldap": { "command": "uvx", "args": [ "mcpad" ], "env": { "MSAD_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MSAD_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Active Directory / LDAP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
SettingsDeveloperEdit Config
{
"mcpServers": {
"active-directory-ldap": {
"command": "uvx",
"args": [
"mcpad"
],
"env": {
"MSAD_PASSWORD": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Active Directory / LDAP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Active Directory / LDAP o muestra una herramienta de Active Directory / LDAP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MSAD_DOMAIN Dominio AD predeterminado (sección de /.msad.toml) cuando una llamada a herramienta lo omite MSAD_HOST Host del controlador de dominio (alternativa a /.msad.toml) MSAD_BASE DN base de LDAP, p. ej. dc=example,dc=com MSAD_USER Usuario de enlace (autenticación usuario/contraseña) MCPAD_ALLOW_WRITE Establecer en un valor verdadero para habilitar las herramientas de escritura de pertenencia a grupos (predeterminado: solo lectura) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Active Directory / LDAP
Active Directory / LDAP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Active Directory / LDAP
B · Otros en Ciberseguridad que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Active Directory / LDAP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Active Directory / LDAP para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user active-directory-ldap --env MSAD_PASSWORD=your-value -- uvx mcpad 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MSAD_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Active Directory / LDAP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user active-directory-ldap --env MSAD_PASSWORD=your-value -- uvx mcpadCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Active Directory / LDAP en la lista como conectado
Usa Active Directory / LDAP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Active Directory / LDAP o muestra una herramienta de Active Directory / LDAP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MSAD_DOMAIN Dominio AD predeterminado (sección de /.msad.toml) cuando una llamada a herramienta lo omite MSAD_HOST Host del controlador de dominio (alternativa a /.msad.toml) MSAD_BASE DN base de LDAP, p. ej. dc=example,dc=com MSAD_USER Usuario de enlace (autenticación usuario/contraseña) MCPAD_ALLOW_WRITE Establecer en un valor verdadero para habilitar las herramientas de escritura de pertenencia a grupos (predeterminado: solo lectura) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Active Directory / LDAP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Active Directory / LDAP para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "active-directory-ldap": { "command": "uvx", "args": [ "mcpad" ], "env": { "MSAD_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MSAD_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Active Directory / LDAP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de Active Directory / LDAP, MSAD_PASSWORD está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Active Directory / LDAP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Active Directory / LDAP o muestra una herramienta de Active Directory / LDAP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MSAD_DOMAIN Dominio AD predeterminado (sección de /.msad.toml) cuando una llamada a herramienta lo omite MSAD_HOST Host del controlador de dominio (alternativa a /.msad.toml) MSAD_BASE DN base de LDAP, p. ej. dc=example,dc=com MSAD_USER Usuario de enlace (autenticación usuario/contraseña) MCPAD_ALLOW_WRITE Establecer en un valor verdadero para habilitar las herramientas de escritura de pertenencia a grupos (predeterminado: solo lectura) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Active Directory / LDAP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Active Directory / LDAP para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "active-directory-ldap": { "type": "stdio", "command": "uvx", "args": [ "mcpad" ], "env": { "MSAD_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MSAD_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Active Directory / LDAP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de Active Directory / LDAP, MSAD_PASSWORD está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Active Directory / LDAP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Active Directory / LDAP o muestra una herramienta de Active Directory / LDAP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MSAD_DOMAIN Dominio AD predeterminado (sección de /.msad.toml) cuando una llamada a herramienta lo omite MSAD_HOST Host del controlador de dominio (alternativa a /.msad.toml) MSAD_BASE DN base de LDAP, p. ej. dc=example,dc=com MSAD_USER Usuario de enlace (autenticación usuario/contraseña) MCPAD_ALLOW_WRITE Establecer en un valor verdadero para habilitar las herramientas de escritura de pertenencia a grupos (predeterminado: solo lectura) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user active-directory-ldap --env MSAD_PASSWORD=your-value -- uvx mcpadClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"active-directory-ldap": {
"command": "uvx",
"args": [
"mcpad"
],
"env": {
"MSAD_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"active-directory-ldap": {
"command": "uvx",
"args": [
"mcpad"
],
"env": {
"MSAD_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"active-directory-ldap": {
"type": "stdio",
"command": "uvx",
"args": [
"mcpad"
],
"env": {
"MSAD_PASSWORD": "your-value"
}
}
}
}MSAD_DOMAIN envMSAD_HOST envMSAD_BASE envMSAD_USER envMSAD_PASSWORD secreto obligatorio envMCPAD_ALLOW_WRITE envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
pypi: mcpadSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub matteoredaelli, dueña del repo
Último cambio de código: ayer
Usa GPL-3.0
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para mcpad@0.8.4
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 18 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/matteoredaelli-active-directory-ldap-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: MSAD_PASSWORD
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez ayer, y la última versión (0.8.4) llegó al registro ayer.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: GitHits, Dependency Management MCP Server, Snyk MCP, TokenSafe, Draugr
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.
Sonatype component intelligence: versions, security analysis, and Trust Score recommendations
Easily find and fix security issues in your applications leveraging Snyk platform capabilities.
Your AI agent is smart enough to code all day. Local firewall & zero-loss runtime.
Security scanning for AI agents: SAST, SCA, secrets, IaC, DAST, ranked by real risk.
| Este Active Directory / LDAP | GitHits | Dependency Management MCP Server | Snyk MCP | TokenSafe | Draugr | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | En la nube o instalado en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | En la nube o instalado en tu equipo | Se instala en tu equipo |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 5/5 | 3/4 | 3/3 | 5/5 | 3/3 |
| Licencia | GPL-3.0 | Apache-2.0 | – | Apache-2.0 | MIT | Apache-2.0 |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
A FastMCP server that exposes the msad Active Directory / LDAP library as MCP tools.
Built with Python 3.14 and uv. It reuses the typed, public msad API (search users/groups, memberships, account status, read-only security audits). All tools are read-only by default; optional group-membership write tools are disabled unless MCPAD_ALLOW_WRITE is enabled (see Write tools).
| Tool | Description |
|---|---|
find_users | Find users by name/surname/mail/sam/department/city/state/country (ANDed, * wildcards) |
get_user | Get a single user (exact match) |
find_groups | Find groups (* wildcards) |
get_group | Get a single group (exact match) |
find_computers | Find computers by name/dns/os (* wildcards); optionally exclude_domain_controllers |
get_computer | Get a single computer (sAMAccountName/cn/dNSHostName) |
find_contacts | Find AD contact objects by cn/mail/displayName (* wildcards) |
find_ous | Find organizational units by name (* wildcards) |
get_ou | Get a single OU by its ou name or full DN (exact match) |
get_ou_contents | List objects under an OU (optionally filtered by object_class) |
find_empty_ous | Organizational units with no nested sub-OU (hygiene/audit) |
find_inactive_users | Find users whose last logon is older than days (default 90) |
find_stale_computers | Find computers whose last logon is older than days (default 90) |
disabled_users | List disabled user accounts (audit; counterpart of is_disabled) |
locked_users | List locked-out user accounts (audit; counterpart of is_locked) |
never_expires_password | List users whose password never expires (audit) |
never_expiring_accounts | List users whose ACCOUNT (not password) never expires |
expired_accounts | List users whose accountExpires date is in the past |
password_not_required | Risk: users with the PASSWD_NOTREQD UAC flag (account may have no password) |
kerberos_preauth_not_required | Risk: users not requiring Kerberos pre-auth (AS-REP roasting exposure) |
not_delegated | Risk: accounts flagged "sensitive and cannot be delegated" |
find_service_accounts | Risk: users with a Service Principal Name set (Kerberoasting exposure) |
find_admin_count_accounts | Users with adminCount=1 (current or stale protected-admin marker) |
find_must_change_password | Enabled users who must change their password at next logon (pwdLastSet=0) |
find_users_without_email | Data-quality check: users with no mail attribute set |
find_almost_locked_out | Enabled users close to the lockout threshold (badPwdCount) |
find_credentials_in_description | Risk: users whose description may contain a plaintext credential |
find_shadow_credentials | Risk: users/computers with a msDS-KeyCredentialLink (Shadow Credentials) |
find_obsolete_os_computers | Computers running a commonly-cited end-of-life Windows version |
audit_admin_accounts | Members of well-known privileged groups (admin-account audit) |
list_fsmo_roles | Owners of the five FSMO roles (schema, domain-naming, PDC, RID, infrastructure) |
list_trusts | Domain trust relationships (trustedDomain objects) |
list_sites | Active Directory sites (from the Configuration naming context) |
list_domain_controllers | Domain controllers (computer accounts flagged SERVER_TRUST_ACCOUNT) |
summarize_computer_os | Count of computer accounts grouped by operating system |
list_empty_groups | Groups with no direct members (hygiene/audit) |
find_security_groups | List security-enabled groups, optionally by scope (global/domain_local/universal) |
find_distribution_groups | List distribution groups (complement of find_security_groups) |
find_admin_count_groups | Groups with adminCount=1 (current or stale protected-group marker) |
list_gpos | Group Policy Objects (groupPolicyContainer) |
get_gpo | A single GPO by its cn (GUID) or displayName |
list_fine_grained_password_policies | Fine-grained password policies (PSOs) |
find_recently_modified | Objects whose whenChanged is within the last days days, optionally by object_class |
find_recently_created | Objects whose whenCreated is within the last days days, optionally by object_class |
get_domain_info | Domain object: security-relevant settings and metadata (audit) |
get_password_policy | Default domain password policy (audit) |
get_password_policy_violations | Users whose password violates the policy (audit) |
get_privileged_groups | Well-known privileged groups with member counts (audit) |
get_by_dn | Fetch any entry directly by its DN (resolve manager / managedBy) |
get_dn | Resolve a sAMAccountName (or DN) to a distinguished name |
search_ldap | Run a raw, read-only LDAP search with a custom filter (power-user escape hatch) |
group_members | List group members (direct or nested) |
user_groups | List a user's groups (nested by default) |
is_member | Is a user a (nested) member of a group? |
is_disabled | Is an account disabled? |
is_locked | Is an account locked? |
test_connection | Test AD connectivity and bind (returns ok/target/auth/error) |
whoami | Identity bound as (RFC 4532 "Who Am I?"); works with Kerberos too |
health | Server health check (server name, msad version, connectivity) |
The find_users, find_groups, find_computers and find_ous tools accept an optional base (a DN, e.g. an OU) to restrict the search to that subtree instead of the whole domain.
Every tool advertises standard MCP behavior hints so a client can reason about its risk without parsing the name or docstring. All the tools above are read-only (readOnlyHint: true); the optional write tools (see below) are marked destructiveHint: true (and readOnlyHint: false).
By default get_user / find_users return a useful attribute set: identity fields plus manager — the distinguished name (DN) of the user's manager, e.g. CN=Anna Bianchi,OU=Staff,DC=group,DC=example,DC=com — as well as memberOf (direct group DNs), userAccountControl, accountExpires, lastLogonTimestamp and whenCreated. Group lookups include managedBy (the DN of the group's owner), member, groupType and whenCreated.
To expand a manager (or any DN-valued field) into a full record, call get_by_dn with that DN. This is a direct, efficient lookup (the DN is used as the search base), so an agent can do: get_user("mrossi") → read manager → get_by_dn(" ").
By default the server also adds decoded companion keys next to the raw attributes, so a client doesn't have to interpret AD's opaque numbers and binary blobs:
userAccountControl_decoded — a flag list plus booleans (disabled, locked, password_never_expires, ...);groupType_decoded — scope (global / domain_local / universal) and security vs. distribution;objectSid_decoded / objectGUID_decoded — canonical S-1-5-... / GUID strings; _iso — an ISO-8601 timestamp for FILETIME attributes (accountExpires, lastLogonTimestamp, pwdLastSet, lockoutTime, ...), omitted for the "never"/unset sentinels.The raw attributes are always preserved. Decoding is on by default; set MCPAD_DECODE_ATTRS to a falsy value (0, false, no, off) to return raw attributes only.
The tools above are all read-only. Two optional write tools modify AD group membership and are therefore disabled by default. They are registered only when the MCPAD_ALLOW_WRITE environment variable is set to a truthy value (1, true, yes, on):
| Tool | Description |
|---|---|
add_group_member | Add a user to a group (both as sAMAccountName or DN) |
remove_group_member | Remove a user from a group (both as sAMAccountName or DN) |
unlock_account | Unlock a locked-out user account (resets lockoutTime to 0) |
MCPAD_ALLOW_WRITE=1 uv run mcpad # write tools registered
uv run mcpad # read-only (default)
The service account used by msad must have the directory permissions to modify the target groups; otherwise the call fails with an MsadError. When writes are disabled the tools are not advertised at all, so an agent cannot invoke them.
All write tools are two-phase. The first call (confirm=false, the default) makes no change and returns a preview:
{ "status": "confirmation_required", "ok": false, "group": "Sales", "user": "jdoe",
"message": "Would add user 'jdoe' to group 'Sales'. Re-call with confirm=true ..." }
Call again with confirm=true — only after explicit human approval — to apply the change. An agent must never set confirm=true on its own.
Even with writes enabled, membership changes that touch sensitive objects are refused (returned as status: "error"), regardless of confirm:
administrator, admin, krbtgt, guest, system, plus any name matching a service/machine pattern (*$ machine accounts, svc_*, service_*, sa_*, adm_*, sys_*).Domain Admins, Enterprise Admins, Schema Admins, Administrators, the operator groups, Group Policy Creator Owners, DnsAdmins, and Domain Users (critical system group).Matching is case-insensitive and works whether you pass a sAMAccountName or a full DN. Extend or tune via environment variables:
| Variable | Effect |
|---|---|
MCPAD_PROTECTED_ACCOUNTS | Comma-separated extra account names to protect |
MCPAD_PROTECTED_GROUPS | Comma-separated extra group names to protect |
MCPAD_DISABLE_GUARDRAILS | Set truthy to turn the checks off (not recommended) |
Set MCPAD_AUDIT_LOG to a file path to record every tool call (read-only and write alike) as one JSON object per line (JSON-lines). Logging is off by default.
MCPAD_AUDIT_LOG=/var/log/mcpad/audit.log uv run mcpad
Each entry carries the UTC timestamp, the tool name, the (redacted) arguments, the status, the business outcome, the duration, and — on failure — the error:
{"ts": "2026-10-18T20:09:34.029995+00:00", "tool": "add_group_member",
"params": {"group": "Sales", "user": "jdoe", "confirm": true}, "status": "ok", "outcome": "applied", "duration_ms": 12.4}
Notes:
password, new_password, old_password, token, ...) are replaced with ***REDACTED***.status records only whether the Python call returned (ok) or raised (error). The `outcome` field records what actually happened:completed — a read-only tool returned normally (the common case);preview — a two-phase write returned its confirmation preview and changed nothing (confirm=false);blocked — a safety guard-rail refused the write;applied — a write was confirmed and executed;failed — the call raised (paired with status: "error").Every tool's limit argument is clamped to a hard ceiling so a single call can't pull an unbounded number of rows from a domain controller. The default ceiling is 1000; a limit above it — or limit=0, which the underlying msad library treats as "no limit" — is rewritten to the ceiling. A limit below the ceiling is used as-is.
MCPAD_MAX_LIMIT=500 uv run mcpad # lower the ceiling to 500
MCPAD_MAX_LIMIT must be a