Skip to content

technitium-dns-mcp

Technitium DNS Server API + MCP Server and Agent for the agent-utilities ecosystem — authoritative-zone, record, analytics, and account management exposed as typed, deterministic tools an agent can call.

Official documentation

This site is the canonical reference for technitium-dns-mcp, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

technitium-dns-mcp wraps the Technitium DNS Server HTTP API with typed, deterministic MCP tools and a Pydantic AI agent. It provides:

  • Api — a granular requests-based REST facade covering the User/SSO, Dashboard analytics, and authoritative-zone surfaces of the Technitium API.
  • A FastMCP tool surface grouped under the user, dashboard, and zones tags, registering account, metrics, zone, DNSSEC, and record operations.
  • A Pydantic AI agent (technitium-dns-agent) that drives the MCP tools for autonomous DNS administration.

The server remains inactive when credentials are absent and connects to any Technitium instance over its web service port.

Explore the documentation

  • Installation — pip, source, extras, and the prebuilt Docker image.
  • Deployment — run the MCP and agent servers, Docker Compose, Caddy + Technitium.
  • Usage — the MCP tools, the Api client, and the CLI.
  • Backing Platform — deploy Technitium DNS Server with Docker.
  • Architecture — the layered API / MCP / agent design.
  • Concepts — the CONCEPT:TDNS-* registry.

Quick start

pip install "technitium-dns-mcp[mcp]"
technitium-dns-mcp                       # stdio MCP server (default transport)

Connect it to a Technitium DNS Server:

export TECHNITIUM_DNS_URL=http://your-technitium:5380
export TECHNITIUM_DNS_TOKEN=your-api-token
technitium-dns-mcp --transport streamable-http --host 0.0.0.0 --port 8000

See Installation and Deployment for the full matrix (PyPI extras, Docker image, all transports, reverse proxy, DNS).