AdGuard Home MCP Server

Read from the package source without running it. The installed server may list more.

• access_get_list

  Retrieve access control lists: allowed clients, disallowed clients, and blocked hosts

• access_set_list

  Set access control lists for allowed clients, disallowed clients, and blocked hosts

• blocked_services_get

  Retrieve currently blocked services list and schedule

• blocked_services_get_all

  List all available services that can be blocked, organized by group

• blocked_services_updatewrite action

  Update the list of blocked services and optional schedule

• clients_add

  Add a new persistent client with per-client settings

• clients_deletewrite action

  Delete a persistent client by name

• clients_get

  Retrieve all configured and auto-detected clients with their settings

• clients_search

  Search for specific clients by their IDs (IP, MAC, CIDR, or client ID)

• clients_updatewrite action

  Update an existing persistent client by name

• dhcp_add_static_lease

  Add a static DHCP lease mapping a MAC address to an IP

• dhcp_find_active

  Scan for competing DHCP servers on a network interface (may take several seconds)

• dhcp_get_interfaces

  Retrieve available network interfaces for DHCP server binding

• dhcp_get_status

  Retrieve DHCP server configuration, static leases, and active leases

• dhcp_remove_static_leasewrite action

  Remove a static DHCP lease (all three fields must match the existing lease)

• dhcp_reset

  Reset DHCP configuration to defaults. This is a destructive operation that cannot be undone.

• dhcp_reset_leases

  Clear all DHCP leases. This is a destructive operation that cannot be undone.

• dhcp_set_configwrite action

  Update DHCP server configuration (enabled state, interface, IPv4/IPv6 settings)

• dhcp_update_static_leasewrite action

  Update a static DHCP lease (removes existing lease and adds a new one)

• dns_clear_cache

  Clear the DNS resolver cache

• dns_get_info

  Retrieve full DNS server configuration including upstreams, bootstrap servers, cache settings, blocking mode, and DNSSEC status

• dns_set_configwrite action

  Update DNS server configuration. All fields are optional -- only provided fields are changed.

• dns_test_upstream

  Test upstream DNS server configuration to verify servers are reachable and responding

• filtering_add_url

  Add a new filter URL (blocklist or allowlist)

• filtering_check_host

  Test whether a hostname would be blocked by current filtering rules

• filtering_get_status

  Retrieve filtering configuration including blocklists, allowlists, user rules, and global enabled state

• filtering_refresh

  Force refresh of filter lists to fetch latest updates

• filtering_remove_urlwrite action

  Remove a filter URL from blocklist or allowlist

• filtering_set_configwrite action

  Update global filtering configuration (enabled state and update interval). Both fields are required -- this is a full replacement.

• filtering_set_rules

  Set custom filtering rules (replaces all existing custom rules)

• filtering_set_urlwrite action

  Update an existing filter URL (rename, change URL, or enable/disable)

• global_begin_updatewrite action

  Initiate an AdGuard Home software update. The server may restart after this operation.

• global_check_version

  Check for AdGuard Home updates and compare with current version

• global_get_profile

  Retrieve user profile (name, language, theme)

• global_get_status

  Retrieve AdGuard Home server status including version, DNS addresses, protection state, and ports

• global_set_protection

  Enable or disable DNS protection globally, with optional duration for temporary disable

• global_update_profilewrite action

  Update user profile settings (name, language, theme). All fields are optional -- only provided fields are updated.

• install_apply_config

  Apply initial setup configuration (web/DNS binding and admin credentials)

• install_check_config

  Validate install configuration without applying (checks web/DNS binding, credentials)

• install_get_addresses

  Retrieve network interface details and ports for initial setup

• mobile_config_get_doh

  Generate Apple .mobileconfig profile for DNS-over-HTTPS. Returns raw XML plist.

• mobile_config_get_dot

  Generate Apple .mobileconfig profile for DNS-over-TLS. Returns raw XML plist.

• parental_get_status

  Retrieve parental filtering status

• parental_set

  Enable or disable parental filtering (content restrictions)

• querylog_clear

  Clear the entire DNS query log. This is a destructive operation that cannot be undone.

• querylog_get

  Search DNS query log with optional filtering by reason or response status, search term, and pagination

• querylog_get_config

  Retrieve query log configuration settings

• querylog_set_configwrite action

  Update query log configuration. All fields are optional -- only provided fields are changed.

• rewrites_add

  Add a new DNS rewrite rule

• rewrites_deletewrite action

  Delete a DNS rewrite rule (both domain and answer must match)

• rewrites_get_settings

  Retrieve DNS rewrite module enabled/disabled state

• rewrites_list

  Retrieve all configured DNS rewrite rules

• rewrites_set_settings

  Enable or disable the DNS rewrite module

• rewrites_updatewrite action

  Update a DNS rewrite rule (removes existing rule and adds updated one)

• safebrowsing_get_status

  Retrieve safe browsing (malware/phishing protection) status

• safebrowsing_set

  Enable or disable safe browsing (malware/phishing protection)

• safesearch_get_status

  Retrieve safe search settings showing per-engine enforcement status

• safesearch_set_settingswrite action

  Update safe search settings. Set global enabled state and optionally configure per-engine enforcement.

• stats_get

  Retrieve DNS statistics including top domains, blocked counts, and client activity. Optional recent param is milliseconds (must be hourly multiple of 3600000).

• stats_get_config

  Retrieve statistics configuration settings

• stats_reset

  Reset all DNS statistics. This is a destructive operation that cannot be undone.

• stats_set_configwrite action

  Update statistics configuration. All fields are optional -- only provided fields are changed.

• tls_get_status

  Retrieve TLS configuration and certificate validation status

• tls_set_configwrite action

  Update TLS configuration including certificates and HTTPS/DoH/DoT settings

• tls_validate

  Validate TLS configuration without applying changes. Tests certificate and key validity.

• Code scan53 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 5 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

AdGuard Home MCP Server: common questions

Is AdGuard Home MCP Server safe?

Mostly: it is graded B (83/100). Read the AdGuard Home MCP Server safety report

How do I install AdGuard Home MCP Server?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does AdGuard Home MCP Server need an API key?

Yes. The registry entry asks for ADGUARD_USERNAME, ADGUARD_PASSWORD.

Is AdGuard Home MCP Server maintained?

The last commit was 6 days ago (2026-09-15). The latest release is v0.9.2.