What is AdGuard Home MCP?
AdGuard Home MCP is a Model Context Protocol (MCP) server for AdGuard Home. It allows AI agents to manage DNS rewrite records, filtering rules, and filter lists via a simple interface. It is designed for users of AdGuard Home who want to interact with their ad‑blocking DNS server through AI assistants.
How to use AdGuard Home MCP?
Install the package globally with npm i -g @fcannizzaro/mcp-adguard-home. Then run adguard-cli login to save your AdGuard Home credentials (URL, username, password) to a config file, or set the environment variables ADGUARD_URL, ADGUARD_USERNAME, and ADGUARD_PASSWORD. Finally, configure the MCP server in your preferred client (Claude Desktop, Cursor, VS Code, Windsurf, or Claude Code CLI) using the npx command shown in the README.
Key features of AdGuard Home MCP
- List, add, and remove DNS rewrite records
- List, block, and allow DNS filtering rules
- Manage custom DNS filtering rules in bulk
- List, enable/disable, and refresh filter lists
- Provides a CLI alternative for non‑MCP scripts
Use cases of AdGuard Home MCP
- Automatically block or allow domains via an AI agent
- Add and remove DNS rewrite records on the fly
- Toggle filter lists during network troubleshooting
- Integrate AdGuard Home management into automated workflows
Comments