@owine/unifi-network-mcp 2.6.0 → 2.7.0

package/dist/tools/networks.js

@@ -5,9 +5,10 @@ const zod_1 = require("zod");
 const responses_js_1 = require("../utils/responses.js");
 const query_js_1 = require("../utils/query.js");
 const safety_js_1 = require("../utils/safety.js");
+const output_schemas_js_1 = require("../utils/output-schemas.js");
 function registerNetworkTools(server, client, readOnly = false) {
     server.registerTool("unifi_list_networks", {
-        description: "List all networks at a site",
+        description: "List all networks (VLANs/LAN segments) at a site. Returns: id, name, management (UNMANAGED/GATEWAY/SWITCH), enabled, vlanId, default (true for the default network), dhcpGuarding, metadata.origin. NOTE: the list view is sparse — for subnet/DHCP/NTP detail (ipv4Configuration), call unifi_get_network on a specific id. Use for: VLAN inventory; pair with unifi_get_network_references to find what consumes a network.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -28,44 +29,47 @@ function registerNetworkTools(server, client, readOnly = false) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listNetworksOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites/${siteId}/networks${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_get_network", {
-        description: "Get a specific network by ID",
+        description: "Get a network/VLAN by ID. Returns the list fields PLUS (live-verified) zoneId, isolationEnabled, internetAccessEnabled, mdnsForwardingEnabled, cellularBackupEnabled, and a full ipv4Configuration object (hostIpAddress, prefixLength, dhcpConfiguration with ipAddressRange/leaseTimeSeconds/domainName/ntpServerIpAddresses). NOTE: subnet/DHCP detail appears here at get-by-id but NOT in unifi_list_networks (sparse list view).",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             networkId: zod_1.z.string().describe("Network ID"),
         },
+        outputSchema: output_schemas_js_1.networkOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, networkId }) => {
         try {
             const data = await client.get(`/sites/${siteId}/networks/${networkId}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_get_network_references", {
-        description: "Get references to a network (what WiFi broadcasts, firewall zones, etc. use this network)",
+        description: "Get all objects that reference this network (WiFi broadcasts, firewall zones, etc.). Returns: { referenceResources: [...] }. Use before deleting a network to find dependencies that need to be re-pointed or removed.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             networkId: zod_1.z.string().describe("Network ID"),
         },
+        outputSchema: output_schemas_js_1.getNetworkReferencesOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, networkId }) => {
         try {
             const data = await client.get(`/sites/${siteId}/networks/${networkId}/references`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
@@ -74,7 +78,7 @@ function registerNetworkTools(server, client, readOnly = false) {
     if (readOnly)
         return;
     server.registerTool("unifi_create_network", {
-        description: "Create a new network",
+        description: "Create a new VLAN/network. management=GATEWAY means routed via UDM/UXG; SWITCH means VLAN-only; UNMANAGED means external. Idempotency: not safe to retry — re-running creates duplicates.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             name: zod_1.z.string().describe("Network name"),
@@ -97,6 +101,7 @@ function registerNetworkTools(server, client, readOnly = false) {
                 .optional()
                 .describe("Preview this action without executing it"),
         },
+        outputSchema: output_schemas_js_1.networkOutputSchema,
         annotations: safety_js_1.WRITE_NOT_IDEMPOTENT,
     }, async ({ siteId, name, management, enabled, vlanId, dhcpGuarding, dryRun }) => {
         try {
@@ -106,7 +111,7 @@ function registerNetworkTools(server, client, readOnly = false) {
             if (dryRun)
                 return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/networks`, body);
             const data = await client.post(`/sites/${siteId}/networks`, body);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
@@ -137,6 +142,7 @@ function registerNetworkTools(server, client, readOnly = false) {
                 .optional()
                 .describe("Preview this action without executing it"),
         },
+        outputSchema: output_schemas_js_1.networkOutputSchema,
         annotations: safety_js_1.WRITE,
     }, async ({ siteId, networkId, name, management, enabled, vlanId, dhcpGuarding, dryRun }) => {
         try {
@@ -146,7 +152,7 @@ function registerNetworkTools(server, client, readOnly = false) {
             if (dryRun)
                 return (0, safety_js_1.formatDryRun)("PUT", `/sites/${siteId}/networks/${networkId}`, body);
             const data = await client.put(`/sites/${siteId}/networks/${networkId}`, body);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);

package/dist/tools/sites.js

@@ -5,9 +5,10 @@ const zod_1 = require("zod");
 const responses_js_1 = require("../utils/responses.js");
 const query_js_1 = require("../utils/query.js");
 const safety_js_1 = require("../utils/safety.js");
+const output_schemas_js_1 = require("../utils/output-schemas.js");
 function registerSiteTools(server, client) {
     server.registerTool("unifi_list_sites", {
-        description: "List all sites available to the API key",
+        description: "List all sites the API key has access to. Returns: id (the siteId every other tool requires), internalReference, name. Use for: first call in any workflow — almost every other tool needs a siteId.",
         inputSchema: {
             offset: zod_1.z
                 .number()
@@ -27,12 +28,13 @@ function registerSiteTools(server, client) {
                 .optional()
                 .describe("Filter expression (e.g., 'name.like(office*)')"),
         },
+        outputSchema: output_schemas_js_1.listSitesOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);

package/dist/tools/supporting.js

@@ -5,9 +5,10 @@ const zod_1 = require("zod");
 const responses_js_1 = require("../utils/responses.js");
 const query_js_1 = require("../utils/query.js");
 const safety_js_1 = require("../utils/safety.js");
+const output_schemas_js_1 = require("../utils/output-schemas.js");
 function registerSupportingTools(server, client) {
     server.registerTool("unifi_list_wans", {
-        description: "List all WAN interfaces at a site",
+        description: "List WAN interface definitions at a site. Returns: id, name only (verified against 10.4.55 — the Integration API exposes no live link status or throughput rates here). Use for: WAN inventory, multi-WAN topology.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -24,19 +25,20 @@ function registerSupportingTools(server, client) {
                 .optional()
                 .describe("Number of records to return (default: 25, max: 200)"),
         },
+        outputSchema: output_schemas_js_1.listWansOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit });
             const data = await client.get(`/sites/${siteId}/wans${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_list_vpn_tunnels", {
-        description: "List all site-to-site VPN tunnels at a site",
+        description: "List site-to-site VPN tunnels (IPsec, WireGuard, OpenVPN site-to-site) at a site. Returns: tunnel definitions per row (per-row schema not rendered in 10.4.55 docs — call to inspect). For roaming client VPN servers, see unifi_list_vpn_servers.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -57,19 +59,20 @@ function registerSupportingTools(server, client) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listVpnTunnelsOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites/${siteId}/vpn/site-to-site-tunnels${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_list_vpn_servers", {
-        description: "List all VPN servers at a site",
+        description: "List VPN servers (roaming/client-access VPNs: WireGuard, OpenVPN, L2TP, Teleport) at a site. Returns: id, type (e.g. WIREGUARD, UID), name, enabled, metadata.origin.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -90,19 +93,20 @@ function registerSupportingTools(server, client) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listVpnServersOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites/${siteId}/vpn/servers${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_list_radius_profiles", {
-        description: "List all RADIUS profiles at a site",
+        description: "List RADIUS profiles (auth/accounting server configurations referenced by WiFi WPA-Enterprise, switch 802.1X port auth, VPN). Returns: id, name, metadata (origin, configurable).",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -123,19 +127,20 @@ function registerSupportingTools(server, client) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listRadiusProfilesOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites/${siteId}/radius/profiles${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_list_device_tags", {
-        description: "List all device tags at a site (used for WiFi broadcast assignments)",
+        description: "List device tags at a site. Tags group APs/switches for selective WiFi broadcast (via broadcastingDeviceFilter on a WiFi network). Returns: id, name, deviceIds[].",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -156,19 +161,20 @@ function registerSupportingTools(server, client) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listDeviceTagsOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites/${siteId}/device-tags${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_list_dpi_categories", {
-        description: "List all DPI (Deep Packet Inspection) categories for traffic identification",
+        description: "List DPI categories (global, not site-scoped) — high-level traffic groupings like 'Streaming', 'Social Networks', 'Gaming'. Returns: id (numeric), name. Use the category id when building firewall policies that match by category.",
         inputSchema: {
             offset: zod_1.z
                 .number()
@@ -188,19 +194,20 @@ function registerSupportingTools(server, client) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listDpiCategoriesOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/dpi/categories${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_list_dpi_applications", {
-        description: "List all DPI applications for traffic identification and filtering",
+        description: "List individual DPI applications (global) — specific apps/services like 'Netflix', 'Zoom', 'Steam'. Returns: id (numeric), name. More granular than unifi_list_dpi_categories.",
         inputSchema: {
             offset: zod_1.z
                 .number()
@@ -220,19 +227,20 @@ function registerSupportingTools(server, client) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listDpiApplicationsOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/dpi/applications${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_list_countries", {
-        description: "List all countries/regions for geo-based rules (ISO codes and names)",
+        description: "List countries/regions (global) for geo-IP firewall rules. Returns: code (ISO alpha-2, e.g. 'US'), name. Use the code when building firewall policies that match by source/destination country.",
         inputSchema: {
             offset: zod_1.z
                 .number()
@@ -252,12 +260,13 @@ function registerSupportingTools(server, client) {
                 .optional()
                 .describe("Filter expression (e.g., 'name.like(United*)')"),
         },
+        outputSchema: output_schemas_js_1.listCountriesOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/countries${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);

package/dist/tools/switching.js

@@ -5,9 +5,10 @@ const zod_1 = require("zod");
 const responses_js_1 = require("../utils/responses.js");
 const query_js_1 = require("../utils/query.js");
 const safety_js_1 = require("../utils/safety.js");
+const output_schemas_js_1 = require("../utils/output-schemas.js");
 function registerSwitchingTools(server, client) {
     server.registerTool("unifi_list_switch_stacks", {
-        description: "List all Switch Stacks at a site",
+        description: "List Switch Stacks (multiple physical switches managed as one logical unit) at a site. Returns: id, name, members[], lags[] (LAGs spanning the stack), metadata.origin. Use for: identifying stacked switches; individual member configs/stats still come from unifi_get_device.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -28,35 +29,37 @@ function registerSwitchingTools(server, client) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listSwitchStacksOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites/${siteId}/switching/switch-stacks${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_get_switch_stack", {
-        description: "Get details of a specific Switch Stack",
+        description: "Get full details of a Switch Stack including all members and stacking topology. Returns the same fields as the list response but for a single stack.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             switchStackId: zod_1.z.string().describe("Switch Stack ID"),
         },
+        outputSchema: output_schemas_js_1.switchStackOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, switchStackId }) => {
         try {
             const data = await client.get(`/sites/${siteId}/switching/switch-stacks/${switchStackId}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_list_mc_lag_domains", {
-        description: "List all MC-LAG (Multi-Chassis LAG) Domains at a site",
+        description: "List MC-LAG (Multi-Chassis Link Aggregation) Domains — pairs of switches presenting as one for LAG redundancy. Returns: id, name, peers[], lags[] (LAGs spanning the domain), metadata.origin.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -77,35 +80,37 @@ function registerSwitchingTools(server, client) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listMcLagDomainsOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites/${siteId}/switching/mc-lag-domains${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_get_mc_lag_domain", {
-        description: "Get details of a specific MC-LAG (Multi-Chassis LAG) Domain",
+        description: "Get full details of an MC-LAG Domain (peer switches and member LAGs).",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             mcLagDomainId: zod_1.z.string().describe("MC-LAG Domain ID"),
         },
+        outputSchema: output_schemas_js_1.mcLagDomainOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, mcLagDomainId }) => {
         try {
             const data = await client.get(`/sites/${siteId}/switching/mc-lag-domains/${mcLagDomainId}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_list_lags", {
-        description: "List all LAGs (Link Aggregation Groups) at a site",
+        description: "List LAGs (Link Aggregation Groups — bonded switch ports) at a site. Returns: id, type (LOCAL/SWITCH_STACK/MULTI_CHASSIS), members[], metadata.origin.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -126,28 +131,30 @@ function registerSwitchingTools(server, client) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listLagsOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites/${siteId}/switching/lags${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_get_lag", {
-        description: "Get details of a specific LAG (Link Aggregation Group)",
+        description: "Get full details of a LAG including its type (LOCAL/SWITCH_STACK/MULTI_CHASSIS) and member ports.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             lagId: zod_1.z.string().describe("LAG ID"),
         },
+        outputSchema: output_schemas_js_1.lagOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, lagId }) => {
         try {
             const data = await client.get(`/sites/${siteId}/switching/lags/${lagId}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);

package/dist/tools/system.js

@@ -3,15 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerSystemTools = registerSystemTools;
 const responses_js_1 = require("../utils/responses.js");
 const safety_js_1 = require("../utils/safety.js");
+const output_schemas_js_1 = require("../utils/output-schemas.js");
 function registerSystemTools(server, client) {
     server.registerTool("unifi_get_info", {
-        description: "Get application information including version and whether it's a UniFi OS Console",
+        description: "Get UniFi Network application info. Returns: applicationVersion. NOTE: verified against 10.4.55 on a UniFi OS console — the Integration API returns ONLY applicationVersion here; there is no isUniFiOSConsole or other field. Use for: version checks before calling version-gated tools.",
         inputSchema: {},
+        outputSchema: output_schemas_js_1.getInfoOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async () => {
         try {
             const data = await client.get("/info");
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);

package/dist/tools/traffic-matching.js

@@ -5,9 +5,10 @@ const zod_1 = require("zod");
 const responses_js_1 = require("../utils/responses.js");
 const query_js_1 = require("../utils/query.js");
 const safety_js_1 = require("../utils/safety.js");
+const output_schemas_js_1 = require("../utils/output-schemas.js");
 function registerTrafficMatchingTools(server, client, readOnly = false) {
     server.registerTool("unifi_list_traffic_matching_lists", {
-        description: "List all traffic matching lists at a site (port groups, IP groups)",
+        description: "List traffic matching lists at a site — named collections of ports or IPs reused in firewall/ACL rules. Returns: id, type (PORTS/IPV4_ADDRESSES/IPV6_ADDRESSES), name, items[]. Use for: finding the matching-list ID to reference from a firewall policy.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -28,28 +29,30 @@ function registerTrafficMatchingTools(server, client, readOnly = false) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listTrafficMatchingListsOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites/${siteId}/traffic-matching-lists${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_get_traffic_matching_list", {
-        description: "Get a specific traffic matching list by ID",
+        description: "Get a specific traffic matching list by ID (full items array).",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             trafficMatchingListId: zod_1.z.string().describe("Traffic matching list ID"),
         },
+        outputSchema: output_schemas_js_1.trafficMatchingListOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, trafficMatchingListId }) => {
         try {
             const data = await client.get(`/sites/${siteId}/traffic-matching-lists/${trafficMatchingListId}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
@@ -74,6 +77,7 @@ function registerTrafficMatchingTools(server, client, readOnly = false) {
                 .optional()
                 .describe("Preview this action without executing it"),
         },
+        outputSchema: output_schemas_js_1.trafficMatchingListOutputSchema,
         annotations: safety_js_1.WRITE_NOT_IDEMPOTENT,
     }, async ({ siteId, type, name, items, dryRun }) => {
         try {
@@ -81,7 +85,7 @@ function registerTrafficMatchingTools(server, client, readOnly = false) {
             if (dryRun)
                 return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/traffic-matching-lists`, body);
             const data = await client.post(`/sites/${siteId}/traffic-matching-lists`, body);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
@@ -102,6 +106,7 @@ function registerTrafficMatchingTools(server, client, readOnly = false) {
                 .optional()
                 .describe("Preview this action without executing it"),
         },
+        outputSchema: output_schemas_js_1.trafficMatchingListOutputSchema,
         annotations: safety_js_1.WRITE,
     }, async ({ siteId, trafficMatchingListId, type, name, items, dryRun }) => {
         try {
@@ -109,7 +114,7 @@ function registerTrafficMatchingTools(server, client, readOnly = false) {
             if (dryRun)
                 return (0, safety_js_1.formatDryRun)("PUT", `/sites/${siteId}/traffic-matching-lists/${trafficMatchingListId}`, body);
             const data = await client.put(`/sites/${siteId}/traffic-matching-lists/${trafficMatchingListId}`, body);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);

package/dist/tools/wifi.js

@@ -5,9 +5,10 @@ const zod_1 = require("zod");
 const responses_js_1 = require("../utils/responses.js");
 const query_js_1 = require("../utils/query.js");
 const safety_js_1 = require("../utils/safety.js");
+const output_schemas_js_1 = require("../utils/output-schemas.js");
 function registerWifiTools(server, client, readOnly = false) {
     server.registerTool("unifi_list_wifi", {
-        description: "List all WiFi broadcasts (SSIDs) at a site",
+        description: "List all WiFi broadcasts (SSIDs) at a site. Returns: id, name (SSID), enabled, type (STANDARD/IOT_OPTIMIZED), broadcastingFrequenciesGHz (2.4/5/6), securityConfiguration, hideName, bandSteeringEnabled, mloEnabled, network reference, broadcastingDeviceFilter (which APs broadcast it). Use for: SSID inventory. For per-AP radio state (channel, txPower), use unifi_get_device on the AP.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             offset: zod_1.z
@@ -28,28 +29,30 @@ function registerWifiTools(server, client, readOnly = false) {
                 .optional()
                 .describe("Filter expression"),
         },
+        outputSchema: output_schemas_js_1.listWifiOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, offset, limit, filter }) => {
         try {
             const query = (0, query_js_1.buildQuery)({ offset, limit, filter });
             const data = await client.get(`/sites/${siteId}/wifi/broadcasts${query}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
         }
     });
     server.registerTool("unifi_get_wifi", {
-        description: "Get a specific WiFi network by ID",
+        description: "Get full configuration for a WiFi broadcast (SSID), including all optional fields not always returned by list: clientFilteringPolicy, blackoutScheduleConfiguration, hotspotConfiguration, mdnsProxyConfiguration, handoffSuggestionsConfiguration, dtimPeriodByFrequencyGHzOverride, etc.",
         inputSchema: {
             siteId: zod_1.z.string().describe("Site ID"),
             wifiBroadcastId: zod_1.z.string().describe("WiFi Broadcast ID"),
         },
+        outputSchema: output_schemas_js_1.getWifiOutputSchema,
         annotations: safety_js_1.READ_ONLY,
     }, async ({ siteId, wifiBroadcastId }) => {
         try {
             const data = await client.get(`/sites/${siteId}/wifi/broadcasts/${wifiBroadcastId}`);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
@@ -150,6 +153,7 @@ function registerWifiTools(server, client, readOnly = false) {
                 .optional()
                 .describe("Preview this action without executing it"),
         },
+        outputSchema: output_schemas_js_1.getWifiOutputSchema,
         annotations: safety_js_1.WRITE_NOT_IDEMPOTENT,
     }, 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 {
@@ -198,7 +202,7 @@ function registerWifiTools(server, client, readOnly = false) {
             if (dryRun)
                 return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/wifi/broadcasts`, body);
             const data = await client.post(`/sites/${siteId}/wifi/broadcasts`, body);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);
@@ -313,6 +317,7 @@ function registerWifiTools(server, client, readOnly = false) {
                 .optional()
                 .describe("Preview this action without executing it"),
         },
+        outputSchema: output_schemas_js_1.getWifiOutputSchema,
         annotations: safety_js_1.WRITE,
     }, 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 {
@@ -375,7 +380,7 @@ function registerWifiTools(server, client, readOnly = false) {
             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);
-            return (0, responses_js_1.formatSuccess)(data);
+            return (0, responses_js_1.formatSuccess)(data, { structured: true });
         }
         catch (err) {
             return (0, responses_js_1.formatError)(err);