AdGuard Home MCP for AI. Control your network filter via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
AdGuard Home MCP lets your AI agent manage all network filtering, DNS settings, and security policies for your ad blocker instance.
Use natural conversation to check server health, add specific client IPs, update filter lists, or toggle global protection—all without touching a web dashboard or command line.
What your AI can do
Add client
Adds a new device or IP address to the list of managed clients on your network.
Add filter url
Applies an additional blocklist URL filter to improve filtering capability.
Add rewrite
Creates a specific DNS rewrite rule, forcing traffic for certain domains to a different location.
Get real-time reports on the AdGuard Home instance's operational state, including version number and active ports.
Globally enable or disable filtering, safe browsing modes, or parental controls, even setting a specific time limit for the change.
Modify upstream DNS servers, add new blocklist URLs, or set up custom rewriting rules for domains.
List all connected clients, search for specific IPs, add new client records, and even assign permanent IP addresses (static leases).
Check if a specific domain is being filtered or blocked for any given client, and review historical query logs.
Ask an AI about this
Waiting for input…
AdGuard Home: 23 Tools for Deep Network Control
These tools let your agent perform every granular function of the AdGuard Home instance, from adding clients to updating complex filter rules.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using AdGuard Home on VinkiusAdd Client
Adds a new device or IP address to the list of managed clients on your network.
Add Filter Url
Applies an additional blocklist URL filter to improve filtering capability.
Add Rewrite
Creates a specific DNS rewrite rule, forcing traffic for certain domains to a...
Add Static Lease
Assigns and reserves a permanent IP address for a client device using DHCP settings.
Check Host
Validates whether a specific domain name is currently being filtered or blocked by...
Configure Tls
Sets up and verifies secure transport layer settings for the AdGuard Home instance.
Get Dhcp Status
Retrieves current information about the DHCP server status, including lease details.
Get Dns Info
Shows the active DNS configuration details, including resolvers and cache parameters.
Get Filtering Status
Retrieves a report on current filtering rules and available blocklist/allowlist...
Get Query Log Config
Checks and updates the retention policy and logging levels for the query log.
Get Query Log
Fetches a list of historical DNS query entries, showing what was looked up over time.
Get Stats
Generates real-time usage statistics, such as the number of DNS queries processed in a given time frame.
Get Status
Provides a quick check on the overall operational status and health of the AdGuard Home server.
Get Tls Status
Reports the current state, expiration date, and cipher support for TLS settings.
List Blocked Services
Lists all predefined services or domains that are currently configured to be blocked...
List Clients
Retrieves a comprehensive list of every device (client) connected to the network and...
List Rewrites
Displays all active DNS rewrite rules that redirect domain traffic.
Search Clients
Filters the list of clients to find a specific device using its name or IP address.
Set Dns Config
Updates the primary DNS resolver settings for the entire network.
Set Protection
Toggles the overall protection status of the ad blocker, either enabling or...
Set User Rules
Applies specific filtering rules that only affect certain named users or client...
Update Blocked Services
Modifies the schedule or list of services that are blocked at a system level.
Update Query Log Config
Changes how often and how long query logs are kept, controlling data retention.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The AdGuard Home integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with AdGuard Home, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by AdGuard Home. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 23 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Dealing with network security settings usually means wrestling with dashboards.
Right now, if you want to check a client's IP or update upstream DNS servers, you have to log into the web dashboard. That involves clicking through menus, finding the right tab, and then either copying values or hitting save. It's slow, it’s click-heavy, and frankly, it takes too much time.
With this MCP, you just talk to your agent. You tell it: 'Update our DNS servers.' And that's it. The agent handles the entire process—checking if the change is valid, applying the settings using `set_dns_config`, and confirming everything worked. It keeps all the power in plain language.
AdGuard Home MCP: Direct Command Over Your Network
You no longer need to manually list clients, search through logs, or configure TLS settings piece by piece. The agent gathers all that data for you; it runs `list_clients`, then filters the results with `search_clients` if needed, and reports back on any associated IP details.
The difference is simple: instead of being limited by a dashboard's menu structure, your AI client gives you direct access to every function. It’s about immediate control; it’s about making complex network administration feel as easy as asking a question.
What your AI can actually do with this
Managing network privacy usually means wading through complex GUIs or wrestling with APIs. This MCP changes that. You simply tell your agent what you need done for your AdGuard Home setup, and it executes the commands. Need to know if a specific website is getting blocked? Just ask. Want to change the upstream DNS servers because your current ones are slow? Tell the agent.
Even configuring security settings for individual devices or adding permanent client IPs becomes a simple conversation. This integration makes deep network control available through natural language, positioning it as a core utility in the Vinkius catalog for any advanced AI workflow.
019e3860-abfc-7094-bef4-e23f84b926a8 
Here's how it actually works
The bottom line is that your AI client translates complex network commands into simple chat interactions.
Subscribe to this MCP and provide your AdGuard Home Base URL along with the necessary credentials.
Connect your preferred AI agent (like Claude or Cursor) to the Vinkius catalog and select this integration.
Use natural language prompts. Instead of navigating menus, you simply ask the agent to perform an action—'Block ads for site X now,' or 'Show me all active clients.'
Who is this actually for?
Anyone who deals with networked systems and needs deep, granular control without spending time in a web GUI. This is for the person who knows exactly which DNS record or filter list needs tweaking at 2 AM.
Needs to quickly update upstream DNS resolvers or check why a specific host is being blocked across multiple clients.
Wants to monitor and tweak their network-wide ad blocker status without having to open the main web dashboard.
Must audit client configurations, enforce specific user rules, or review historical query logs for compliance purposes.
What Changes When You Connect
Instead of navigating complex web dashboards to check if a host is blocked, you just ask the agent. The check_host tool tells you immediately if that domain is filtered or not.
Need to temporarily disable filtering for maintenance? You can't mess with global settings and forget to turn it back on. Use the set_protection tool to toggle status globally and even set an automatic time limit.
Managing IP assignments used to mean manually opening the client list and adding entries. Now, you use add_client or add_static_lease via simple conversation to lock down device IPs instantly.
The agent makes it easy to manage DNS configuration. You can run get_dns_info to validate current resolvers, then use set_dns_config if they're wrong—all without touching a settings page.
Debugging network issues? Don't just guess. Use the agent to retrieve historical data with get_query_log, seeing exactly what queries were made and when.
See it in action
Troubleshooting a blocked website for one user
A client reports that site X won't load. Instead of checking the web UI, you ask your agent to run check_host on 'sitex.com'. The agent replies instantly if it's filtered or not, letting you know whether to fix a filter rule or tell the user the block is intentional.
Onboarding a new permanent device
A smart TV needs a reliable IP address. You run add_static_lease via your agent, assigning it an IP and making sure its records are permanent. Then you use list_clients to confirm the entry shows up correctly.
Auditing filter changes for compliance
The boss asks why specific domains were blocked last week. You ask your agent to pull the get_query_log, filtering by date range, and then use list_rewrites to show what rules were in place at that time.
Making a quick system-wide change
The primary DNS resolver fails. Instead of logging into the GUI, you tell your agent to run set_dns_config immediately using the backup IPs and confirm the update with get_dhcp_status.
The honest tradeoffs
Manually checking logs
Logging into AdGuard Home, clicking 'Query Log', scrolling through pages of data to find one specific domain name.
Ask the agent to run get_query_log. You can filter by criteria in your prompt and get the answer without any manual page flipping.
Setting rules piece-meal
Having to open separate tabs for 'Client Settings', 'Filter Lists', and then manually applying a rule that crosses those boundaries.
Use set_user_rules or add_filter_url. The agent handles the context switching, letting you set complex rules in one prompt.
Forgetting to verify status changes
Toggling global protection off and assuming it will stay off until you get around to re-enabling it later.
Always use get_status or the agent's ability to confirm. If you need temporary downtime, ask the agent to run set_protection with a specific duration.
When It Fits, When It Doesn't
Use this MCP if your workflow requires deep, granular control over DNS and network security policies—for example, checking historical logs using get_query_log, or enforcing unique rules via set_user_rules. Don't use it if you just need to toggle ad-blocking on or off; in that case, a simple switch or status check is enough. This tool shines when your intent requires multiple, distinct actions—like first running list_clients and then using add_static_lease for one of the found devices.
Questions you might have
How do I check if an IP is already assigned when using add_static_lease? +
The agent will confirm the current status of that address. You can first run get_dhcp_status to see all existing leases, and then use the agent to add a static lease if the IP is free.
Can I view historical queries using get_query_log? +
Yes. You can ask your agent to pull the query log for a specific date range or client, letting you see exactly what was looked up at that time.
What if I need to change the primary DNS resolver? Do I use set_dns_config? +
Yes. You tell your agent to run set_dns_config and provide the new IP addresses. The agent handles applying those changes across the entire network.
How do I see if a specific domain is blocked for me? Use check_host. +
Just ask your agent to run check_host on the domain name you care about. It will tell you immediately whether it's filtered by an active rule or not.
Is there a tool to update my filter lists? Should I use add_filter_url? +
Yes, add_filter_url lets you append new blocklist URLs. You just give the agent the list and tell it where to apply them.
I need to see performance metrics like total queries or blocked counts. What tool should I use? Use get_stats. +
The get_stats tool provides a detailed summary of your network traffic and query volume. You'll get hard numbers on everything, including the count of successful DNS lookups and how many requests were filtered out.
I want to force a specific website name to always point to another IP address. Is `add_rewrite` for that? Use add_rewrite. +
Yes, add_rewrite lets you create a DNS rewrite rule. This means you're manually telling the network to treat one domain as if it were another, overriding standard resolution.
How do I onboard a brand new device onto the network? Should I use add_client? +
add_client lets your agent register a new client's unique identifiers. This ensures that device gets proper tracking and allows you to apply specific security settings just for it.
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.
We've already built the connector for AdGuard Home. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 23 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.