OPNSense MCP Server

Instructions

Implementation Reference

• src/resources/services/dns/blocklist.ts:258-295 (handler)

  The main handler function for the 'apply_blocklist_category' tool. It takes a category parameter and applies the corresponding predefined blocklist by blocking multiple domains using blockMultipleDomains method, delegating to specific block methods for adult and malware.

  async applyBlocklistCategory(category: 'adult' | 'malware' | 'ads' | 'social'): Promise<{ blocked: string[], failed: string[] }> {
    switch (category) {
      case 'adult':
        return this.blockAdultContent();
      
      case 'malware':
        return this.blockMalware();
      
      case 'ads': {
        const adDomains = [
          'doubleclick.net',
          'googleadservices.com',
          'googlesyndication.com',
          'adnxs.com',
          'facebook.com/tr',
          'amazon-adsystem.com'
        ];
        return this.blockMultipleDomains(adDomains, 'Ad Block');
      }
      
      case 'social': {
        const socialDomains = [
          'facebook.com',
          'www.facebook.com',
          'instagram.com',
          'www.instagram.com',
          'twitter.com',
          'www.twitter.com',
          'tiktok.com',
          'www.tiktok.com'
        ];
        return this.blockMultipleDomains(socialDomains, 'Social Media Block');
      }
      
      default:
        throw new Error(`Unknown category: ${category}`);
    }
  }