AdGuard Home MCP Server
Operate home-lab or small-office DNS filtering by letting your agent change AdGuard Home rules, lists, and settings through MCP instead of clicking the UI.
Overview
AdGuard Home MCP Server is an MCP server for the Operate phase that lets agents manage a live AdGuard Home DNS filter via authenticated API calls.
What is this MCP server?
- Manage AdGuard Home from AI assistants over MCP
- Requires ADGUARD_URL, ADGUARD_USERNAME, and ADGUARD_PASSWORD env vars
- npm @samik081/mcp-adguard-home v0.8.0 or OCI ghcr.io/samik081/mcp-adguard-home:0.8.0
- stdio transport for editor and agent hosts
- Node runtime hint on npm distribution
- Published version 0.8.0
- 3 required environment variables: ADGUARD_URL, ADGUARD_USERNAME, ADGUARD_PASSWORD
- 2 distribution channels: npm and OCI
What problem does it solve?
Tweaking AdGuard Home means context-switching to a web UI while you are debugging DNS, malware blocks, or family-network policy in the same session as your agent.
Who is it for?
Solo builders who self-host AdGuard Home on a NAS, router, or VPS and want agent-driven DNS policy changes during operate and iterate work.
Skip if: Teams without AdGuard Home, cloud-only DNS setups, or anyone unwilling to grant an agent admin credentials to their filter.
What do I get? / Deliverables
Once configured with URL and admin credentials, your agent can query and change AdGuard Home settings through stdio MCP without manual UI hops.
- Agent-driven AdGuard Home configuration changes
- Faster DNS troubleshooting without leaving the IDE
- Documented infra actions in the same thread as your agent
Recommended MCP Servers
Journey fit
How it compares
Live AdGuard Home control plane via MCP, not a DNS tutorial skill or passive monitoring-only integration.
Common Questions / FAQ
Who is mcp-adguard-home for?
Indie operators and homelab owners who run AdGuard Home and use Claude Code, Cursor, or Codex for infra chores.
When should I use mcp-adguard-home?
Use it during Operate when you need to adjust filtering, troubleshoot blocked domains, or document DNS changes alongside code and runbooks.
How do I add mcp-adguard-home to my agent?
Set ADGUARD_URL, ADGUARD_USERNAME, and ADGUARD_PASSWORD, then add @samik081/mcp-adguard-home (stdio) or the ghcr.io OCI image in your MCP server config.