pihole-mcp
by hexamatic
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TZ | No | IANA timezone for rendered timestamps (e.g. Australia/Adelaide). Timezone data is embedded in the binary, so this works in the Docker image out of the box. | |
| PIHOLE_URL | No | Pi-hole base URL (e.g. http://192.168.1.2) | |
| PIHOLE_PASSWORD | No | Admin password or application password | |
| PIHOLE_TOOLSETS | No | Comma-separated toolset names to expose, e.g. dashboard,domains. Unset or all exposes everything. | |
| PIHOLE_READ_ONLY | No | Expose only tools that cannot change Pi-hole. See Scoping the tool surface. | false |
| PIHOLE_RATE_LIMIT | No | Per-session requests-per-minute cap on the HTTP/SSE transports, under a per-address ceiling of four times that. 0 disables. | 120 |
| PIHOLE_MAX_RETRIES | No | Retries after a failed Pi-hole API call. 0 disables. | 3 |
| PIHOLE_ALLOWED_ORIGINS | No | Comma-separated Origin/Host allowlist for HTTP/SSE transports. The literal * disables enforcement (unsafe). Not authentication. | localhost,127.0.0.1,[::1] |
| PIHOLE_HTTP_AUTH_TOKEN | No | Shared bearer token required on every HTTP/SSE request. Minimum 16 characters. Unset means no authentication. | |
| PIHOLE_REQUEST_TIMEOUT | No | HTTP request timeout | 30s |
| PIHOLE_RETRY_MAX_DELAY | No | Upper bound on a single backoff wait. | 8s |
| PIHOLE_TLS_SKIP_VERIFY | No | Disable TLS certificate verification for Pi-hole connections. Only for instances serving self-signed certificates. A trusted certificate is preferable where possible. | false |
| PIHOLE_TRUSTED_PROXIES | No | Comma-separated IPs or CIDR blocks whose X-Forwarded-For the rate limiter believes. Unset means the header is ignored. | |
| OTEL_EXPORTER_OTLP_ENDPOINT | No | OpenTelemetry collector endpoint. Setting it enables tracing; ignored in slim builds. | |
| PIHOLE_HTTP_AUTH_TOKEN_FILE | No | Path to a file holding the bearer token, so it stays out of ps. Mutually exclusive with PIHOLE_HTTP_AUTH_TOKEN. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessWithin a week