Skip to main content
Glama
AdGuard DNS API MCP Server

AdGuard DNS API MCP Server

by Ankur1911

AdGuard DNS API MCP server

Generated by openapi2mcp 0.1.0 from the AdGuard DNS API OpenAPI spec (9 tools).

Run

cp .env.example .env     # then edit if the API needs credentials
uv run server.py         # speaks MCP over stdio

Set API_KEY in .env; it is sent in the Authorization header.

Related MCP server: DNSFilter MCP Server

Connect a client

Add this to any MCP-compatible client (for example Cursor or VS Code), using the absolute path to this folder:

{
  "mcpServers": {
    "adguard-dns": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/this/folder", "server.py"]
    }
  }
}

The exact config file and key names differ by client; check your client's MCP documentation.

Tools

Tool

Request

Summary

getAccountLimits

GET /oapi/v1/account/limits

Gets account limits

getDevice

GET /oapi/v1/devices/{device_id}

Gets a device by ID

getDeviceSettings

GET /oapi/v1/devices/{device_id}/settings

Gets device settings

getQueryLog

GET /oapi/v1/query_log

Gets query log

getDevicesQueriesStats

GET /oapi/v1/stats/devices

Gets devices statistics

getDomainsQueriesStats

GET /oapi/v1/stats/domains

Gets domains statistics

getTimeQueriesStats

GET /oapi/v1/stats/time

Gets time statistics

getDevices

GET /oapi/v2/devices

Lists devices

getDnsServers

GET /oapi/v2/dns_servers

Lists DNS servers

Configuration

See .env.example. Key settings: API_BASE_URL, API_TIMEOUT, MAX_RESPONSE_CHARS, LOG_LEVEL, MCP_TRANSPORT.

Logs go to stderr (stdout is reserved for the protocol).

Status

Unofficial, read-only prototype generated from the public AdGuard DNS OpenAPI spec (version 1.17.4, as published in their developer docs), 9 of 48 operations. Only startup, tool listing and the unauthenticated error path have been verified; it has not been run against a live account. No automatic pagination, retries or rate limiting. Write operations are intentionally left out. Related issue: https://github.com/AdguardTeam/AdGuardDNS/issues/1088

Licence: MIT.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Read-only MCP server for Akamai CDN that enables searching properties, browsing EdgeWorker code, querying DNS zones, inspecting network lists, and translating error codes via natural language.
      16
      79 PyPI
      1
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Provides read-only access to DNSFilter's DNS security and filtering API, enabling users to query organizations, networks, policies, categories, block pages, and traffic and threat reports.
      57
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Provides read-only access to a Mailfact tenant, letting users list domains, sending sources, and aggregate reports, and query DMARC alignment, reporter coverage, and record-level data through MCP tools. It returns counts and rows only, without recommending policies or scoring domains.
      9
      15 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to inspect and manage one or more Technitium DNS Server instances through their HTTP API, including stats, zones, records, query logs, and optional write actions.
      MIT