Agentic AI-native multi-tier DNS routing, live packet tracing, and failover bypass engine for Pi-hole, CoreDNS, dnsdist, Unbound, Stubby, DNSCrypt-Proxy, and VPN DNS.
agentic-dns Skill
agentic-dns provides a zero-dependency POSIX Bash and Rust engine for inspecting, diagnosing, routing, and failing over multi-tier DNS infrastructure.
CLI Commands
| Command | Syntax | Description |
|---|---|---|
status | agentic-dns status | Show status of all DNS services, addresses, listening ports, and active chain. |
query | agentic-dns query <domain> | Resolve domain through entrypoint DNS. |
trace | agentic-dns trace <domain> | Execute simultaneous tcpdump packet capture on loopback and network interfaces. |
routes | agentic-dns routes | Show active rules in dnsdist config. |
route add | agentic-dns route add <name> <addr:port> | Add new upstream server to dnsdist. |
route remove | agentic-dns route remove <name> | Remove upstream server from dnsdist. |
bypass | agentic-dns bypass <failing> [backup] | Bypass a failing resolver and prioritize backup. |
enforce | agentic-dns enforce <on|off|status|clean> [target_ip] | Intercept encrypted DNS (DoT port 853 -> pihole, DROP DoQ UDP/443). |
pihole-log | agentic-dns pihole-log | Query recent DNS log and top clients from Pi-hole SQLite database. |
health | agentic-dns health | Run health check sweep across listeners. |
tag | agentic-dns tag | Show service classification tags. |
api | agentic-dns api | Start REST API server on port 8099. |
mcp | agentic-dns mcp | Start stdio MCP JSON-RPC Server for AI agents. |
Standard Workflows
1. Diagnose DNS Connectivity Outage
agentic-dns status
agentic-dns health
agentic-dns trace google.com
2. Bypass Failing Upstream
agentic-dns bypass stubby unbound
3. MCP JSON-RPC Configuration for Agents
{
"mcpServers": {
"agentic-dns": {
"command": "agentic-dns",
"args": ["mcp"]
}
}
}
Related skills
- Downloads
- 350All time
- Security audit
- Review
- Last updated
- 2mo ago
- Current version
- v0.1.0
- License
- MIT-0
