Skip to main content
Glama
chris2ao

pihole-mcp

by chris2ao
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PIHOLE_URLYesThe URL of the Pi-hole server
PIHOLE_PASSWORDYesThe application password for Pi-hole API authentication, created in the Pi-hole Web UI under Settings > Web Interface > 'Application password' > Generate

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_statsA

Get summary statistics (total queries, blocked queries, blocking percentage, unique domains, clients).

get_top_blockedB

Get top blocked domains by query count.

get_top_permittedB

Get top allowed (permitted) domains by query count.

get_top_clientsA

Get top clients by query count. Set blocked=true for top clients by blocked query count.

get_query_typesB

Breakdown of DNS query types (A, AAAA, PTR, SRV, etc).

get_forward_destinationsA

Upstream DNS server stats (which forwarders served how many queries).

get_recent_blockedC

Recently blocked domains.

get_historyA

Time-series activity graph: timestamps, allowed/blocked/other counts per bucket.

get_query_logA

Fetch recent DNS queries with optional filters.

Filters:

  • length: number of queries (default 100)

  • from_ts / until_ts: Unix timestamps

  • domain: exact or wildcard (*) domain match

  • client_ip: exact or wildcard (*) client IP match

  • upstream: one of 'cache', 'blocklist', 'permitted'

  • cursor: pagination cursor from previous response

get_query_suggestionsA

Get available filter values for the query log (domains, clients, upstreams, types, statuses).

get_blocking_statusA

Check if Pi-hole DNS blocking is enabled. Returns status and any active timer.

enable_blockingA

Enable DNS blocking immediately.

disable_blockingA

Disable DNS blocking. If duration_seconds is given, re-enables after that timer; otherwise indefinite.

get_whitelistA

List all exact-match allowed domains.

get_blacklistA

List all exact-match blocked domains.

add_to_whitelistC

Add a domain to the allow list (whitelist).

add_to_blacklistC

Add a domain to the deny list (blacklist).

remove_from_whitelistB

Remove a domain from the allow list.

remove_from_blacklistB

Remove a domain from the deny list.

list_local_dnsA

List local DNS entries (hosts and CNAME records).

add_local_a_recordA

Add a local A record (host -> IP). Replaces any existing entry for the same host.

remove_local_a_recordB

Remove any local A record matching the given host.

add_local_cname_recordA

Add a local CNAME record (host -> target). Replaces any existing CNAME for the same host.

remove_local_cname_recordB

Remove any local CNAME record for the given host.

update_gravityA

Refresh Pi-hole gravity (adlist database). Takes a minute or more to complete.

flush_cacheA

Flush the Pi-hole DNS cache.

flush_logsA

Clear the Pi-hole query log.

get_tail_logC

Get the tail of a Pi-hole log file. log must be one of 'dnsmasq', 'ftl', 'webserver'.

server_infoA

Return chris2ao-pihole-mcp server version, configured Pi-hole URL, and tool count.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chris2ao/pihole-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server