GitHits
Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.
Read-only Active Directory / LDAP: users, groups, memberships and security audits.
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 12/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
mcpAD をインストールして。https://mcp.popnx.com/i/matteoredaelli-mcpad.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月18日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
mcpAD のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server mcpAD を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "mcpad": { "command": "uvx", "args": [ "mcpad" ], "env": { "MSAD_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) MSAD_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、mcpAD のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
SettingsDeveloperEdit Config
{
"mcpServers": {
"mcpad": {
"command": "uvx",
"args": [
"mcpad"
],
"env": {
"MSAD_PASSWORD": "your-value"
}
}
}
}キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
mcpAD を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が mcpAD を使っていると言うか、回答に mcpAD のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
MSAD_DOMAIN ツール呼び出しで省略された場合に使用する既定の AD ドメイン(/.msad.toml のセクション) MSAD_HOST ドメインコントローラーのホスト(/.msad.toml の代替) MSAD_BASE LDAP のベース DN(例: dc=example,dc=com) MSAD_USER バインドユーザー(ユーザー/パスワード認証) MCPAD_ALLOW_WRITE 真の値を設定するとグループメンバーシップの書き込みツールを有効にします(デフォルト:読み取り専用) 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ mcpAD につなげません
mcpAD はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · mcpAD につなげるアプリを使う
B · サイバーセキュリティ の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
mcpAD のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server mcpAD を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user mcpad --env MSAD_PASSWORD=your-value -- uvx mcpad 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) MSAD_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、mcpAD のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user mcpad --env MSAD_PASSWORD=your-value -- uvx mcpadEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
mcpAD が一覧にあり、接続済みと表示されれば OK です
mcpAD を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が mcpAD を使っていると言うか、回答に mcpAD のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
MSAD_DOMAIN ツール呼び出しで省略された場合に使用する既定の AD ドメイン(/.msad.toml のセクション) MSAD_HOST ドメインコントローラーのホスト(/.msad.toml の代替) MSAD_BASE LDAP のベース DN(例: dc=example,dc=com) MSAD_USER バインドユーザー(ユーザー/パスワード認証) MCPAD_ALLOW_WRITE 真の値を設定するとグループメンバーシップの書き込みツールを有効にします(デフォルト:読み取り専用) 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
mcpAD のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server mcpAD を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "mcpad": { "command": "uvx", "args": [ "mcpad" ], "env": { "MSAD_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) MSAD_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、mcpAD のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
mcpAD の設定で MSAD_PASSWORD が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
mcpAD を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が mcpAD を使っていると言うか、回答に mcpAD のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
MSAD_DOMAIN ツール呼び出しで省略された場合に使用する既定の AD ドメイン(/.msad.toml のセクション) MSAD_HOST ドメインコントローラーのホスト(/.msad.toml の代替) MSAD_BASE LDAP のベース DN(例: dc=example,dc=com) MSAD_USER バインドユーザー(ユーザー/パスワード認証) MCPAD_ALLOW_WRITE 真の値を設定するとグループメンバーシップの書き込みツールを有効にします(デフォルト:読み取り専用) 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
mcpAD のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server mcpAD を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "mcpad": { "type": "stdio", "command": "uvx", "args": [ "mcpad" ], "env": { "MSAD_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) MSAD_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、mcpAD のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
mcpAD の設定で MSAD_PASSWORD が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
mcpAD を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が mcpAD を使っていると言うか、回答に mcpAD のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
MSAD_DOMAIN ツール呼び出しで省略された場合に使用する既定の AD ドメイン(/.msad.toml のセクション) MSAD_HOST ドメインコントローラーのホスト(/.msad.toml の代替) MSAD_BASE LDAP のベース DN(例: dc=example,dc=com) MSAD_USER バインドユーザー(ユーザー/パスワード認証) MCPAD_ALLOW_WRITE 真の値を設定するとグループメンバーシップの書き込みツールを有効にします(デフォルト:読み取り専用) 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Claude Code
claude mcp add --scope user mcpad --env MSAD_PASSWORD=your-value -- uvx mcpadClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"mcpad": {
"command": "uvx",
"args": [
"mcpad"
],
"env": {
"MSAD_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"mcpad": {
"command": "uvx",
"args": [
"mcpad"
],
"env": {
"MSAD_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"mcpad": {
"type": "stdio",
"command": "uvx",
"args": [
"mcpad"
],
"env": {
"MSAD_PASSWORD": "your-value"
}
}
}
}MSAD_DOMAIN envMSAD_HOST envMSAD_BASE envMSAD_USER envMSAD_PASSWORD 秘密 必須 envMCPAD_ALLOW_WRITE env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント matteoredaelli で確認済みです
コードの最終更新:昨日
GPL-3.0を使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に mcpad@0.8.3 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月18日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/matteoredaelli-mcpad)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:MSAD_PASSWORD
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は昨日、最新バージョン(0.8.3)がレジストリに届いたのは昨日です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
同じカテゴリには:GitHits, Dependency Management MCP Server, Snyk MCP, TokenSafe, Draugr
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
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.
| これ mcpAD | GitHits | Dependency Management MCP Server | Snyk MCP | TokenSafe | Draugr | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドでもパソコンにインストールでも使える | クラウドで動き、インストール不要 | パソコンにインストールが必要 | クラウドでもパソコンにインストールでも使える | パソコンにインストールが必要 |
| キーが必要 | はい | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 5/5 | 3/4 | 3/3 | 5/5 | 3/3 |
| ライセンス | GPL-3.0 | Apache-2.0 | – | Apache-2.0 | MIT | Apache-2.0 |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
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