Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PIHOLE_URL | Yes | Pi-hole web interface URL | |
| PIHOLE_PASSWORD | Yes | Pi-hole app password (generated in Pi-hole settings) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pihole_get_stats | Get Pi-hole statistics including total queries, blocked queries, blocking percentage, active clients, and domains being blocked |
| pihole_get_blocking_status | Check if Pi-hole blocking is currently enabled or disabled |
| pihole_enable_blocking | Enable Pi-hole DNS blocking |
| pihole_disable_blocking | Disable Pi-hole DNS blocking, optionally for a specific duration |
| pihole_get_top_blocked | Get the top blocked domains |
| pihole_get_top_permitted | Get the top permitted (allowed) domains |
| pihole_get_top_clients | Get the top clients by query count |
| pihole_get_query_log | Get recent DNS queries from the query log |
| pihole_add_to_whitelist | Add a domain to the Pi-hole whitelist (allow list) |
| pihole_add_to_blacklist | Add a domain to the Pi-hole blacklist (block list) |
| pihole_remove_from_whitelist | Remove a domain from the Pi-hole whitelist |
| pihole_remove_from_blacklist | Remove a domain from the Pi-hole blacklist |
| pihole_get_whitelist | Get all domains on the Pi-hole whitelist |
| pihole_get_blacklist | Get all domains on the Pi-hole blacklist |
| pihole_update_gravity | Update Pi-hole's gravity (refresh blocklists). This may take a minute to complete. |
| pihole_flush_cache | Flush Pi-hole's DNS cache |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |