clients_add
Add a new persistent client with per-client settings
How to use it
clients_add is exposed by the MCP Adguard Home MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the clients_add tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install MCP Adguard Home
npx -y @samik081/mcp-adguard-homeOther tools in MCP Adguard Home (39)
Delete a persistent client by name
Retrieve all configured and auto-detected clients with their settings
Search for specific clients by their IDs (IP, MAC, CIDR, or client ID)
Update an existing persistent client by name
Scan for competing DHCP servers on a network interface
Retrieve available network interfaces for DHCP server binding
Retrieve DHCP server configuration, static leases, and active leases
Clear the DNS resolver cache
Retrieve full DNS configuration including upstreams, cache settings, blocking mode, and DNSSEC
Update DNS server configuration (20 optional fields for partial update)
Test upstream DNS server configuration to verify servers are reachable
Add a new filter URL (blocklist or allowlist)
Test whether a hostname would be blocked by current filtering rules
Retrieve filtering configuration including blocklists, allowlists, and user rules
Force refresh of filter lists to fetch latest updates
Remove a filter URL from blocklist or allowlist
Update global filtering configuration (enabled state and update interval)
Set custom filtering rules (replaces all existing custom rules)
Update an existing filter URL (rename, change URL, or enable/disable)
Initiate an AdGuard Home software update
Check for AdGuard Home updates and compare with current version
Retrieve user profile (name, language, theme)
Retrieve server status including version, DNS addresses, protection state, and ports
Enable or disable DNS protection globally, with optional duration for temporary disable
Update user profile settings (name, language, theme)
Retrieve parental filtering status
Enable or disable parental filtering (content restrictions)
Clear the entire DNS query log
Search DNS query log with optional filtering by reason or response status, search term, and pagination
Retrieve query log configuration settings
Update query log configuration (enabled, interval, anonymization)
Retrieve safe browsing (malware/phishing protection) status
Enable or disable safe browsing protection
Retrieve safe search settings showing per-engine enforcement status
Update safe search settings with per-engine configuration (Bing, DuckDuckGo, Google, Pixabay, Yandex, YouTube)
Retrieve DNS statistics including top domains, blocked counts, and client activity
Retrieve statistics configuration settings
Reset all DNS statistics
Update statistics configuration (enabled, interval, ignored domains)