AdGuard Home MCP Server

Manage AdGuard Home through AI assistants. Its 40 documented tools cover filtering, global, status, config. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-13 · ★ 4 · #238 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install AdGuard Home MCP Server

before you install - you'll need

Set ADGUARD_URL, ADGUARD_USERNAME, ADGUARD_PASSWORD before connecting. MCP_TRANSPORT is optional or environment-specific per the README.

Claude Code

claude mcp add samik081-mcp-adguard-home -- npx -y @samik081/mcp-adguard-home

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "samik081-mcp-adguard-home": {
      "command": "npx",
      "args": [
        "-y",
        "@samik081/mcp-adguard-home"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

license MIT - declared in the repository

npm package @samik081/mcp-adguard-home - published under the repo owner's npm scope (@samik081)

registry namespace io.github.Samik081 is GitHub-verified and matches the repo owner

03 · What AdGuard Home MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can retrieve server status including version, DNS addresses, protection state, and ports, retrieve user profile (name, language, theme), check for AdGuard Home updates and compare with current version, and update user profile settings (name, language, theme).

Capability map

Tools grouped from the project's README - what AdGuard Home MCP Server lets an agent do.

Filtering

8 tools - e.g. Retrieve filtering configuration including blocklists, allowlists, and user rules; Test whether a hostname would be blocked by current filtering rules; Update global filtering configuration (enabled state…

filtering_get_status · filtering_check_host · filtering_set_config · filtering_add_url · filtering_remove_url · filtering_set_url…

Global

6 tools - e.g. Retrieve server status including version, DNS addresses, protection state, and ports; Retrieve user profile (name, language, theme); Check for AdGuard Home updates and compare with current version

global_get_status · global_get_profile · global_check_version · global_set_protection · global_update_profile · global_begin_update

Clients

5 tools - e.g. Retrieve all configured and auto-detected clients with their settings; Search for specific clients by their IDs (IP, MAC, CIDR, or client ID); Add a new persistent client with per-client settings

clients_get · clients_search · clients_add · clients_update · clients_delete

Dns

4 tools - e.g. Retrieve full DNS configuration including upstreams, cache settings, blocking mode, and DNSSEC; Test upstream DNS server configuration to verify servers are reachable; Update DNS server configuration (20…

dns_get_info · dns_test_upstream · dns_set_config · dns_clear_cache

Querylog

4 tools - e.g. Search DNS query log with optional filtering by reason or response status, search term, and pagination; Retrieve query log configuration settings; Update query log configuration (enabled, interval…

querylog_get · querylog_get_config · querylog_set_config · querylog_clear

Stats

4 tools - e.g. Retrieve DNS statistics including top domains, blocked counts, and client activity; Retrieve statistics configuration settings; Reset all DNS statistics

stats_get · stats_get_config · stats_reset · stats_set_config

Dhcp

3 tools - e.g. Retrieve DHCP server configuration, static leases, and active leases; Retrieve available network interfaces for DHCP server binding; Scan for competing DHCP servers on a network interface

dhcp_get_status · dhcp_get_interfaces · dhcp_find_active

Safebrowsing

2 tools - e.g. Retrieve safe browsing (malware/phishing protection) status; Enable or disable safe browsing protection

safebrowsing_get_status · safebrowsing_set

Latest releases

v0.9.0 · 2026-08-13

add docker job timeout and make npm publish idempotent · bump MCP SDK to 1.30.0 and TypeScript to 7.0, require Node >=22.12 · clients_search response parsing, blocked-services listing, full dns_info coverage…

v0.8.0 · 2026-05-27

add query log reason filter, bump AdGuard Home compatibility to v0.107.76

v0.7.1 · 2026-05-23

bump @modelcontextprotocol/sdk 1.27→1.29, zod, biome, typescript, vitest

04 · Who maintains AdGuard Home MCP Server

AdGuard Home MCP Server is maintained by samik081. We track 4 MCP servers from samik081 - 4 actively maintained, 35 combined GitHub stars, oldest repo from Feb 2026. Full record: all servers from samik081.

  1. Proxmox VE MCP Server Manage Proxmox VE through AI assistants ★ 19
  2. Authentik MCP Server Manage Authentik through AI assistants ★ 6

05 · Facts

repository
github.com/samik081/mcp-adguard-home
category
other - ranked #238 of 848 actively-maintained other servers as of 2026-08-25.
release cadence
2 releases in the last 90 days (latest 2026-08-13)
registry
io.github.Samik081/mcp-adguard-home (active, first published 2026-03-09 · 7 versions)
packages
npm:@samik081/mcp-adguard-home · oci:ghcr.io/samik081/mcp-adguard-home:0.9.0

06 · AdGuard Home MCP Server FAQ

Is AdGuard Home MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-13 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can AdGuard Home MCP Server do?

With this server connected, an agent can retrieve server status including version, DNS addresses, protection state, and ports, retrieve user profile (name, language, theme), check for AdGuard Home updates and compare with current version, and update user profile settings (name, language, theme).

How do I install AdGuard Home MCP Server?

Run `npx -y @samik081/mcp-adguard-home`. The README documents 4 environment variables (ADGUARD_URL, ADGUARD_USERNAME, ADGUARD_PASSWORD…) to set first. Set ADGUARD_URL, ADGUARD_USERNAME, ADGUARD_PASSWORD before connecting. MCP_TRANSPORT is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does AdGuard Home MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to AdGuard Home MCP Server

Alternatives to AdGuard Home MCP Server

Maintained other servers if AdGuard Home MCP Server isn't the fit.

  1. Heyputer MCP Server Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more ★ 43,204 · 2026-08-24
  2. Server Commands An MCP server to run arbitrary commands ★ 38,704 · 2026-08-05
  3. Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 4,780 · 2026-08-25
  4. Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,460 · 2026-08-25
  5. Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,598 · 2026-08-21
  6. Ship Swift 40+ production-ready SwiftUI recipes for building full-stack iOS apps via MCP. ★ 2,968 · 2026-08-09

More MCP servers to compare · Authentik MCP Server · Proxmox VE MCP Server · reMarkable MCP Server · Nfse Nacional · Agentic SSH

More TypeScript MCP servers · Transcriptor MCP · Banco Inter · see all