// MCP TOOL REFERENCE

MCP PIHOLE TOOLS

16 tools from the Mcp Pihole MCP Server, categorised by risk level.

READ TOOLS

pihole_get_blacklist List all blacklisted domains 2/5 pihole_get_blocking_status Check if DNS blocking is enabled 2/5 pihole_get_query_log Get recent DNS queries 2/5 pihole_get_stats Get comprehensive Pi-hole statistics 2/5 pihole_get_top_blocked Get top blocked domains 2/5 pihole_get_top_clients Get top clients by query count 2/5 pihole_get_top_permitted Get top permitted domains 2/5 pihole_get_whitelist List all whitelisted domains 2/5

WRITE TOOLS

pihole_add_to_blacklist Add a domain to the blacklist 4/5 pihole_add_to_whitelist Add a domain to the whitelist 4/5 pihole_disable_blocking Disable Pi-hole DNS blocking 5/5 pihole_enable_blocking Enable Pi-hole DNS blocking 4/5

DESTRUCTIVE TOOLS

pihole_flush_cache Flush the DNS cache 4/5 pihole_remove_from_blacklist Remove a domain from the blacklist 4/5 pihole_remove_from_whitelist Remove a domain from the whitelist 4/5

EXECUTE TOOLS

pihole_update_gravity Update Pi-hole blocklists from sources 4/5

// FAQ

How many tools does the Mcp Pihole MCP server have? +

The Mcp Pihole MCP server exposes 16 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Mcp Pihole tools? +

Use Intercept, the open-source MCP proxy. Write YAML rules for each tool — rate limits, argument validation, or deny rules — then run Intercept in front of the Mcp Pihole server.

What risk categories do Mcp Pihole tools fall into? +

Mcp Pihole tools are categorised as Read (8), Write (4), Destructive (3), Execute (1). Each category has a recommended default policy.

Enforce policies on Mcp Pihole

Open source. One binary. Zero dependencies.

npx -y @policylayer/intercept

github.com/policylayer/intercept →