AdGuard Home Connector for AI agents.

23 live capabilities

Manage DNS filtering and network security through natural conversation.

Live agent request AdGuard Home / Connector

Waiting for input…

AI Agent

Why people use AdGuard Home

AdGuard Home DNS Filtering and Network Security Management

With this Connector, you just tell your agent what to do. You can ask it to see why a site is blocked or to add a new filter list in one sentence. It handles the navigation and the commands for you. You get a responsive network environment that you can control as fast as you can think.

What Vinkius changes

You get a hands-free way to manage network security through plain English.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Troubleshooting a blocked app

A user notices a smart TV can't reach a streaming service.
Real-world use case 02

Temporary filter bypass

A parent needs to let a child access a specific site for 30 minutes.
Real-world use case 03

Rapid blocklist updates

An admin wants to add a new community-driven blocklist.

Complete set · 23capabilities

The complete AdGuard Home capability set.

These are the exact actions your AI can choose when you ask it to work with AdGuard Home.

Capability set01 / 06

01—04

4 capabilities in this set.

Part of 23 available through AdGuard Home.

01 Capability
Get dhcp status
View the current status of your DHCP server. Use this to see how many IPs are currently handed out.
02 Capability
Get dns info
Pull the current DNS configuration from your instance. It gives you a quick snapshot of your upstream providers.
03 Capability
Get filtering status
Check which filter lists are active and their current status. This helps you see exactly what's being blocked.
04 Capability
Get query log config
View how your DNS query logs are currently set up. Use this to understand what data your server is recording.

Capability set02 / 06

05—08

4 capabilities in this set.

Part of 23 available through AdGuard Home.

05 Capability
Get query log
Pull the latest entries from your DNS query log. This shows you what your devices are trying to access.
06 Capability
Get stats
Retrieve the latest DNS query statistics. It's a great way to see the volume of traffic your server handles.
07 Capability
Get status
Get a high-level overview of your AdGuard Home server health. This tells you if the service is actually running.
08 Capability
Search clients
Find a specific device in your client list quickly. Use this when you need to find a specific IP or hostname.

Capability set03 / 06

09—12

4 capabilities in this set.

Part of 23 available through AdGuard Home.

09 Capability
Add rewrite
Create a DNS rewrite to point a domain to a specific IP. Use this to redirect traffic or set up local services.
10 Capability
Add static lease
Assign a permanent IP to a specific device via DHCP. This ensures your devices always have a consistent address.
11 Capability
Check host
See if a specific domain is currently being blocked. It's perfect for troubleshooting why a site won't load.
12 Capability
Get tls status
Check the current state of your TLS configuration. Use this to verify your security certificates are valid.

Capability set04 / 06

13—16

4 capabilities in this set.

Part of 23 available through AdGuard Home.

13 Capability
List blocked services
See a list of all services that are currently blocked. This helps you manage what content is restricted.
14 Capability
List clients
Get a full list of all clients currently connected to your DNS. Use this to audit who is on your network.
15 Capability
List rewrites
View all the DNS rewrites you've created. This is handy for keeping track of your custom redirects.
16 Capability
Update blocked services
Change the schedule for your blocked services. This is useful for turning off certain blocks during specific hours.

Capability set05 / 06

17—20

4 capabilities in this set.

Part of 23 available through AdGuard Home.

17 Capability
Update query log config
Modify how your server records DNS queries. Use this to adjust your logging depth or retention.
18 Capability
Add client
Add a new device to your network list. This helps keep track of every hardware unit connected to your DNS.
19 Capability
Add filter url
Inject a new blocklist URL into your filter settings. It's the fastest way to stay ahead of new trackers.
20 Capability
Configure tls
Set up your TLS settings for secure connections. This ensures your DNS traffic stays private.

Capability set06 / 06

21—23

3 capabilities in this set.

Part of 23 available through AdGuard Home.

21 Capability
Set dns config
Update your upstream DNS settings and cache parameters. This is how you switch providers or change TTLs.
22 Capability
Set protection
Turn global protection on or off instantly. You can even set a timer for how long the protection stays active.
23 Capability
Set user rules
Apply custom filtering rules to your network. This lets you block specific sites or allow specific ones manually.

Set up in minutes

One URL. Then ask AdGuard Home to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use AdGuard Home from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_cQLvzna94LtpfAiutyRuJJkuKEzDFepXCNPRWP5R/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it AdGuard Home, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable AdGuard Home for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_cQLvzna94LtpfAiutyRuJJkuKEzDFepXCNPRWP5R/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the AdGuard Home URL.
Step 03

Save and start

Save the connection and enable AdGuard Home in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "adguard-home": {
      "url": "https://edge.vinkius.com/vk_preview_cQLvzna94LtpfAiutyRuJJkuKEzDFepXCNPRWP5R/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using AdGuard Home

Open Agent mode in chat and ask: "Using AdGuard Home, help me...". 23 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "adguard-home": {
      "url": "https://edge.vinkius.com/vk_preview_cQLvzna94LtpfAiutyRuJJkuKEzDFepXCNPRWP5R/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using AdGuard Home

Ask Copilot: "Using AdGuard Home, help me...". 23 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "adguard-home": {
      "url": "https://edge.vinkius.com/vk_preview_cQLvzna94LtpfAiutyRuJJkuKEzDFepXCNPRWP5R/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using AdGuard Home

Open Cascade and ask: "Using AdGuard Home, help me...". 23 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "adguard-home": {
      "url": "https://edge.vinkius.com/vk_preview_cQLvzna94LtpfAiutyRuJJkuKEzDFepXCNPRWP5R/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using AdGuard Home

Ask Cline: "Using AdGuard Home, help me...". 23 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add adguard-home --transport http "https://edge.vinkius.com/vk_preview_cQLvzna94LtpfAiutyRuJJkuKEzDFepXCNPRWP5R/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using AdGuard Home

Ask Claude: "Using AdGuard Home, show me...". 23 tools are ready

Where the request belongs

Work AdGuard Home can move forward.

Built around the request

Home lab owners and network admins who want to manage DNS and ad-blocking without constant dashboard jumping.

01

Home Lab Enthusiast

Manages a complex home network and wants to tweak blocklists on the fly without opening a browser.

02

Network Administrator

Updates DNS providers and checks client status across an office network using quick commands.

03

Privacy Advocate

Constantly updates custom filtering rules to keep the family's browsing safe and private.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 9 capabilities

Decodo (Smartproxy)

Manage your Decodo (formerly Smartproxy) network infrastructure. list proxy endpoints, monitor bandwidth, and fetch residential proxy configurations with your AI.

02 1 capability

Anura

Ad fraud detection MCP server. Validate visitors in real-time and manage fraud reports via Anura.io.

03 15 capabilities

Cloudflare

Manage DNS, Workers, KV, Pages and firewall via Cloudflare. audit records, deploy config and inspect CDN analytics from any AI agent.

04 10 capabilities

IPRoyal (Proxy Services)

Manage proxies via IPRoyal. monitor traffic, rotate credentials, and manage whitelisted IPs.

05 11 capabilities

HetrixTools

Automate uptime monitoring and blacklist checks via HetrixTools. monitor servers, websites, and IP reputation directly from any AI agent.

06 3 capabilities

Outbound Network Firewall Validator

Validates outbound network requests against allowed domains and ports to prevent data exfiltration.

Bring your own AI

Change the model, client or framework. Keep AdGuard Home connected.

Before you connect

Questions about AdGuard Home.

The practical details behind the request, access and result.

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 capability. 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 capability 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.

One connection away

Give your agent a direct line to AdGuard Home.

Connect AdGuard Home once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available