@owine/unifi-network-mcp 2.3.3 → 2.5.0

package/dist/tools/acl.js

@@ -85,9 +85,9 @@ function registerAclTools(server, client, readOnly = false) {
                 .optional()
                 .describe("Rule description"),
             protocolFilter: zod_1.z
-                .array(zod_1.z.string())
+                .array(zod_1.z.enum(["TCP", "UDP"]))
                 .optional()
-                .describe("Protocols: TCP, UDP"),
+                .describe("Protocols this ACL rule will be applied to (TCP, UDP). When null, applies to all protocols"),
             dryRun: zod_1.z
                 .boolean()
                 .optional()
@@ -115,18 +115,18 @@ function registerAclTools(server, client, readOnly = false) {
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             aclRuleId: zod_1.z.string().describe("ACL rule ID"),
-            type: zod_1.z.string().describe("ACL rule type"),
+            type: zod_1.z.enum(["IPV4", "MAC"]).describe("ACL rule type"),
             name: zod_1.z.string().describe("ACL rule name"),
             enabled: zod_1.z.boolean().describe("Whether the rule is enabled"),
-            action: zod_1.z.string().describe("Rule action (ALLOW, DENY, etc.)"),
+            action: zod_1.z.enum(["ALLOW", "BLOCK"]).describe("Rule action"),
             description: zod_1.z
                 .string()
                 .optional()
                 .describe("Rule description"),
             protocolFilter: zod_1.z
-                .record(zod_1.z.string(), zod_1.z.unknown())
+                .array(zod_1.z.enum(["TCP", "UDP"]))
                 .optional()
-                .describe("Protocol filter configuration"),
+                .describe("Protocols this ACL rule will be applied to (TCP, UDP). When null, applies to all protocols"),
             dryRun: zod_1.z
                 .boolean()
                 .optional()

package/dist/tools/firewall.js

@@ -110,27 +110,15 @@ function registerFirewallTools(server, client, readOnly = false) {
             siteId: zod_1.z.string().describe("Site ID"),
             sourceFirewallZoneId: zod_1.z
                 .string()
-                .optional()
                 .describe("Source firewall zone ID"),
             destinationFirewallZoneId: zod_1.z
                 .string()
-                .optional()
                 .describe("Destination firewall zone ID"),
         },
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, sourceFirewallZoneId, destinationFirewallZoneId }) => {
         try {
-            let query = "";
-            const params = new URLSearchParams();
-            if (sourceFirewallZoneId !== undefined) {
-                params.set("sourceFirewallZoneId", sourceFirewallZoneId);
-            }
-            if (destinationFirewallZoneId !== undefined) {
-                params.set("destinationFirewallZoneId", destinationFirewallZoneId);
-            }
-            const qs = params.toString();
-            if (qs)
-                query = `?${qs}`;
+            const query = `?sourceFirewallZoneId=${encodeURIComponent(sourceFirewallZoneId)}&destinationFirewallZoneId=${encodeURIComponent(destinationFirewallZoneId)}`;
             const data = await client.get(`/sites/${siteId}/firewall/policies/ordering${query}`);
             return (0, responses_js_1.formatSuccess)(data);
         }

package/dist/tools/wifi.js

@@ -87,6 +87,12 @@ function registerWifiTools(server, client, readOnly = false) {
             advertiseDeviceName: zod_1.z
                 .boolean()
                 .describe("Advertise device name in beacon frames"),
+            channel2gLockedTo6: zod_1.z
+                .boolean()
+                .describe("Lock 2.4GHz channel to 6 on all broadcasting devices"),
+            dtimPeriod2gLockedTo3: zod_1.z
+                .boolean()
+                .describe("Lock 2.4GHz DTIM period to 3"),
             network: zod_1.z
                 .record(zod_1.z.string(), zod_1.z.unknown())
                 .optional()
@@ -131,13 +137,21 @@ function registerWifiTools(server, client, readOnly = false) {
                 .record(zod_1.z.string(), zod_1.z.unknown())
                 .optional()
                 .describe("DTIM period override by frequency"),
+            dnsAssistanceConfiguration: zod_1.z
+                .record(zod_1.z.string(), zod_1.z.unknown())
+                .optional()
+                .describe("DNS assistance configuration"),
+            handoffSuggestionsConfiguration: zod_1.z
+                .record(zod_1.z.string(), zod_1.z.unknown())
+                .optional()
+                .describe("Handoff suggestions config (band5GHzRssiThreshold, band6GHzRssiThreshold). Null disables"),
             dryRun: zod_1.z
                 .boolean()
                 .optional()
                 .describe("Preview this action without executing it"),
         },
         annotations: safety_js_1.WRITE_NOT_IDEMPOTENT,
-    }, async ({ siteId, name, enabled, type, broadcastingFrequenciesGHz, securityConfiguration, multicastToUnicastConversionEnabled, clientIsolationEnabled, hideName, uapsdEnabled, arpProxyEnabled, bssTransitionEnabled, advertiseDeviceName, network, broadcastingDeviceFilter, mdnsProxyConfiguration, multicastFilteringPolicy, basicDataRateKbpsByFrequencyGHz, clientFilteringPolicy, blackoutScheduleConfiguration, hotspotConfiguration, mloEnabled, bandSteeringEnabled, dtimPeriodByFrequencyGHzOverride, dryRun, }) => {
+    }, async ({ siteId, name, enabled, type, broadcastingFrequenciesGHz, securityConfiguration, multicastToUnicastConversionEnabled, clientIsolationEnabled, hideName, uapsdEnabled, arpProxyEnabled, bssTransitionEnabled, advertiseDeviceName, channel2gLockedTo6, dtimPeriod2gLockedTo3, network, broadcastingDeviceFilter, mdnsProxyConfiguration, multicastFilteringPolicy, basicDataRateKbpsByFrequencyGHz, clientFilteringPolicy, blackoutScheduleConfiguration, hotspotConfiguration, mloEnabled, bandSteeringEnabled, dtimPeriodByFrequencyGHzOverride, dnsAssistanceConfiguration, handoffSuggestionsConfiguration, dryRun, }) => {
         try {
             const body = {
                 name,
@@ -152,6 +166,8 @@ function registerWifiTools(server, client, readOnly = false) {
                 arpProxyEnabled,
                 bssTransitionEnabled,
                 advertiseDeviceName,
+                channel2gLockedTo6,
+                dtimPeriod2gLockedTo3,
             };
             if (network !== undefined)
                 body.network = network;
@@ -175,6 +191,10 @@ function registerWifiTools(server, client, readOnly = false) {
                 body.bandSteeringEnabled = bandSteeringEnabled;
             if (dtimPeriodByFrequencyGHzOverride !== undefined)
                 body.dtimPeriodByFrequencyGHzOverride = dtimPeriodByFrequencyGHzOverride;
+            if (dnsAssistanceConfiguration !== undefined)
+                body.dnsAssistanceConfiguration = dnsAssistanceConfiguration;
+            if (handoffSuggestionsConfiguration !== undefined)
+                body.handoffSuggestionsConfiguration = handoffSuggestionsConfiguration;
             if (dryRun)
                 return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/wifi/broadcasts`, body);
             const data = await client.post(`/sites/${siteId}/wifi/broadcasts`, body);
@@ -228,6 +248,14 @@ function registerWifiTools(server, client, readOnly = false) {
                 .boolean()
                 .optional()
                 .describe("Advertise device name in beacon frames"),
+            channel2gLockedTo6: zod_1.z
+                .boolean()
+                .optional()
+                .describe("Lock 2.4GHz channel to 6 on all broadcasting devices"),
+            dtimPeriod2gLockedTo3: zod_1.z
+                .boolean()
+                .optional()
+                .describe("Lock 2.4GHz DTIM period to 3"),
             network: zod_1.z
                 .record(zod_1.z.string(), zod_1.z.unknown())
                 .optional()
@@ -272,13 +300,21 @@ function registerWifiTools(server, client, readOnly = false) {
                 .record(zod_1.z.string(), zod_1.z.unknown())
                 .optional()
                 .describe("DTIM period override by frequency"),
+            dnsAssistanceConfiguration: zod_1.z
+                .record(zod_1.z.string(), zod_1.z.unknown())
+                .optional()
+                .describe("DNS assistance configuration"),
+            handoffSuggestionsConfiguration: zod_1.z
+                .record(zod_1.z.string(), zod_1.z.unknown())
+                .optional()
+                .describe("Handoff suggestions config (band5GHzRssiThreshold, band6GHzRssiThreshold). Null disables"),
             dryRun: zod_1.z
                 .boolean()
                 .optional()
                 .describe("Preview this action without executing it"),
         },
         annotations: safety_js_1.WRITE,
-    }, async ({ siteId, wifiBroadcastId, name, enabled, type, broadcastingFrequenciesGHz, securityConfiguration, multicastToUnicastConversionEnabled, clientIsolationEnabled, hideName, uapsdEnabled, arpProxyEnabled, bssTransitionEnabled, advertiseDeviceName, network, broadcastingDeviceFilter, mdnsProxyConfiguration, multicastFilteringPolicy, basicDataRateKbpsByFrequencyGHz, clientFilteringPolicy, blackoutScheduleConfiguration, hotspotConfiguration, mloEnabled, bandSteeringEnabled, dtimPeriodByFrequencyGHzOverride, dryRun, }) => {
+    }, async ({ siteId, wifiBroadcastId, name, enabled, type, broadcastingFrequenciesGHz, securityConfiguration, multicastToUnicastConversionEnabled, clientIsolationEnabled, hideName, uapsdEnabled, arpProxyEnabled, bssTransitionEnabled, advertiseDeviceName, channel2gLockedTo6, dtimPeriod2gLockedTo3, network, broadcastingDeviceFilter, mdnsProxyConfiguration, multicastFilteringPolicy, basicDataRateKbpsByFrequencyGHz, clientFilteringPolicy, blackoutScheduleConfiguration, hotspotConfiguration, mloEnabled, bandSteeringEnabled, dtimPeriodByFrequencyGHzOverride, dnsAssistanceConfiguration, handoffSuggestionsConfiguration, dryRun, }) => {
         try {
             const body = {};
             if (name !== undefined)
@@ -306,6 +342,10 @@ function registerWifiTools(server, client, readOnly = false) {
                 body.bssTransitionEnabled = bssTransitionEnabled;
             if (advertiseDeviceName !== undefined)
                 body.advertiseDeviceName = advertiseDeviceName;
+            if (channel2gLockedTo6 !== undefined)
+                body.channel2gLockedTo6 = channel2gLockedTo6;
+            if (dtimPeriod2gLockedTo3 !== undefined)
+                body.dtimPeriod2gLockedTo3 = dtimPeriod2gLockedTo3;
             if (network !== undefined)
                 body.network = network;
             if (broadcastingDeviceFilter !== undefined)
@@ -328,6 +368,10 @@ function registerWifiTools(server, client, readOnly = false) {
                 body.bandSteeringEnabled = bandSteeringEnabled;
             if (dtimPeriodByFrequencyGHzOverride !== undefined)
                 body.dtimPeriodByFrequencyGHzOverride = dtimPeriodByFrequencyGHzOverride;
+            if (dnsAssistanceConfiguration !== undefined)
+                body.dnsAssistanceConfiguration = dnsAssistanceConfiguration;
+            if (handoffSuggestionsConfiguration !== undefined)
+                body.handoffSuggestionsConfiguration = handoffSuggestionsConfiguration;
             if (dryRun)
                 return (0, safety_js_1.formatDryRun)("PUT", `/sites/${siteId}/wifi/broadcasts/${wifiBroadcastId}`, body);
             const data = await client.put(`/sites/${siteId}/wifi/broadcasts/${wifiBroadcastId}`, body);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owine/unifi-network-mcp",
-  "version": "2.3.3",
+  "version": "2.5.0",
   "description": "MCP server for the UniFi Network API",
   "main": "dist/index.js",
   "bin": {
@@ -20,8 +20,9 @@
     "lint:fix": "eslint . --fix"
   },
   "engines": {
-    "node": "^20.19.0 || ^22.13.0 || >=24"
+    "node": "v26.1.0"
   },
+  "packageManager": "pnpm@11.1.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/owine/unifi-network-mcp.git"
@@ -36,16 +37,16 @@
   "author": "owine",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "zod": "^4.0.0"
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "zod": "4.4.3"
   },
   "devDependencies": {
     "@eslint/js": "10.0.1",
-    "@types/node": "24.12.2",
-    "@vitest/coverage-v8": "4.1.5",
+    "@types/node": "24.12.4",
+    "@vitest/coverage-v8": "4.1.6",
     "eslint": "10.3.0",
     "typescript": "6.0.3",
-    "typescript-eslint": "8.59.2",
-    "vitest": "4.1.5"
+    "typescript-eslint": "8.59.3",
+    "vitest": "4.1.6"
   }
 }