AdGuard Home MCP Server for WindsurfGive Windsurf instant access to 23 tools to Add Client, Add Filter Url, Add Rewrite, and more
GDPR Free for SubscribersWindsurf brings agentic AI coding to a purpose-built IDE. Connect AdGuard Home through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
Ask AI about this MCP Server for Windsurf
The AdGuard Home MCP Server for Windsurf is a standout in the Developer Tools category — giving your AI agent 23 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Gemini{
"mcpServers": {
"adguard-home": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install AdGuard Home and 4,000+ MCP Servers from a single visual interface.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About AdGuard Home MCP Server
Connect your AdGuard Home instance to any AI agent and take full control of your network-wide privacy and security through natural conversation.
Windsurf's Cascade agent chains multiple AdGuard Home tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 23 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
What you can do
- Server Status — Monitor server health, active ports, protection states, and version information in real-time.
- Protection Control — Toggle global filtering, safe browsing, and parental controls on or off, with optional timed durations.
- DNS Configuration — View and update upstream DNS servers, bootstrap settings, and cache parameters (TTL, size, and optimistic caching).
- Filter Management — Add new blocklist or allowlist URLs and manage custom user-defined filtering rules.
- Client Insights — List and search for persistent or runtime clients, and configure specific security settings for individual devices.
- Host Auditing — Instantly check if a specific domain is being filtered or blocked for a particular client.
The AdGuard Home MCP Server exposes 23 tools through the Vinkius. Connect it to Windsurf in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 23 AdGuard Home tools available for Windsurf
When Windsurf connects to AdGuard Home through Vinkius, your AI agent gets direct access to every tool listed below — spanning dns-filtering, ad-blocking, network-security, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Add client on AdGuard Home
Add a new client
Add filter url on AdGuard Home
Add a new filter URL
Add rewrite on AdGuard Home
Add a DNS rewrite
Add static lease on AdGuard Home
Add a DHCP static lease
Check host on AdGuard Home
Check if a host is filtered
Configure tls on AdGuard Home
Configure TLS settings
Get dhcp status on AdGuard Home
Get DHCP server status
Get dns info on AdGuard Home
Get DNS configuration info
Get filtering status on AdGuard Home
Get filtering status and lists
Get query log on AdGuard Home
Get DNS query log
Get query log config on AdGuard Home
Get query log configuration
Get stats on AdGuard Home
Get DNS query statistics
Get status on AdGuard Home
Get AdGuard Home server status
Get tls status on AdGuard Home
Get TLS configuration status
List blocked services on AdGuard Home
List all available blocked services
List clients on AdGuard Home
List all clients
List rewrites on AdGuard Home
List DNS rewrites
Search clients on AdGuard Home
Search for clients
Set dns config on AdGuard Home
Update DNS settings
Set protection on AdGuard Home
globally. Enable or disable protection globally
Set user rules on AdGuard Home
Set custom user filtering rules
Update blocked services on AdGuard Home
Update blocked services schedule
Update query log config on AdGuard Home
Update query log configuration
Connect AdGuard Home to Windsurf via MCP
Follow these steps to wire AdGuard Home into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Open MCP Settings
Cmd+Shift+P and search "MCP"Add the server
mcp_config.jsonSave and reload
Start using AdGuard Home
Why Use Windsurf with the AdGuard Home MCP Server
Windsurf provides unique advantages when paired with AdGuard Home through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 23 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
AdGuard Home + Windsurf Use Cases
Practical scenarios where Windsurf combined with the AdGuard Home MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from AdGuard Home and generate models, types, or handlers based on real API responses
Live debugging: query AdGuard Home tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from AdGuard Home and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine AdGuard Home data with Cascade's code generation to scaffold entire features in minutes
Example Prompts for AdGuard Home in Windsurf
Ready-to-use prompts you can give your Windsurf agent to start working with AdGuard Home immediately.
"What is the current status of my AdGuard Home server?"
"Disable protection for the next 10 minutes."
"Check if 'doubleclick.net' is currently being filtered for client 192.168.1.50."
Troubleshooting AdGuard Home MCP Server with Windsurf
Common issues when connecting AdGuard Home to Windsurf through Vinkius, and how to resolve them.
Server not connecting
AdGuard Home + Windsurf FAQ
Common questions about integrating AdGuard Home MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Explore More MCP Servers
View all →
XML JSON Converter
2 toolsParse legacy systems easily. Deterministically convert massive XML, SOAP, or RSS feeds into clean JSON (and back) without LLM hallucinations.
TestMu AI (formerly LambdaTest)
10 toolsManage cross-browser testing via TestMu AI — audit automation builds, inspect test sessions, and retrieve visual logs.
Toket
8 toolsAccept crypto payments on your website with a checkout widget that supports Bitcoin, Ethereum, and major stablecoins.
Zoho Campaign
13 toolsAI email marketing: manage campaigns, contacts, and mailing lists via agents.