• LOG ANALYSIS
  • STATUS CHECK
  • ROOT CAUSE
  • HUMAN ACTION

How to troubleshoot blocked network sites with your AI

Connect AdGuard Home to your AI client to turn DNS logs into clear answers about why a site isn't loading.

Ask AI about this page

Short answer

Why is this website being blocked?

Your AI scans DNS query logs to see if a specific domain triggered a filter. It then checks the host status to confirm if the block is active. You'll get a clear explanation of the rule or host setting causing the issue.

Troubleshooting outcomes

Where every issue lands.

What you get after your AI analyzes the logs.

LOG ANALYSIS

Identify the blocked domain

The AI pulls recent query data to find the exact moment a request was intercepted. You'll see which domain was flagged.

STATUS CHECK

Verify host settings

The AI checks if the host is explicitly blocked or allowed in your configuration. This confirms the current state of the target.

ROOT CAUSE

Pinpoint the filter rule

By matching logs to host status, the AI tells you exactly which rule is responsible for the block. You'll know what to change.

HUMAN ACTION

Manual rule adjustment

The AI identifies the problem but cannot change your AdGuard Home settings. You'll need to manually update your filters or allowlists.

The workflow

What your AI does when a site is blocked.

The AI moves from raw data to a specific diagnosis.

  1. Scan DNS traffic

    The AI looks through your recent DNS activity to find the specific domain that failed to resolve.

    get_query_log

  2. Inspect host status

    Once the domain is found, the AI checks the current configuration for that specific host.

    check_host

  3. Review network health

    The AI looks at overall query trends to see if the block is an isolated incident or a wider pattern.

    get_stats

  4. Diagnose the block

    The AI combines the log entries and host status to explain why the connection was dropped.

    get_query_logcheck_host

Try it

Copy these to start.

Use these prompts to begin troubleshooting.

Starting points

Replace the domain names with the actual sites you are trying to access.

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

  • Check the query logs for blocked requests to google.com.

  • Why is youtube.com being filtered in my AdGuard Home logs?

  • Check the status of the host for spotify.com to see if it's blocked.

  • Look at my recent query logs and tell me if there are any frequent blocks.

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

Start here

Connect AdGuard Home once, then ask.

Just link your instance through the Vinkius dashboard. Your credentials stay encrypted and you can immediately start asking questions about your network traffic.

Connect AdGuard Home to your AI

FAQ

How this task behaves

  • 01

    Can the AI unblock a site for me?

    No. The AI can only read logs and check host status. You must manually change the settings in your AdGuard Home dashboard.

  • 02

    Can the AI delete my existing filter rules?

    No. The tools only allow the AI to read data. It cannot modify, delete, or add any rules to your configuration.

  • 03

    How recent is the query log data?

    The AI sees the logs currently available in your AdGuard Home instance through the get_query_log tool.

  • 04

    Does the AI see my actual web browsing content?

    No. The AI only sees DNS queries, which are the domain names being requested, not the specific content or data within the websites.

  • 05

    Can I use this to see how many queries my network handles?

    Yes. The AI can use the get_stats tool to provide an overview of your network traffic and query counts.

  • 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