# AdGuard Home MCP for AI Agents AI Agent Connect > AdGuard Home MCP lets you manage your network's ad blocking and DNS settings directly through your AI agent. Control your blocklists, toggle protection, and monitor server health without ever logging into your web dashboard. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_cQLvzna94LtpfAiutyRuJJkuKEzDFepXCNPRWP5R/ai-agent-connect - **Tags:** dns-filtering, ad-blocking, network-security, privacy, parental-controls, server-monitoring ## Description Instead of jumping through browser tabs and digging through menus to keep your network secure, this Connector lets you manage your AdGuard Home instance through natural conversation. You can ask your agent to see if a specific website is being blocked, add new filter URLs, or toggle global protections with a simple command. It handles the navigation of your DNS settings so you don't have to. This is a major time saver for anyone who manages a home lab or a small office network and wants to keep things safe without the friction of manual configuration. Since Vinkius hosts this Connector, you can get it up and running in minutes, giving your AI the hands it needs to act as your network administrator. You just provide the credentials and let the agent handle the rest. It turns your network security into a conversation rather than a chore. ## Tools ### get_dhcp_status View the current status of your DHCP server. Use this to see how many IPs are currently handed out. ### get_dns_info Pull the current DNS configuration from your instance. It gives you a quick snapshot of your upstream providers. ### get_filtering_status Check which filter lists are active and their current status. This helps you see exactly what's being blocked. ### get_query_log_config View how your DNS query logs are currently set up. Use this to understand what data your server is recording. ### get_query_log Pull the latest entries from your DNS query log. This shows you what your devices are trying to access. ### get_stats Retrieve the latest DNS query statistics. It's a great way to see the volume of traffic your server handles. ### get_status Get a high-level overview of your AdGuard Home server health. This tells you if the service is actually running. ### search_clients Find a specific device in your client list quickly. Use this when you need to find a specific IP or hostname. ### add_rewrite Create a DNS rewrite to point a domain to a specific IP. Use this to redirect traffic or set up local services. ### add_static_lease Assign a permanent IP to a specific device via DHCP. This ensures your devices always have a consistent address. ### check_host See if a specific domain is currently being blocked. It's perfect for troubleshooting why a site won't load. ### get_tls_status Check the current state of your TLS configuration. Use this to verify your security certificates are valid. ### list_blocked_services See a list of all services that are currently blocked. This helps you manage what content is restricted. ### list_clients Get a full list of all clients currently connected to your DNS. Use this to audit who is on your network. ### list_rewrites View all the DNS rewrites you've created. This is handy for keeping track of your custom redirects. ### update_blocked_services Change the schedule for your blocked services. This is useful for turning off certain blocks during specific hours. ### update_query_log_config Modify how your server records DNS queries. Use this to adjust your logging depth or retention. ### add_client Add a new device to your network list. This helps keep track of every hardware unit connected to your DNS. ### add_filter_url Inject a new blocklist URL into your filter settings. It's the fastest way to stay ahead of new trackers. ### configure_tls Set up your TLS settings for secure connections. This ensures your DNS traffic stays private. ### set_dns_config Update your upstream DNS settings and cache parameters. This is how you switch providers or change TTLs. ### set_protection Turn global protection on or off instantly. You can even set a timer for how long the protection stays active. ### set_user_rules Apply custom filtering rules to your network. This lets you block specific sites or allow specific ones manually. ## Prompt Examples **Prompt:** ``` Is my smart TV's internet being blocked right now? ``` **Response:** ``` I've checked the status for your smart TV. It's currently connected, but the domain **streaming.com** is being blocked by your **AdGuard DNS filter** list. ``` **Prompt:** ``` Turn off the ad blocker for the next 15 minutes. ``` **Response:** ``` I've disabled the global protection. It's set to turn back on automatically in 15 minutes (900,000ms). ``` **Prompt:** ``` Add this new blocklist to my filters: https://www.example.com/list.txt ``` **Response:** ``` I've added that new blocklist URL to your filter settings. Your network will start using it to block ads and trackers shortly. ``` ## Capabilities ### Toggle network protection Turn global ad blocking and safe browsing on or off instantly. ### Add filter URLs Inject new blocklists or allowlists into your network settings. ### Check blocked hosts Verify if a specific domain is currently being filtered for a device. ### Update DNS settings Change upstream providers and cache parameters via text commands. ### Manage network clients List, search, and configure settings for all connected devices. ### Configure DHCP leases Assign permanent IP addresses to specific hardware units. ## Use Cases ### Troubleshooting a blocked app A user notices a smart TV can't reach a streaming service. They ask their agent to check_host for that domain to see if a filter is the culprit. ### Temporary filter bypass A parent needs to let a child access a specific site for 30 minutes. They ask the agent to set_protection with a duration to disable blocks temporarily. ### Rapid blocklist updates An admin wants to add a new community-driven blocklist. They tell the agent to add_filter_url to the active list. ### Network auditing A home lab owner wants to see all active devices. They ask the agent to list_clients to get a full inventory of the network. ## Benefits - Skip the dashboard: Use set_protection to toggle network-wide ad blocking without opening a web browser. - Faster troubleshooting: Use check_host to instantly see if a website is blocked for a specific device. - Easier updates: Use add_filter_url to pull in new blocklists in seconds rather than copy-pasting URLs. - Dynamic control: Use set_protection with a duration to temporarily disable filters for maintenance or specific needs. - Better visibility: Use list_clients and search_clients to audit every device on your network from a single chat. - Precise configuration: Use set_dns_config to manage upstream providers and cache settings without digging through menus. ## How It Works The bottom line is you get a hands-free way to manage network security through plain English. 1. Connect your AdGuard Home Base URL and login credentials to the Connector. 2. Tell your AI agent what to check or change using plain English. 3. Watch the agent update your network settings in real-time. ## Frequently Asked Questions **Can I use AdGuard Home MCP to block ads on my whole house?** Yes. By connecting this Connector to your AdGuard Home instance, you can use your AI agent to toggle global protection and manage filter lists for every device on your network. **How does AdGuard Home MCP help with privacy?** It lets you manage your DNS settings and blocklist URLs through natural conversation. You can quickly update your upstream providers or add new privacy filters without manual configuration. **Can I see which devices are connected to my network using AdGuard Home MCP?** Absolutely. You can ask your agent to list all active clients or search for a specific device to see its current status and IP address. **Is it possible to temporarily disable ad blocking with AdGuard Home MCP?** Yes, you can. You can tell your agent to turn off protection for a specific amount of time, and it will automatically turn back on when the time is up. **Can AdGuard Home MCP help me find out why a website isn't loading?** Yes, that's one of its best uses. You can ask the agent to check a specific domain to see if it's being blocked by one of your active filters. **Does AdGuard Home MCP support custom DNS rewrites?** It does. You can use your agent to create or list DNS rewrites, which allows you to point specific domains to different IP addresses on your network. **Can I check if a specific website is being blocked for a specific client?** Yes, use the `check_host` tool. Provide the domain name and optionally the client IP to see if it's filtered and which rule is responsible. **Is it possible to pause the ad-blocking globally for a short period?** Yes. The `set_protection` tool allows you to disable filtering globally. You can also specify a duration in milliseconds if you want it to re-enable automatically. **How do I add a new blocklist URL using the AI?** Simply use the `add_filter_url` action. You'll need to provide a name for the filter, the URL of the list, and specify if it's a whitelist or blocklist.