← Index

Pi-hole MCP Server

io.github.hexamatic/pihole-mcpv0.8.0Other

Manage Pi-hole v6: DNS blocking, domains, clients, query analysis, DHCP, and multi-instance sync.

In-path gate · all MCP tools

Using Pi-hole MCP Server in Claude, Cursor, Gemini CLI, Cline, or Zed?

MCP tool contracts can change remotely with no version bump. The mcpindex gate pins each contract and HOLDs the call when it drifts-before your agent acts. Zero credentials. This is not the package install for this server itself (use Install this server for that).

Install the mcpindex gate (one command)

Rewrites your MCP host config so each server launches behind the gate. Inspect first: curl -fsSL https://mcpindex.ai/install.sh | less

uv tool install mcpindex-gate && mcpindex-config-wire
Auditable install path →Watch it hold a drift →
Trust verdict · v1 advisory · method
NOT YET SCREENEDno verdict on file

Verdict not yet evaluated for this tool. The semantic screen takes adversarial cases first; coverage rolls out as the corpus expands (15/150 labels to graduation). The deterministic conformance probe is built but has not yet run on the public corpus, so a recorded verdict here is REVIEW or UNVERIFIED, never a clearing ALLOW. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: the eval, four-state verdict, honest limits.

Own this server? Screen its description →

That verdict was true at screening time (snapshot 2026-07-25).

Contracts can change after screening, with no version bump. The gate pins Pi-hole MCP Server’s tool contracts on first sight and holds any silent change before your agent acts - the check that keeps being true on Tuesday.

See your first HOLD in 2 minutes →

Related: how to trust an MCP server · screen before install · silent contract drift

Environment variables
PIHOLE_URL
required

Base URL of your Pi-hole web interface. For multiple Pi-holes use PIHOLE_1_URL, PIHOLE_2_URL, ... instead.

PIHOLE_PASSWORD
requiredsecret

Pi-hole admin password, or an application password (recommended — bypasses TOTP 2FA)

TZ

IANA timezone for rendered timestamps, e.g. Australia/Adelaide. Defaults to UTC in the container.

PIHOLE_TLS_SKIP_VERIFY

Set to true only for a Pi-hole serving a self-signed HTTPS certificate. A trusted certificate is the better fix.

PIHOLE_REQUEST_TIMEOUT

HTTP request timeout as a Go duration, e.g. 30s or 1m

PIHOLE_MAX_RETRIES

Retries after a transient Pi-hole API failure; 0 disables retrying

PIHOLE_RETRY_MAX_DELAY

Upper bound on a single exponential-backoff wait, as a Go duration

MCP quality score · maturity, not trust · methodology
freshness
25
completeness
25
installability
25
documentation
15
stability
5
Alternatives in Other
hood. — .hood name service
ag.hood/name-service

Resolve .hood names on Robinhood Chain — forward/reverse, text records, availability & pricing.

agency.lona/trading
agency.lona/trading

AI-powered trading strategy development: backtesting, market data, and portfolio analysis

ABMeter
ai.abmeter/abmeter

Feature flagging and A/B testing platform with AI-first experimentation workflows.