dmeiser/nextdns-mcp repository overview

⁠NextDNS MCP Server

A Model Context Protocol (MCP) server for the NextDNS⁠ API, built with FastMCP⁠ and generated from OpenAPI specifications. Exposes 70+ NextDNS operations as MCP tools for AI assistants and other MCP clients.

⁠Image variants

• latest, <version>, <major>, <major>.<minor> — Default Debian slim-based image (python:3.14-slim). Recommended for most users.
• alpine, <version>-alpine, <major>-alpine, <major>.<minor>-alpine — Alpine Linux-based image for smaller footprint and different security posture.

Both variants are multi-platform (linux/amd64, linux/arm64) and include OCI labels for the Docker MCP Gateway.

⁠Quick start

docker run -i --rm \
  -e NEXTDNS_API_KEY=your_api_key_here \
  -e NEXTDNS_DEFAULT_PROFILE=your_profile_id \
  ghcr.io/dmeiser/nextdns-mcp:latest

⁠Features

• Profile management (create, read, update, delete)
• Fine-grained read/write profile access control with read-only mode
• DNS, security, privacy, parental control, and analytics tools
• Denylist/allowlist management
• DoH lookup testing
• Query logs retrieval and clearing
• OpenAPI-generated from nextdns-openapi.yaml

⁠Configuration

⁠Documentation

• Full docs: github.com/dmeiser/nextdns-mcp/blob/main/docs/index.md⁠
• Source & issues: github.com/dmeiser/nextdns-mcp⁠
• License: MIT