opnsense_dns_list_blocklist
Lists all domain overrides configured for domain blocking in Unbound DNS resolver. Retrieve current blocklist entries to verify or audit DNS filtering rules.
Instructions
List all domain overrides (used for domain blocking) in Unbound
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/dns.ts:343-347 (handler)Handler for opnsense_dns_list_blocklist. Calls /unbound/settings/searchDot API endpoint (since OPNsense 24.7+ merged domain overrides into dots model) and returns the result as JSON.
case "opnsense_dns_list_blocklist": { // OPNsense 24.7+: domain overrides merged into dots model const result = await client.get("/unbound/settings/searchDot"); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; } - src/tools/dns.ts:150-154 (registration)Tool definition/registration for opnsense_dns_list_blocklist in the dnsToolDefinitions array. Defines name, description, and inputSchema (no params needed).
{ name: "opnsense_dns_list_blocklist", description: "List all domain overrides (used for domain blocking) in Unbound", inputSchema: { type: "object" as const, properties: {} }, }, - src/index.ts:59-59 (registration)Registers all DNS tools (including opnsense_dns_list_blocklist) by mapping their names to the handleDnsTool function in the toolHandlers Map.
for (const def of dnsToolDefinitions) toolHandlers.set(def.name, handleDnsTool);