Return the installed version of the mcp-pihole server.

Get Pi-hole status summary.

Returns blocking status, total queries today, blocked count, percentage blocked, domains on blocklist, clients seen, unique domains, cached and forwarded query counts.

Get top queried domains.

count: number of domains to return (max 100). blocked: if True, returns top blocked domains instead of top permitted.

Get top DNS clients by query count.

count: number of clients to return (max 100). blocked: if True, returns clients with most blocked queries.

Get recent DNS queries.

length: number of queries to return (max 100). cursor: database ID for cursor-based pagination. Pass the cursor value from a previous response to get the next page.

Get Pi-hole FTL version information.

Get all configured blocklists.

Returns each list's URL, enabled/disabled status, comment, and groups.

Add a blocklist by URL.

address: URL of the blocklist (e.g., https://example.com/hosts.txt). comment: optional description. enabled: whether the list is active (default True).

After adding, run update_gravity to apply changes.

Remove a blocklist by URL.

address: exact URL of the blocklist to remove. After removing, run update_gravity to apply changes.

Update a blocklist's enabled status or comment.

address: exact URL of the blocklist to update. enabled: set True to enable, False to disable. comment: update the list's description.

Only provided fields are changed. After changes, run update_gravity.

Rebuild the gravity database.

Required after adding, removing, or modifying blocklists for changes to take effect. Runs asynchronously on the Pi-hole server.

Get configured domain entries.

type: "allow" (whitelist) or "deny" (blacklist). kind: "exact" (exact match) or "regex" (regular expression).

Add a domain to the allow or deny list.

domain: the domain or regex pattern to add. type: "allow" (whitelist) or "deny" (blacklist). kind: "exact" (exact domain match) or "regex" (regular expression). comment: optional description.

Remove a domain from the allow or deny list.

domain: the exact domain or regex pattern to remove. type: "allow" or "deny". kind: "exact" or "regex".

Check if a domain is blocked and by which list.

Searches gravity, antigravity, exact deny/allow, and regex deny/allow lists. Useful for troubleshooting why a domain is blocked or allowed.

Get current DNS blocking status.

Returns whether blocking is enabled/disabled and any active timer.

Enable or disable DNS blocking.

enabled: True to enable, False to disable. timer: optional seconds before blocking auto-reverts. Example: set_blocking(False, 300) disables for 5 minutes.

Get current DHCP leases.

Returns active leases with IP, MAC address, hostname, and expiry time.

Restart the Pi-hole DNS resolver.

Use after configuration changes that require a DNS restart.