pihole-dns-mcp

The DNS Manager MCP Server is designed to manage DNS entries and blocking statuses using the Pi-hole API. It allows for tasks such as adding, retrieving, and deleting DNS host entries, as well as controlling DNS blocking with timers, all handled securely via environment variables.

DNS Manager MCP Server

This Model Context Protocol (MCP) server provides tools to manage DNS host entries and blocking status through the Pi-hole API.

Features

Retrieve a list of current DNS host entries
Add new DNS host entries
Delete existing DNS host entries
Get DNS blocking status
Enable/disable DNS blocking with optional timers
Session management with automatic renewal
Secure password handling through environment variables

Requirements

Python 3.13 or higher
A Pi-hole instance with API access