pihole-mcp
by ranklancer
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Bind address for the HTTP transport (default: '127.0.0.1'). | 127.0.0.1 |
| PORT | No | Port for the HTTP transport (default: '3000'). Ignored in stdio mode. | 3000 |
| MCP_TRANSPORT | No | Transport mode. Set to 'stdio' to use stdio; otherwise the server uses HTTP. | |
| MCP_AUTH_TOKEN | No | Bearer token for /mcp, read from the environment. Set only one of MCP_AUTH_TOKEN_FILE or MCP_AUTH_TOKEN; prefer the file form. | |
| PIHOLE_BASE_URL | No | Pi-hole base URL for the single instance named 'pihole' (e.g. 'http://pihole.example.com'). | |
| PIHOLE_PASSWORD | No | Pi-hole API password for the single instance named 'pihole' (or use Docker secrets at /run/secrets/pihole_password). | |
| PIHOLE_INSTANCES | No | Comma-separated list of Pi-hole instance names (e.g. 'pihole' or 'primary,secondary'). | |
| PRIMARY_BASE_URL | No | Pi-hole base URL for the 'primary' instance (e.g. 'http://192.0.2.100'). | |
| PRIMARY_PASSWORD | No | Pi-hole API password for the 'primary' instance (or use Docker secrets at /run/secrets/primary_password). | |
| MCP_ALLOWED_HOSTS | No | Extra hostnames accepted in the Host header (port-agnostic). localhost, 127.0.0.1 and [::1] are always accepted. | |
| SECONDARY_BASE_URL | No | Pi-hole base URL for the 'secondary' instance (e.g. 'https://198.51.100.101'). | |
| SECONDARY_PASSWORD | No | Pi-hole API password for the 'secondary' instance (or use Docker secrets at /run/secrets/secondary_password). | |
| MCP_ALLOWED_ORIGINS | No | Exact browser origins allowed to call the server. Requests with an Origin header not listed get 403. | |
| MCP_AUTH_TOKEN_FILE | No | Path to a file holding a bearer token for /mcp (e.g. /run/secrets/mcp_auth_token). Minimum 32 characters, no whitespace. | |
| PIHOLE_INSECURE_TLS | No | Set to 'true' for self-signed certs (default: 'false'). | false |
| PRIMARY_INSECURE_TLS | No | Set to 'true' for self-signed certs on the 'primary' instance (default: 'false'). | false |
| MCP_ALLOW_NON_LOOPBACK | No | Must be 'true' to bind any non-loopback address; otherwise the server refuses to start. | |
| SECONDARY_INSECURE_TLS | No | Set to 'true' for self-signed certs on the 'secondary' instance (default: 'false'). | false |
| MCP_ALLOW_UNAUTHENTICATED | No | Set to 'true' to allow a non-loopback bind without a bearer token. Not recommended. |
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
ActivityActive
ResponsivenessLimited data