How do I install the adguard home mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `ADGUARD_URL`, `ADGUARD_USERNAME`, `ADGUARD_PASSWORD` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

AdGuard Home MCP Server

Manage AdGuard Home through AI assistants

Local serverstdioTypeScript

What is the AdGuard Home MCP Server?

Manage AdGuard Home through AI assistants

What the server does

MCP server for AdGuard Home. Manage DNS filtering, clients, DHCP, rewrites, and more through natural language in Cursor, Claude Code, and Claude Desktop.

65 tools — across 16 categories covering the complete AdGuard Home API
Read-only mode — via ADGUARD_ACCESS_TIER=read-only for safe monitoring
Category filtering — via ADGUARD_CATEGORIES to expose only the tools you need
Zero HTTP dependencies — -- uses native fetch (Node.js 18+)
Docker images — for linux/amd64 and linux/arm64 on GHCR
Remote MCP — via HTTP transport (MCP_TRANSPORT=http) using the Streamable HTTP protocol

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
global_get_status	Retrieve server status including version, DNS addresses, protection state, and ports
global_get_profile	Retrieve user profile (name, language, theme)
global_check_version	Check for AdGuard Home updates and compare with current version
global_set_protection	Enable or disable DNS protection globally, with optional duration for temporary disable
global_update_profile	Update user profile settings (name, language, theme)
global_begin_update	Initiate an AdGuard Home software update
dns_get_info	Retrieve full DNS configuration including upstreams, cache settings, blocking mode, and DNSSEC
dns_test_upstream	Test upstream DNS server configuration to verify servers are reachable
dns_set_config	Update DNS server configuration (19 optional fields for partial update)
dns_clear_cache	Clear the DNS resolver cache
querylog_get	Search DNS query log with optional filtering by reason or response status, search term, and pagination
querylog_get_config	Retrieve query log configuration settings
querylog_set_config	Update query log configuration (enabled, interval, anonymization)
querylog_clear	Clear the entire DNS query log

How to install the AdGuard Home MCP Server

claude mcp add adguard-home --env ADGUARD_URL=your-value --env ADGUARD_USERNAME=your-value --env ADGUARD_PASSWORD=your-value -- npx -y @samik081/mcp-adguard-home

Configuration

Variable	Description	Required
ADGUARD_URL	Endpoint or connection string the server talks to.	Yes
ADGUARD_USERNAME	Configuration value read at startup.	Optional
ADGUARD_PASSWORD	Configuration value read at startup.	Optional

Example prompts to try

“Use AdGuard Home to global get status.”
“Use AdGuard Home to global get profile.”
“Use AdGuard Home to global check version.”

Frequently asked questions

Manage AdGuard Home through AI assistants Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the AdGuard Home MCP Server

n8n

Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.

Developer ToolsRemoteTypeScript★ 22.5k

AWS

Official

AWS Labs' official server suite — current AWS docs, CDK guidance, cost analysis and service tools.

Cloud & DevOpsPython★ 7.0k

Stemsplit MCP

MCP server for AI stem separation — remove vocals, isolate instrumentals, build karaoke tracks, or split audio into vocals, drums, bass, piano

Media & EntertainmentRemoteTypeScript

Google Photos MCP

MCP server for Google Photos integration with Claude

Cloud & DevOpsTypeScript

Go

Structured Go tool output (build, test, vet) as typed JSON diagnostics.

Cloud & DevOpsPython

Anneal Memory

anneal-memory adds structural defenses at the citation layer that the systems surveyed below don't ship. Patterns earn promotion through cited

Knowledge & MemoryPython