Investigate a Domain
Check recent DNS queries for [domain] and its matching lists. Explain the blocking reason.
pi_hole
Pi-hole AI Employee
Leina connects to Pi-hole to help you investigate blocked domains and review DNS activity. Ask in your team chat. Leina does the work and brings back the result.
Connect Pi-hole, choose what to share, and hand off your first task.
Leina + Pi-hole Example Result
You
Check why the sample-news site is blocked. Read its recent queries and matching lists.
Leina
The domain matches a blocking list. I’ve recorded the match and the recent query outcome.
Pi-hole · Example
sample-news · DNS review
The blocking reason is ready for review.
- Queries
- Recent requests to the domain were blocked.
- List match
- The domain appears in a configured blocklist.
- Decision
- Review the site before adding an exception.
What Is a Pi-hole AI Agent?
A Pi-hole AI agent can trace a blocked domain, review DNS activity, or pause blocking for a duration you specify.
You specify the source and the destination. Leina uses the content available to your connection and returns the result for you to review.
Pi-hole
Pi-hole filters DNS requests to block unwanted domains.
-
Name the domain
Choose the domain and time period.
-
Trace the block
Read DNS queries and matching list entries.
-
Review the explanation
See the evidence before changing blocking.
What to Ask Leina to Do with Pi-hole
Copy a prompt, add your details, and send it to Leina in your connected team chat.
Review DNS Activity
Review Pi-hole DNS activity and upstream response times. Summarize anything that needs attention.
pi_hole
Set Timed Blocking
Pause DNS blocking for [duration], then check the resulting blocking status.
pi_hole
Your next Pi-hole task can start with a message.
Connect. Ask. Get the Result.
Tell Leina what you need in your team chat. Include the source, destination, and expected result.
-
Connect Your Account
Connect the tools involved and give Leina access to the content it needs.
-
Try a Task
Share the source material, say where the result belongs, and describe what you need.
-
Check the Result
Review the result and any changes in the connected app.
Put Leina to Work in Pi-hole
Hand off these everyday tasks to your AI employee.
Get Overview
Fetch the Pi-hole activity overview: total and blocked queries, blocked query percentage, unique clients and domains, and the blocking and gravity list status.
Get Dns Blocking Status
Fetch whether Pi-hole DNS blocking is currently enabled, disabled, failed, or unknown.
Set Dns Blocking
Enable or disable Pi-hole DNS blocking, optionally for a limited time after which the opposite mode is restored automatically.
Get Queries
Query the Pi-hole DNS log with optional filters. By default returns the most recent queries; each response exposes a cursor for the next chunk.
Get Query Types
Fetch the number of queries of each DNS query type that Pi-hole has seen.
Get Top Domains
Fetch the domains Pi-hole has handled the most, optionally limited to blocked ones.
Get Top Clients
Fetch the clients that have queried Pi-hole the most, optionally limited to blocked ones.
Get Recent Blocked
Fetch the domains most recently blocked by Pi-hole.
Get Upstreams
Fetch metrics about Pi-hole's DNS upstream destinations, including response times.
Get History
Fetch the Pi-hole activity graph data: query totals over time with cached, blocked, and forwarded splits.
Search Domain
Search whether a domain appears in Pi-hole's allowlists, blocklists, or gravity lists, to understand why it is blocked or allowed.
Get Config
Fetch the current Pi-hole configuration, such as DNS settings, privacy level, and API settings.
Update Config
Change part of the Pi-hole configuration, for example DNS upstreams, the privacy level, or API settings. The provided fields are merged into the current configuration.
Run Gravity
Run the Pi-hole gravity update to refresh the blocklists. The instance streams the gravity log; the action reports a best-effort status from the log plus the tail of the stream.
Restart Dns
Restart Pi-hole's DNS server and reload its DNS configuration.
Flush Dns Logs
Flush the Pi-hole DNS query log.
List Groups
List all Pi-hole groups and their memberships.
Create Group
Create one or more Pi-hole groups, optionally with a comment and enabled state.
Update Group
Update one Pi-hole group: rename it, or change its comment or enabled state.
Delete Group
Delete one Pi-hole group by name.
List Lists
List the Pi-hole allowlists and blocklists (subscription lists).
Add List
Add one or more allowlist or blocklist entries (addresses) to Pi-hole.
Update List
Update one Pi-hole list: change its comment, enabled state, or group memberships.
Delete List
Delete one Pi-hole allowlist or blocklist entry by address.
List Domains
List the individual Pi-hole domain entries, optionally restricted to one type or kind.
Add Domain
Add one or more allow or deny domain entries to Pi-hole, either exact or as regular expressions.
Update Domain
Update one Pi-hole domain entry: change its comment, enabled state, or group memberships.
Delete Domain
Delete one Pi-hole allow or deny domain entry.
List Clients
List all Pi-hole clients and their group memberships.
Create Client
Register one or more Pi-hole clients identified by IP address, MAC address, hostname, or interface.
Update Client
Update one Pi-hole client's comment or group memberships.
Delete Client
Delete one Pi-hole client entry by identifier.
Batch Delete Groups
Delete multiple Pi-hole groups by name in one request. Reports deleted=false when none of the groups exist.
Batch Delete Lists
Delete multiple Pi-hole allowlist or blocklist entries in one request. Reports deleted=false when none of the entries exist.
Batch Delete Domains
Delete multiple Pi-hole domain entries in one request. Reports deleted=false when none of the entries exist.
Batch Delete Clients
Delete multiple Pi-hole client entries in one request. Reports deleted=false when none of the clients exist.
Get Dhcp Leases
Fetch the currently active DHCP leases assigned by the Pi-hole DHCP server.
Get Network Devices
Fetch the devices seen on the local network by Pi-hole.
Export Backup
Create a complete Pi-hole teleporter backup archive (teleporter.zip) with all settings, lists, and clients.
Import Backup
Restore a Pi-hole teleporter backup archive (a previously exported teleporter.zip) to this instance.
More Tools for Your AI Employee
Connect the Apps your work depends on, and give Leina the context to carry the task forward.
Keep the Conversation Moving. Let Leina Pick Up the Work.
Hand off a task while your team is discussing it. Leina uses your connected tools and brings the result back to the conversation.
See How Leina Works in SlackLeinaExample Result The domain matches a blocking list. I’ve recorded the match and the recent query outcome.
sample-news · DNS review
Pi-hole + Leina: Your Questions, Answered
Can I connect a local-only instance?
No. This connection needs a publicly reachable Pi-hole instance.
Will a temporary pause end automatically?
Yes. When the timer ends, Pi-hole switches to the opposite blocking mode.
Make Leina Your Pi-hole AI Employee
Start with one task you already need to do. Tell Leina what a finished result should look like.
Connect Pi-hole, choose what to share, and hand off your first task.