@owine/unifi-network-mcp 0.9.0

package/dist/tools/hotspot.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHotspotTools = registerHotspotTools;
+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");
+function registerHotspotTools(server, client, readOnly = false) {
+    server.tool("unifi_list_vouchers", "List all hotspot vouchers at a site", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .default(0)
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .optional()
+            .default(100)
+            .describe("Number of records to return (default: 100, max: 1000)"),
+        filter: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter expression (e.g., 'expired.eq(true)')"),
+    }, 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}/hotspot/vouchers${query}`);
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_get_voucher", "Get a specific hotspot voucher by ID", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        voucherId: zod_1.z.string().describe("Voucher ID"),
+    }, safety_js_1.READ_ONLY, async ({ siteId, voucherId }) => {
+        try {
+            const data = await client.get(`/sites/${siteId}/hotspot/vouchers/${voucherId}`);
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    if (readOnly)
+        return;
+    server.tool("unifi_create_voucher", "Create hotspot vouchers", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        name: zod_1.z
+            .string()
+            .describe("Voucher note/name (duplicated across all generated vouchers)"),
+        timeLimitMinutes: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(1000000)
+            .describe("How long the voucher provides access (1-1000000 minutes)"),
+        count: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .optional()
+            .default(1)
+            .describe("Number of vouchers to create (1-1000, default: 1)"),
+        authorizedGuestLimit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe("How many guests can use this voucher"),
+        dataUsageLimitMBytes: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(1048576)
+            .optional()
+            .describe("Data usage limit in megabytes (1-1048576)"),
+        rxRateLimitKbps: zod_1.z
+            .number()
+            .int()
+            .min(2)
+            .max(100000)
+            .optional()
+            .describe("Download rate limit in kbps (2-100000)"),
+        txRateLimitKbps: zod_1.z
+            .number()
+            .int()
+            .min(2)
+            .max(100000)
+            .optional()
+            .describe("Upload rate limit in kbps (2-100000)"),
+        dryRun: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Preview this action without executing it"),
+    }, safety_js_1.WRITE_NOT_IDEMPOTENT, async ({ siteId, name, timeLimitMinutes, count, authorizedGuestLimit, dataUsageLimitMBytes, rxRateLimitKbps, txRateLimitKbps, dryRun, }) => {
+        try {
+            const body = {
+                name,
+                timeLimitMinutes,
+            };
+            if (count !== undefined)
+                body.count = count;
+            if (authorizedGuestLimit !== undefined)
+                body.authorizedGuestLimit = authorizedGuestLimit;
+            if (dataUsageLimitMBytes !== undefined)
+                body.dataUsageLimitMBytes = dataUsageLimitMBytes;
+            if (rxRateLimitKbps !== undefined)
+                body.rxRateLimitKbps = rxRateLimitKbps;
+            if (txRateLimitKbps !== undefined)
+                body.txRateLimitKbps = txRateLimitKbps;
+            if (dryRun)
+                return (0, safety_js_1.formatDryRun)("POST", `/sites/${siteId}/hotspot/vouchers`, body);
+            const data = await client.post(`/sites/${siteId}/hotspot/vouchers`, body);
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_delete_voucher", "DESTRUCTIVE: Delete a hotspot voucher", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        voucherId: zod_1.z.string().describe("Voucher ID"),
+        confirm: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Must be true to execute this destructive action"),
+        dryRun: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Preview this action without executing it"),
+    }, safety_js_1.DESTRUCTIVE, async ({ siteId, voucherId, confirm, dryRun }) => {
+        const guard = (0, safety_js_1.requireConfirmation)(confirm, "This will permanently delete the voucher");
+        if (guard)
+            return guard;
+        try {
+            const path = `/sites/${siteId}/hotspot/vouchers/${voucherId}`;
+            if (dryRun)
+                return (0, safety_js_1.formatDryRun)("DELETE", path);
+            const data = await client.delete(path);
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_bulk_delete_vouchers", "DESTRUCTIVE: Bulk delete hotspot vouchers based on filter criteria", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        filter: zod_1.z
+            .string()
+            .describe("Required filter expression (e.g., 'expired.eq(true)', 'name.like(guest*)')"),
+        confirm: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Must be true to execute this destructive action"),
+        dryRun: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Preview this action without executing it"),
+    }, safety_js_1.DESTRUCTIVE, async ({ siteId, filter, confirm, dryRun }) => {
+        try {
+            const guard = (0, safety_js_1.requireConfirmation)(confirm, "This will delete all vouchers matching the filter");
+            if (guard)
+                return guard;
+            const query = (0, query_js_1.buildQuery)({ filter });
+            const path = `/sites/${siteId}/hotspot/vouchers${query}`;
+            if (dryRun)
+                return (0, safety_js_1.formatDryRun)("DELETE", path);
+            const data = await client.delete(path);
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { NetworkClient } from "../client.js";
+export declare function registerAllTools(server: McpServer, client: NetworkClient, readOnly?: boolean): void;

package/dist/tools/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAllTools = registerAllTools;
+const system_js_1 = require("./system.js");
+const sites_js_1 = require("./sites.js");
+const devices_js_1 = require("./devices.js");
+const clients_js_1 = require("./clients.js");
+const networks_js_1 = require("./networks.js");
+const wifi_js_1 = require("./wifi.js");
+const hotspot_js_1 = require("./hotspot.js");
+const firewall_js_1 = require("./firewall.js");
+const acl_js_1 = require("./acl.js");
+const dns_policies_js_1 = require("./dns-policies.js");
+const traffic_matching_js_1 = require("./traffic-matching.js");
+const supporting_js_1 = require("./supporting.js");
+function registerAllTools(server, client, readOnly = false) {
+    (0, system_js_1.registerSystemTools)(server, client);
+    (0, sites_js_1.registerSiteTools)(server, client);
+    (0, devices_js_1.registerDeviceTools)(server, client, readOnly);
+    (0, clients_js_1.registerClientTools)(server, client, readOnly);
+    (0, networks_js_1.registerNetworkTools)(server, client, readOnly);
+    (0, wifi_js_1.registerWifiTools)(server, client, readOnly);
+    (0, hotspot_js_1.registerHotspotTools)(server, client, readOnly);
+    (0, firewall_js_1.registerFirewallTools)(server, client, readOnly);
+    (0, acl_js_1.registerAclTools)(server, client, readOnly);
+    (0, dns_policies_js_1.registerDnsPolicyTools)(server, client, readOnly);
+    (0, traffic_matching_js_1.registerTrafficMatchingTools)(server, client, readOnly);
+    (0, supporting_js_1.registerSupportingTools)(server, client);
+}

package/dist/tools/networks.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { NetworkClient } from "../client.js";
+export declare function registerNetworkTools(server: McpServer, client: NetworkClient, readOnly?: boolean): void;

package/dist/tools/networks.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerNetworkTools = registerNetworkTools;
+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");
+function registerNetworkTools(server, client, readOnly = false) {
+    server.tool("unifi_list_networks", "List all networks at a site", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Number of records to return (default: 25, max: 200)"),
+        filter: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter expression"),
+    }, 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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_get_network", "Get a specific network by ID", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        networkId: zod_1.z.string().describe("Network ID"),
+    }, 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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_get_network_references", "Get references to a network (what WiFi broadcasts, firewall zones, etc. use this network)", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        networkId: zod_1.z.string().describe("Network ID"),
+    }, 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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    if (readOnly)
+        return;
+    server.tool("unifi_create_network", "Create a new network", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        name: zod_1.z.string().describe("Network name"),
+        management: zod_1.z
+            .enum(["UNMANAGED", "GATEWAY", "SWITCH"])
+            .describe("Network management type"),
+        enabled: zod_1.z.boolean().describe("Enable the network"),
+        vlanId: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(4009)
+            .describe("VLAN ID (1 for default, 2+ for additional)"),
+        dryRun: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Preview this action without executing it"),
+    }, safety_js_1.WRITE_NOT_IDEMPOTENT, async ({ siteId, name, management, enabled, vlanId, dryRun }) => {
+        try {
+            const body = { name, management, enabled, vlanId };
+            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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_update_network", "Update an existing network", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        networkId: zod_1.z.string().describe("Network ID"),
+        name: zod_1.z.string().describe("Network name"),
+        management: zod_1.z
+            .enum(["UNMANAGED", "GATEWAY", "SWITCH"])
+            .describe("Network management type"),
+        enabled: zod_1.z.boolean().describe("Enable the network"),
+        vlanId: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(4009)
+            .describe("VLAN ID (1-4009)"),
+        dryRun: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Preview this action without executing it"),
+    }, safety_js_1.WRITE, async ({ siteId, networkId, name, management, enabled, vlanId, dryRun }) => {
+        try {
+            const body = { name, management, enabled, vlanId };
+            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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_delete_network", "DESTRUCTIVE: Delete a network — all clients on this network will be disconnected", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        networkId: zod_1.z.string().describe("Network ID"),
+        force: zod_1.z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Force delete (default: false)"),
+        confirm: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Must be true to execute this destructive action"),
+        dryRun: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Preview this action without executing it"),
+    }, safety_js_1.DESTRUCTIVE, async ({ siteId, networkId, force, confirm, dryRun }) => {
+        const guard = (0, safety_js_1.requireConfirmation)(confirm, "This will delete the network and disconnect all clients on it");
+        if (guard)
+            return guard;
+        try {
+            let path = `/sites/${siteId}/networks/${networkId}`;
+            if (force) {
+                path += "?force=true";
+            }
+            if (dryRun)
+                return (0, safety_js_1.formatDryRun)("DELETE", path);
+            const data = await client.delete(path);
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+}

package/dist/tools/sites.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { NetworkClient } from "../client.js";
+export declare function registerSiteTools(server: McpServer, client: NetworkClient): void;

package/dist/tools/sites.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSiteTools = registerSiteTools;
+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");
+function registerSiteTools(server, client) {
+    server.tool("unifi_list_sites", "List all sites available to the API key", {
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Number of records to return (default: 25, max: 200)"),
+        filter: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter expression (e.g., 'name.like(office*)')"),
+    }, 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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+}

package/dist/tools/supporting.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { NetworkClient } from "../client.js";
+export declare function registerSupportingTools(server: McpServer, client: NetworkClient): void;

package/dist/tools/supporting.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSupportingTools = registerSupportingTools;
+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");
+function registerSupportingTools(server, client) {
+    server.tool("unifi_list_wans", "List all WAN interfaces at a site", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Number of records to return (default: 25, max: 200)"),
+    }, 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}/wan-interfaces${query}`);
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_list_vpn_tunnels", "List all site-to-site VPN tunnels at a site", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Number of records to return (default: 25, max: 200)"),
+        filter: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter expression"),
+    }, 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-tunnels${query}`);
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_list_vpn_servers", "List all VPN servers at a site", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Number of records to return (default: 25, max: 200)"),
+        filter: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter expression"),
+    }, 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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_list_radius_profiles", "List all RADIUS profiles at a site", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Number of records to return (default: 25, max: 200)"),
+        filter: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter expression"),
+    }, 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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_list_device_tags", "List all device tags at a site (used for WiFi broadcast assignments)", {
+        siteId: zod_1.z.string().describe("Site ID"),
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Number of records to return (default: 25, max: 200)"),
+        filter: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter expression"),
+    }, 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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_list_dpi_categories", "List all DPI (Deep Packet Inspection) categories for traffic identification", {
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Number of records to return (default: 25, max: 200)"),
+        filter: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter expression"),
+    }, 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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_list_dpi_applications", "List all DPI applications for traffic identification and filtering", {
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Number of records to return (default: 25, max: 200)"),
+        filter: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter expression"),
+    }, 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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+    server.tool("unifi_list_countries", "List all countries/regions for geo-based rules (ISO codes and names)", {
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Number of records to skip (default: 0)"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Number of records to return (default: 25, max: 200)"),
+        filter: zod_1.z
+            .string()
+            .optional()
+            .describe("Filter expression (e.g., 'name.like(United*)')"),
+    }, 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);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+}

package/dist/tools/system.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { NetworkClient } from "../client.js";
+export declare function registerSystemTools(server: McpServer, client: NetworkClient): void;

package/dist/tools/system.js

@@ -0,0 +1,16 @@
+"use strict";
+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");
+function registerSystemTools(server, client) {
+    server.tool("unifi_get_info", "Get application information including version and whether it's a UniFi OS Console", {}, safety_js_1.READ_ONLY, async () => {
+        try {
+            const data = await client.get("/info");
+            return (0, responses_js_1.formatSuccess)(data);
+        }
+        catch (err) {
+            return (0, responses_js_1.formatError)(err);
+        }
+    });
+}