🛡️ AdGuard Home MCP

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

FAQ from AdGuard Home MCP

How do I set up credentials for AdGuard Home MCP?

Run adguard-cli login and follow the prompts for your AdGuard Home URL, username, and password. Credentials are saved to ~/.config/mcp-adguard-home/config.json. Alternatively, set the environment variables ADGUARD_URL, ADGUARD_USERNAME, and ADGUARD_PASSWORD.

Which MCP clients are supported?

The README provides configuration examples for Claude Desktop, Cursor, VS Code, Windsurf, and the Claude Code CLI.

Does AdGuard Home MCP require a running AdGuard Home instance?

Yes, you must provide the URL of a running AdGuard Home instance (e.g. http://192.168.1.1) along with valid credentials.

Can I use this without an MCP client?

Yes, the package also installs a regular CLI (adguard-cli) that can be used for scripts or agents that do not use MCP. For example, adguard-cli list_rewrite_dns_records.

What is the license for AdGuard Home MCP?

The project is licensed under the MIT License.