# adguardctrl MCP server

> Allows an AI client to inspect and manage AdGuard Home DNS filtering, including query logs, filter lists, and client settings with safety gates.

- Repository: https://github.com/lidless-labs/adguardctrl
- Page: https://hostedmcp.org/servers/lidless-labs/adguardctrl
- Transport: —
- Stars: 2
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ADGUARDHOME_SYNC_PASSWORD` | no | no |  |
| `ADGUARDHOME_SYNC_URL` | no | no |  |
| `ADGUARDHOME_SYNC_USERNAME` | no | no |  |
| `ADGUARD_DEFAULT_INSTANCE` | no | no |  |
| `ADGUARD_PRIMARY_PASSWORD` | no | no |  |
| `ADGUARD_PRIMARY_URL` | no | no |  |
| `ADGUARD_PRIMARY_USERNAME` | no | no |  |
| `ADGUARD_REQUEST_TIMEOUT_MS` | no | no |  |
| `ADGUARD_SECONDARY_PASSWORD` | no | no |  |
| `ADGUARD_SECONDARY_URL` | no | no |  |
| `ADGUARD_SECONDARY_USERNAME` | no | no |  |

## Tools (33)

- `adguard_status`
- `adguard_stats`
- `adguard_query_log`
- `adguard_list_filter_lists`
- `adguard_list_user_rules`
- `adguard_list_clients`
- `adguard_list_blocked_services_catalog`
- `adguard_check_host`
- `adguard_get_blocked_services`
- `adguard_get_dns_config`
- `adguard_get_safesearch_settings`
- `adguard_sync_status`
- `adguard_sync_health`
- `adguard_sync_logs`
- `adguard_add_user_rule`
- `adguard_remove_user_rule`
- `adguard_add_filter_list`
- `adguard_remove_filter_list`
- `adguard_toggle_filter_list`
- `adguard_set_client_blocked_services`
- `adguard_refresh_filter_lists`
- `adguard_add_client`
- `adguard_update_client`
- `adguard_set_blocked_services`
- `adguard_toggle_safesearch`
- `adguard_toggle_safebrowsing`
- `adguard_sync_run`
- `adguard_replace_user_rules`
- `adguard_toggle_protection`
- `adguard_delete_client`
- `adguard_clear_query_log`
- `adguard_reset_stats`
- `adguard_sync_clear_logs`

## FAQ

### How does the server prevent accidental destructive changes?

The adapter uses a safety model where writes require an explicit 'confirm: true' flag, and destructive operations additionally require 'destructive: true'.

### What can I do with the read-only tools?

You can inspect server status, statistics, DNS query logs, filter lists, named clients, DNS rewrites, and DHCP status.

### Can I manage multiple AdGuard Home instances?

Yes, you can configure multiple instances using environment variables and target specific boxes using the instance argument.
