dns_update_blocklists
Trigger an immediate update of all configured block lists, overriding the default 24-hour schedule.
Instructions
Force an immediate update of all configured block lists. Normally block lists update every 24 hours.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/settings.ts:103-123 (handler)Defines the 'dns_update_blocklists' tool with its handler that calls /api/settings/forceUpdateBlockLists API endpoint to trigger an immediate block list update.
{ definition: { name: "dns_update_blocklists", description: "Force an immediate update of all configured block lists. Normally block lists update every 24 hours.", inputSchema: { type: "object", properties: {}, }, }, readonly: false, handler: async () => { const data = await client.callOrThrow( "/api/settings/forceUpdateBlockLists" ); return JSON.stringify( { success: true, message: "Block list update triggered", ...data }, null, 2 ); }, - src/tools/settings.ts:108-111 (schema)Input schema for dns_update_blocklists - accepts no parameters (empty object).
inputSchema: { type: "object", properties: {}, }, - src/tools/settings.ts:103-124 (registration)Tool definition registered within the settingsTools() function array in src/tools/settings.ts.
{ definition: { name: "dns_update_blocklists", description: "Force an immediate update of all configured block lists. Normally block lists update every 24 hours.", inputSchema: { type: "object", properties: {}, }, }, readonly: false, handler: async () => { const data = await client.callOrThrow( "/api/settings/forceUpdateBlockLists" ); return JSON.stringify( { success: true, message: "Block list update triggered", ...data }, null, 2 ); }, }, - src/rate-limit.ts:25-31 (helper)Rate limiter registration: dns_update_blocklists is grouped with 'destructiveLimits' (5 requests per 60s window).
for (const tool of [ "dns_delete_zone", "dns_delete_record", "dns_flush_cache", "dns_flush_allowed", "dns_flush_blocked", "dns_uninstall_app", "dns_update_blocklists", "dns_temp_disable_blocking", ]) { this.toolLimits.set(tool, destructiveLimits); }