• REWRITES
  • FILTERS
  • PROTECTION
  • MANUAL

How to update DNS filtering rules with your AI

Connect AdGuard Home to your AI client to manage network security through natural language. You can change how your network handles requests without touching the dashboard.

Ask AI about this page

Short answer

How can I change my DNS settings using AI?

You tell your AI client what you want to block or redirect, and it executes the change directly in AdGuard Home. This covers everything from adding new blocklists to creating custom domain rewrites. You'll see the changes take effect on your network immediately.

Where every change lands.

Security outcomes

Your requests trigger specific updates to your network configuration.

REWRITES

Custom domain redirects

The AI applies new DNS rewrites to point specific domains to different IP addresses. This is useful for local network routing.

FILTERS

Updated blocklists

Your agent adds new filter URLs to your subscription list. This keeps your network protected against new threats.

PROTECTION

Global security toggles

You can flip global protection settings on or off. The AI updates the core security posture of your entire network.

MANUAL

Human review needed

Complex rule logic or bulk deletions stay under your control. You decide when to wipe existing user rules manually.

The workflow

What your AI does when a request arrives.

The AI translates your intent into specific API calls for AdGuard Home.

  1. Redirect domains

    When you ask to point a domain to a specific IP, the AI creates a new entry in your rewrite list.

    add_rewrite
  2. Expand protection

    If you want to add a new list of blocked sites, the AI submits the new URL to your filter settings.

    add_filter_url
  3. Adjust security

    The AI modifies your global protection parameters to tighten or loosen network restrictions.

    set_protection
  4. Apply custom rules

    You can push specific syntax-based rules to the engine to handle granular blocking needs.

    set_user_rules

Try it

Copy these to start.

Use these prompts to trigger immediate changes in AdGuard Home.

Starting points

Swap out the domain names or URLs for the ones you actually want to use.

AdGuard Home Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_cQLvzna94LtpfAiutyRuJJkuKEzDFepXCNPRWP5R/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — AdGuard Home capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "adguard-home-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_cQLvzna94LtpfAiutyRuJJkuKEzDFepXCNPRWP5R/mcp"
    }
  }
}
Copy into chat04
  • Add a DNS rewrite so that internal.dev points to 192.168.1.50.

  • Add this filter URL to my blocklist: https://example.com/filter.txt

  • Turn on global protection settings for my network.

  • Add a new user rule to block all requests to telemetry.example.com.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect AdGuard Home once, then ask.

One connection links your AI client to your network settings. Your credentials stay encrypted and secure on our end.

Connect AdGuard Home to your AI

FAQ

How the task behaves

  • 01

    Can the AI delete my existing filter lists?

    No. The AI can only add new filter URLs using the available tools.

  • 02

    Will the AI change my admin password?

    No. There are no tools provided to modify user credentials or administrative access.

  • 03

    Can I use the AI to check if a site is currently blocked?

    No. The current tools only allow for adding rewrites, filters, and rules, not querying the current status of a domain.

  • 04

    Does the AI handle bulk deletions of rules?

    No. The AI is limited to adding rewrites and rules; it cannot perform mass deletions of your existing configuration.

  • 05

    How do I know if a rewrite worked?

    The AI will confirm once the tool has successfully executed the command, but you should verify the change on your local device.

  • More questions about AdGuard Home? The Connector page answers them. See everything the AdGuard Home Connector can do

Connect AdGuard Home to Claude, Cursor, ChatGPT & more