An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect AdGuard Home to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Manage your entire network's security from your AI agent.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPT

Claude

Cursor

Perplexity

Gemini

Microsoft Copilot

Raycast

Meta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 23 capabilities

We ship only the actions that matter.

Capability set01 / 06

01-04

4 capabilities in this set.

Part of 23 available through AdGuard Home.

01
Get dhcp status
Get DHCP server status
02
Get dns info
Get DNS configuration info
03
Get filtering status
Get filtering status and lists
04
Get query log config
Get query log configuration

Capability set02 / 06

05-08

4 capabilities in this set.

Part of 23 available through AdGuard Home.

05
Get stats
Get DNS query statistics
06
Get status
Get AdGuard Home server status
07
Configure tls
Configure TLS settings
08
Get query log
Get DNS query log

Capability set03 / 06

09-12

4 capabilities in this set.

Part of 23 available through AdGuard Home.

09
List clients
List all clients
10
Search clients
Search for clients
11
Set dns config
Update DNS settings
12
Add rewrite
Add a DNS rewrite

Capability set04 / 06

13-16

4 capabilities in this set.

Part of 23 available through AdGuard Home.

13
Add static lease
Add a DHCP static lease
14
Check host
Check if a host is filtered
15
Get tls status
Get TLS configuration status
16
List blocked services
List all available blocked services

Capability set05 / 06

17-20

4 capabilities in this set.

Part of 23 available through AdGuard Home.

17
List rewrites
List DNS rewrites
18
Update blocked services
Update blocked services schedule
19
Update query log config
Update query log configuration
20
Add client
Add a new client

Capability set06 / 06

21-23

3 capabilities in this set.

Part of 23 available through AdGuard Home.

21
Add filter URL
Add a new filter URL
22
Set protection
Globally. Enable or disable protection globally
23
Set user rules
Set custom user filtering rules

Real work

What teams actually run

01

Troubleshooting a Blocked Site

A client complains about a site. You use the MCP to check if the specific domain is being filtered or blocked for that client.

02

03

Automate a task

Put AdGuard Home to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

AdGuard Home works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Claude

ChatGPT

Gemini

Perplexity

Grok

Microsoft Copilot

Microsoft Copilot

Cursor

VS Code

Windsurf

JetBrains

Cline

LangChain

Vercel AI SDK

Lovable

Z.ai

Raycast

Qwen Code

Kimi Code

Le Chat

Building your own app? The connector is yours to use.

You don't need a client to put AdGuard Home to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1174ms average. Fast in production.

AdGuard Home is checked daily against the live service.

Daily averagePeak 1520ms

Oct 3Today

Fastest day: 914ms
Slowest day: 1520ms
14-day trend: Improving-13%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 23 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of AdGuard Home, so you can see the experience inside your AI.

It does not authenticate your account with AdGuard Home. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

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.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
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"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up AdGuard Home in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work AdGuard Home owners hand off.

This MCP is essential for anyone who needs deep, command-line level control over their network's privacy and filtering without using a web interface. It's perfect for home lab enthusiasts who want to tweak settings on the fly, and network administrators who need quick troubleshooting access.

01
Home Lab Enthusiast
Monitor and tweak your network-wide ad blocker status or update DNS settings without opening the web dashboard.
02
Network Administrator
Quickly update upstream DNS providers, check why a specific host is blocked, or manage client entries.
03
Privacy-focused User
Manage custom filtering rules and client-specific protections using simple text or voice commands.

FAQ

Questions AdGuard Home owners ask.

01
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.
02
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.
03
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.

Explore

More in Developer Tools

Connect AdGuard Home to Claude, Cursor, ChatGPT & more