@mseep/safe-omada-mcp 0.17.0

package/dist/tools/setApConfig.js

@@ -0,0 +1,189 @@
+import { z } from 'zod';
+import { deviceMacSchema, siteInputSchema, wrapMutationToolHandler } from '../server/common.js';
+const apConfigTypeSchema = z.enum([
+    'general-config',
+    'ip-setting',
+    'ipv6-setting',
+    'qos',
+    'radio-config',
+    'service-config',
+    'load-balance',
+    'ofdma',
+    'trunk-setting',
+    'bridge',
+    'wlan-group',
+    'port-config',
+    'channel-config',
+    'afc-config',
+    'antenna-gain',
+]);
+const nonEmptyRecordSchema = z.record(z.string(), z.unknown()).superRefine((value, ctx) => {
+    if (Object.keys(value).length === 0) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'payload must include at least one field.',
+        });
+    }
+});
+const serviceConfigPayloadSchema = nonEmptyRecordSchema;
+const wlanGroupPayloadSchema = nonEmptyRecordSchema.superRefine((value, ctx) => {
+    const hasWlanId = typeof value['wlanId'] === 'string' && value['wlanId'].trim().length > 0;
+    const hasWlanIds = Array.isArray(value['wlanIds']) && value['wlanIds'].length > 0;
+    if (!hasWlanId && !hasWlanIds) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'wlan-group payload must include wlanId or wlanIds.',
+        });
+    }
+});
+const channelConfigPayloadSchema = nonEmptyRecordSchema;
+const inputSchema = siteInputSchema.extend({
+    apMac: deviceMacSchema.describe('MAC address of the access point to update.'),
+    configType: apConfigTypeSchema.describe('Documented AP configuration family to update through the official Omada Open API.'),
+    payload: z.record(z.string(), z.unknown()).describe('Configuration payload that matches the selected AP configType in the Omada Open API.'),
+    dryRun: z.boolean().optional().default(false).describe('If true, validate the AP and return the planned update without applying it.'),
+});
+function parseApPayload(configType, payload) {
+    switch (configType) {
+        case 'service-config':
+            return serviceConfigPayloadSchema.parse(payload);
+        case 'wlan-group':
+            return wlanGroupPayloadSchema.parse(payload);
+        case 'channel-config':
+            return channelConfigPayloadSchema.parse(payload);
+        default:
+            return z.record(z.string(), z.unknown()).parse(payload);
+    }
+}
+function hasReadback(configType) {
+    return !['service-config', 'wlan-group', 'channel-config'].includes(configType);
+}
+async function validateApConfigCapability(client, configType, apMac, payload, siteId, customHeaders) {
+    if (configType !== 'channel-config') {
+        return;
+    }
+    const availableChannels = (await client.getSitesApsAvailableChannel(apMac, siteId, customHeaders));
+    if (Object.keys(availableChannels).length === 0) {
+        throw new Error(`AP ${apMac} does not expose available channel data for channel-config validation.`);
+    }
+    const payloadText = JSON.stringify(payload);
+    if (!payloadText || payloadText === '{}') {
+        throw new Error('channel-config payload must include at least one channel-related field.');
+    }
+}
+async function getDeviceSummary(client, apMac, siteId, customHeaders) {
+    const device = await client.getDevice(apMac, siteId, customHeaders);
+    if (!device) {
+        throw new Error(`AP ${apMac} was not found in the selected site.`);
+    }
+    return device;
+}
+async function getCurrentApConfig(client, configType, apMac, siteId, customHeaders) {
+    switch (configType) {
+        case 'general-config':
+            return await client.getApGeneralConfig(apMac, siteId, customHeaders);
+        case 'ip-setting':
+            return await client.getSitesApsIpSetting(apMac, siteId, customHeaders);
+        case 'ipv6-setting':
+            return await client.getApIpv6Config(apMac, siteId, customHeaders);
+        case 'qos':
+            return await client.getApQosConfig(apMac, siteId, customHeaders);
+        case 'radio-config':
+            return await client.getRadiosConfig(apMac, siteId, customHeaders);
+        case 'load-balance':
+            return await client.getSitesApsLoadBalance(apMac, siteId, customHeaders);
+        case 'ofdma':
+            return await client.getSitesApsOfdma(apMac, siteId, customHeaders);
+        case 'trunk-setting':
+            return await client.getSitesApsTrunkSetting(apMac, siteId, customHeaders);
+        case 'bridge':
+            return await client.getSitesApsBridge(apMac, siteId, customHeaders);
+        case 'port-config':
+            return await client.listSitesApsPorts(apMac, siteId, customHeaders);
+        case 'afc-config':
+            return await client.getAfcConfig(apMac, siteId, customHeaders);
+        case 'antenna-gain':
+            return await client.getAntennaGainConfig(apMac, siteId, customHeaders);
+        default:
+            return null;
+    }
+}
+async function applyApConfig(client, configType, apMac, payload, siteId, customHeaders) {
+    switch (configType) {
+        case 'general-config':
+            return await client.setApGeneralConfig(apMac, payload, siteId, customHeaders);
+        case 'ip-setting':
+            return await client.setSitesApsIpSetting(apMac, payload, siteId, customHeaders);
+        case 'ipv6-setting':
+            return await client.setApIpv6Config(apMac, payload, siteId, customHeaders);
+        case 'qos':
+            return await client.setApQosConfig(apMac, payload, siteId, customHeaders);
+        case 'radio-config':
+            return await client.setRadiosConfig(apMac, payload, siteId, customHeaders);
+        case 'service-config':
+            return await client.setApServiceConfig(apMac, payload, siteId, customHeaders);
+        case 'load-balance':
+            return await client.setSitesApsLoadBalance(apMac, payload, siteId, customHeaders);
+        case 'ofdma':
+            return await client.setSitesApsOfdma(apMac, payload, siteId, customHeaders);
+        case 'trunk-setting':
+            return await client.setSitesApsTrunkSetting(apMac, payload, siteId, customHeaders);
+        case 'bridge':
+            return await client.setSitesApsBridge(apMac, payload, siteId, customHeaders);
+        case 'wlan-group':
+            return await client.setApWlanGroup(apMac, payload, siteId, customHeaders);
+        case 'port-config':
+            return await client.setSitesApsPortConfig(apMac, payload, siteId, customHeaders);
+        case 'channel-config':
+            return await client.setApChannelConfig(apMac, payload, siteId, customHeaders);
+        case 'afc-config':
+            return await client.setAfcConfig(apMac, payload, siteId, customHeaders);
+        case 'antenna-gain':
+            return await client.setAntennaGainConfig(apMac, payload, siteId, customHeaders);
+    }
+}
+export function registerSetApConfigTool(server, client) {
+    server.registerTool('setApConfig', {
+        description: 'Update a documented Omada AP configuration family with dry-run support. Covers general, IP, IPv6, QoS, radio, service, load-balance, OFDMA, trunk, bridge, WLAN group, port, channel, AFC, and antenna settings.',
+        inputSchema: inputSchema.shape,
+        annotations: {
+            destructiveHint: true,
+        },
+    }, wrapMutationToolHandler('setApConfig', ({ apMac, configType, siteId }, result, mode) => ({
+        action: 'set-ap-config',
+        target: apMac,
+        siteId,
+        mode,
+        status: mode === 'dry-run' ? 'planned' : 'applied',
+        summary: mode === 'dry-run' ? `Planned ${configType} update for AP ${apMac}.` : `${configType} update requested for AP ${apMac}.`,
+        result,
+    }), async ({ apMac, configType, payload, siteId, customHeaders, dryRun }) => {
+        const resolvedConfigType = configType;
+        const parsedPayload = parseApPayload(resolvedConfigType, payload);
+        const device = await getDeviceSummary(client, apMac, siteId, customHeaders);
+        await validateApConfigCapability(client, resolvedConfigType, apMac, parsedPayload, siteId, customHeaders);
+        const beforeAvailable = hasReadback(resolvedConfigType);
+        const before = beforeAvailable ? await getCurrentApConfig(client, resolvedConfigType, apMac, siteId, customHeaders) : null;
+        if (dryRun) {
+            return {
+                accepted: true,
+                dryRun: true,
+                device,
+                configType: resolvedConfigType,
+                before,
+                beforeAvailable,
+                ...(beforeAvailable ? {} : { warning: 'Current controller state cannot be previewed for this config family before apply.' }),
+                plannedConfig: parsedPayload,
+            };
+        }
+        const result = await applyApConfig(client, resolvedConfigType, apMac, parsedPayload, siteId, customHeaders);
+        return {
+            device,
+            configType: resolvedConfigType,
+            before,
+            beforeAvailable,
+            applied: result,
+        };
+    }));
+}
+//# sourceMappingURL=setApConfig.js.map

package/dist/tools/setApConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setApConfig.js","sourceRoot":"","sources":["../../src/tools/setApConfig.ts"],"names":[],"mappings":"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"}

package/dist/tools/setApPowerSaving.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OmadaClient } from '../omadaClient/index.js';
+export declare function registerSetApPowerSavingTool(server: McpServer, client: OmadaClient): void;

package/dist/tools/setApPowerSaving.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { deviceMacSchema, siteInputSchema, wrapMutationToolHandler } from '../server/common.js';
+const baseInputSchema = siteInputSchema.extend({
+    apMac: deviceMacSchema.describe('MAC address of the access point to update.'),
+    timeEnable: z.boolean().describe('Enable or disable the time-based power saving schedule.'),
+    startTimeH: z.number().int().min(0).max(23).optional().describe('Schedule start hour, required when timeEnable is true.'),
+    startTimeM: z.number().int().min(0).max(59).optional().describe('Schedule start minute, required when timeEnable is true.'),
+    endTimeH: z.number().int().min(0).max(23).optional().describe('Schedule end hour, required when timeEnable is true.'),
+    endTimeM: z.number().int().min(0).max(59).optional().describe('Schedule end minute, required when timeEnable is true.'),
+    bandEnable: z.boolean().describe('Enable or disable idle-based band power saving.'),
+    bands: z.array(z.number().int().min(0).max(3)).optional().describe('Band ids for idle-based power saving: 0=2.4GHz, 1=5GHz, 2=5GHz-2, 3=6GHz.'),
+    idleDuration: z.number().int().min(60).max(1440).optional().describe('Idle duration in minutes, required when bandEnable is true.'),
+    dryRun: z.boolean().optional().default(false).describe('If true, validate and summarize the planned AP power-saving change without applying it.'),
+});
+const inputSchema = baseInputSchema.superRefine((value, ctx) => {
+    if (value.timeEnable) {
+        for (const field of ['startTimeH', 'startTimeM', 'endTimeH', 'endTimeM']) {
+            if (value[field] === undefined) {
+                ctx.addIssue({ code: z.ZodIssueCode.custom, path: [field], message: `${field} is required when timeEnable is true.` });
+            }
+        }
+    }
+    if (value.bandEnable) {
+        if (!value.bands || value.bands.length === 0) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, path: ['bands'], message: 'bands is required when bandEnable is true.' });
+        }
+        if (value.idleDuration === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['idleDuration'],
+                message: 'idleDuration is required when bandEnable is true.',
+            });
+        }
+    }
+});
+export function registerSetApPowerSavingTool(server, client) {
+    server.registerTool('setApPowerSaving', {
+        description: 'Update power saving settings for a specific Omada access point after checking feature support.',
+        inputSchema: baseInputSchema.shape,
+        annotations: {
+            destructiveHint: true,
+        },
+    }, wrapMutationToolHandler('setApPowerSaving', ({ apMac, siteId }, result, mode) => ({
+        action: 'set-ap-power-saving',
+        target: apMac,
+        siteId,
+        mode,
+        status: mode === 'dry-run' ? 'planned' : 'applied',
+        summary: mode === 'dry-run' ? `Planned AP power-saving update for ${apMac}.` : `AP power-saving update requested for ${apMac}.`,
+        result,
+    }), async (args) => {
+        const { apMac, siteId, customHeaders, dryRun } = inputSchema.parse(args);
+        const powerSavingPayload = {
+            timeEnable: args.timeEnable,
+            startTimeH: args.startTimeH,
+            startTimeM: args.startTimeM,
+            endTimeH: args.endTimeH,
+            endTimeM: args.endTimeM,
+            bandEnable: args.bandEnable,
+            bands: args.bands,
+            idleDuration: args.idleDuration,
+        };
+        const current = (await client.getSitesApsPowerSaving(apMac, siteId, customHeaders));
+        if (current.supportPowerSaving === false) {
+            throw new Error(`AP ${apMac} does not support power-saving configuration.`);
+        }
+        if (dryRun) {
+            return {
+                accepted: true,
+                dryRun: true,
+                before: current,
+                plannedConfig: powerSavingPayload,
+            };
+        }
+        return await client.setSitesApsPowerSaving(apMac, powerSavingPayload, siteId, customHeaders);
+    }));
+}
+//# sourceMappingURL=setApPowerSaving.js.map

package/dist/tools/setApPowerSaving.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setApPowerSaving.js","sourceRoot":"","sources":["../../src/tools/setApPowerSaving.ts"],"names":[],"mappings":"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"}

package/dist/tools/setAppControlRule.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OmadaClient } from '../omadaClient/index.js';
+export declare function registerSetAppControlRuleTool(server: McpServer, client: OmadaClient): void;

package/dist/tools/setAppControlRule.js

@@ -0,0 +1,38 @@
+import { wrapMutationToolHandler } from '../server/common.js';
+import { findGridRecordById, parseAppControlPayload, setAppControlRuleInputSchema } from './firewallTrafficShared.js';
+export function registerSetAppControlRuleTool(server, client) {
+    server.registerTool('setAppControlRule', {
+        description: 'Create or update an application control rule with dry-run preview support. Create uses the Omada AddRuleEntity schema; update uses the Omada EditRuleEntity schema.',
+        inputSchema: setAppControlRuleInputSchema.shape,
+        annotations: {
+            destructiveHint: true,
+        },
+    }, wrapMutationToolHandler('setAppControlRule', ({ ruleId, siteId }, result, mode) => ({
+        action: ruleId ? 'update-app-control-rule' : 'create-app-control-rule',
+        target: ruleId ?? siteId ?? 'default-site',
+        siteId,
+        mode,
+        status: mode === 'dry-run' ? 'planned' : 'applied',
+        summary: mode === 'dry-run' ? 'Planned application control rule mutation.' : 'Application control rule mutation requested.',
+        result,
+    }), async ({ ruleId, payload, dryRun, siteId, customHeaders }) => {
+        const parsedPayload = await parseAppControlPayload(client, ruleId, payload, siteId, customHeaders);
+        const existingRules = await client.getAppControlRules(1, 1000, siteId, customHeaders);
+        const before = ruleId ? findGridRecordById(existingRules, ruleId) : undefined;
+        if (ruleId && !before) {
+            throw new Error(`No application control rule exists for ${ruleId}.`);
+        }
+        if (dryRun) {
+            return {
+                accepted: true,
+                dryRun: true,
+                before,
+                plannedRule: parsedPayload,
+            };
+        }
+        return ruleId
+            ? await client.updateAppControlRule(ruleId, parsedPayload, siteId, customHeaders)
+            : await client.createAppControlRule(parsedPayload, siteId, customHeaders);
+    }));
+}
+//# sourceMappingURL=setAppControlRule.js.map

package/dist/tools/setAppControlRule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setAppControlRule.js","sourceRoot":"","sources":["../../src/tools/setAppControlRule.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAEtH,MAAM,UAAU,6BAA6B,CAAC,MAAiB,EAAE,MAAmB;IAChF,MAAM,CAAC,YAAY,CACf,mBAAmB,EACnB;QACI,WAAW,EACP,qKAAqK;QACzK,WAAW,EAAE,4BAA4B,CAAC,KAAK;QAC/C,WAAW,EAAE;YACT,eAAe,EAAE,IAAI;SACxB;KACJ,EACD,uBAAuB,CACnB,mBAAmB,EACnB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,yBAAyB;QACtE,MAAM,EAAE,MAAM,IAAI,MAAM,IAAI,cAAc;QAC1C,MAAM;QACN,IAAI;QACJ,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAClD,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,8CAA8C;QAC3H,MAAM;KACT,CAAC,EACF,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE;QACzD,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;QACnG,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE9E,IAAI,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,GAAG,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACT,OAAO;gBACH,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;gBACZ,MAAM;gBACN,WAAW,EAAE,aAAa;aAC7B,CAAC;QACN,CAAC;QAED,OAAO,MAAM;YACT,CAAC,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,CAAC;YACjF,CAAC,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IAClF,CAAC,CACJ,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/setBandwidthControlRule.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OmadaClient } from '../omadaClient/index.js';
+export declare function registerSetBandwidthControlRuleTool(server: McpServer, client: OmadaClient): void;

package/dist/tools/setBandwidthControlRule.js

@@ -0,0 +1,65 @@
+import { wrapMutationToolHandler } from '../server/common.js';
+import { bandwidthControlRulePayloadSchema, extractGridRecords, findGridRecordById, setBandwidthControlRuleInputSchema, validateBandwidthControlPayloadReferences, } from './firewallTrafficShared.js';
+export function registerSetBandwidthControlRuleTool(server, client) {
+    server.registerTool('setBandwidthControlRule', {
+        description: 'Create or update a bandwidth control rule with dry-run preview support using the official Omada Open API BandwidthControlRule schema.',
+        inputSchema: setBandwidthControlRuleInputSchema.shape,
+        annotations: {
+            destructiveHint: true,
+        },
+    }, wrapMutationToolHandler('setBandwidthControlRule', ({ ruleId, siteId }, result, mode) => ({
+        action: ruleId ? 'update-bandwidth-control-rule' : 'create-bandwidth-control-rule',
+        target: ruleId ?? siteId ?? 'default-site',
+        siteId,
+        mode,
+        status: mode === 'dry-run' ? 'planned' : 'applied',
+        summary: mode === 'dry-run' ? 'Planned bandwidth control rule mutation.' : 'Bandwidth control rule mutation requested.',
+        result,
+    }), async ({ ruleId, payload, dryRun, siteId, customHeaders }) => {
+        const parsedPayload = bandwidthControlRulePayloadSchema.parse(payload);
+        const existingRules = await client.getGridBandwidthCtrlRule(1, 1000, siteId, customHeaders);
+        const before = ruleId ? findGridRecordById(existingRules, ruleId) : undefined;
+        if (ruleId && !before) {
+            throw new Error(`No bandwidth control rule exists for ${ruleId}.`);
+        }
+        await validateBandwidthControlPayloadReferences(client, parsedPayload, siteId, customHeaders);
+        if (dryRun) {
+            return {
+                accepted: true,
+                dryRun: true,
+                before,
+                plannedRule: parsedPayload,
+            };
+        }
+        if (ruleId) {
+            return await client.updateBandwidthCtrlRule(ruleId, parsedPayload, siteId, customHeaders);
+        }
+        const createResult = await client.createBandwidthCtrlRule(parsedPayload, siteId, customHeaders);
+        const createdRuleId = (() => {
+            if (!createResult || typeof createResult !== 'object') {
+                return undefined;
+            }
+            const maybeId = createResult.id ??
+                createResult.ruleId;
+            return maybeId === undefined ? undefined : String(maybeId);
+        })();
+        if (createdRuleId) {
+            return createResult;
+        }
+        const rulesAfterCreate = await client.getGridBandwidthCtrlRule(1, 1000, siteId, customHeaders);
+        const beforeIds = new Set(extractGridRecords(existingRules).map((entry) => String(entry['id'] ?? entry['ruleId'] ?? '')));
+        const createdRule = extractGridRecords(rulesAfterCreate).find((entry) => {
+            const entryId = String(entry['id'] ?? entry['ruleId'] ?? '');
+            return !beforeIds.has(entryId) && entry['name'] === parsedPayload.name;
+        });
+        if (createdRule) {
+            const createdId = createdRule['id'] ?? createdRule['ruleId'];
+            return {
+                id: createdId === undefined ? undefined : String(createdId),
+                createdRule,
+            };
+        }
+        return createResult;
+    }));
+}
+//# sourceMappingURL=setBandwidthControlRule.js.map

package/dist/tools/setBandwidthControlRule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setBandwidthControlRule.js","sourceRoot":"","sources":["../../src/tools/setBandwidthControlRule.ts"],"names":[],"mappings":"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"}

package/dist/tools/setClientRateLimit.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OmadaClient } from '../omadaClient/index.js';
+export declare function registerSetClientRateLimitTool(server: McpServer, client: OmadaClient): void;

package/dist/tools/setClientRateLimit.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { siteInputSchema, toToolResult, wrapToolHandler } from '../server/common.js';
+export function registerSetClientRateLimitTool(server, client) {
+    const inputSchema = siteInputSchema.extend({
+        clientMac: z.string().min(1, 'clientMac (MAC address) is required'),
+        downLimit: z.number().positive('downLimit must be a positive number (in Kbps)'),
+        upLimit: z.number().positive('upLimit must be a positive number (in Kbps)'),
+    });
+    server.registerTool('setClientRateLimit', {
+        description: 'Set custom rate limit (bandwidth control) for a specific client. Specify download and upload limits in Kbps. This configures custom limits directly without using a predefined profile.',
+        inputSchema: inputSchema.shape,
+    }, wrapToolHandler('setClientRateLimit', async ({ clientMac, downLimit, upLimit, siteId, customHeaders }) => toToolResult(await client.setClientRateLimit(clientMac, downLimit, upLimit, siteId, customHeaders))));
+}
+//# sourceMappingURL=setClientRateLimit.js.map

package/dist/tools/setClientRateLimit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setClientRateLimit.js","sourceRoot":"","sources":["../../src/tools/setClientRateLimit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErF,MAAM,UAAU,8BAA8B,CAAC,MAAiB,EAAE,MAAmB;IACjF,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC;QACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qCAAqC,CAAC;QACnE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAC/E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KAC9E,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CACf,oBAAoB,EACpB;QACI,WAAW,EACP,yLAAyL;QAC7L,WAAW,EAAE,WAAW,CAAC,KAAK;KACjC,EACD,eAAe,CAAC,oBAAoB,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,CACrG,YAAY,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CACtG,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/setClientRateLimitProfile.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OmadaClient } from '../omadaClient/index.js';
+export declare function registerSetClientRateLimitProfileTool(server: McpServer, client: OmadaClient): void;

package/dist/tools/setClientRateLimitProfile.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { siteInputSchema, toToolResult, wrapToolHandler } from '../server/common.js';
+export function registerSetClientRateLimitProfileTool(server, client) {
+    const inputSchema = siteInputSchema.extend({
+        clientMac: z.string().min(1, 'clientMac (MAC address) is required'),
+        profileId: z.string().min(1, 'profileId (rate limit profile ID) is required'),
+    });
+    server.registerTool('setClientRateLimitProfile', {
+        description: 'Apply a predefined rate limit profile to a specific client. Use getRateLimitProfiles to get available profile IDs.',
+        inputSchema: inputSchema.shape,
+    }, wrapToolHandler('setClientRateLimitProfile', async ({ clientMac, profileId, siteId, customHeaders }) => toToolResult(await client.setClientRateLimitProfile(clientMac, profileId, siteId, customHeaders))));
+}
+//# sourceMappingURL=setClientRateLimitProfile.js.map

package/dist/tools/setClientRateLimitProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setClientRateLimitProfile.js","sourceRoot":"","sources":["../../src/tools/setClientRateLimitProfile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErF,MAAM,UAAU,qCAAqC,CAAC,MAAiB,EAAE,MAAmB;IACxF,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC;QACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qCAAqC,CAAC;QACnE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,+CAA+C,CAAC;KAChF,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CACf,2BAA2B,EAC3B;QACI,WAAW,EAAE,oHAAoH;QACjI,WAAW,EAAE,WAAW,CAAC,KAAK;KACjC,EACD,eAAe,CAAC,2BAA2B,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,CACnG,YAAY,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CACpG,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/setDeviceLed.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OmadaClient } from '../omadaClient/index.js';
+export declare function registerSetDeviceLedTool(server: McpServer, client: OmadaClient): void;

package/dist/tools/setDeviceLed.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { deviceMacSchema, siteInputSchema, wrapMutationToolHandler } from '../server/common.js';
+export function registerSetDeviceLedTool(server, client) {
+    const inputSchema = siteInputSchema.extend({
+        deviceMac: deviceMacSchema.describe('Device MAC address to update.'),
+        ledSetting: z.number().int().min(0).max(2).describe('LED setting. 0=off, 1=on, 2=site-default as documented by the Omada controller.'),
+        dryRun: z.boolean().optional().default(false).describe('If true, return the planned action without sending it to the controller.'),
+    });
+    server.registerTool('setDeviceLed', {
+        description: 'Change the LED state for a managed device through the official Omada Open API.',
+        inputSchema: inputSchema.shape,
+    }, wrapMutationToolHandler('setDeviceLed', ({ deviceMac, ledSetting, siteId }, result, mode) => ({
+        action: 'set-device-led',
+        target: deviceMac,
+        siteId,
+        mode,
+        status: mode === 'dry-run' ? 'planned' : 'applied',
+        summary: mode === 'dry-run'
+            ? `Planned LED setting ${ledSetting} for device ${deviceMac}.`
+            : `LED setting ${ledSetting} requested for device ${deviceMac}.`,
+        result,
+    }), async ({ deviceMac, ledSetting, siteId, customHeaders, dryRun }) => {
+        if (dryRun) {
+            return { accepted: true, dryRun: true, ledSetting };
+        }
+        return await client.setDeviceLed(deviceMac, ledSetting, siteId, customHeaders);
+    }));
+}
+//# sourceMappingURL=setDeviceLed.js.map

package/dist/tools/setDeviceLed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setDeviceLed.js","sourceRoot":"","sources":["../../src/tools/setDeviceLed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEhG,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,MAAmB;IAC3E,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC;QACvC,SAAS,EAAE,eAAe,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACpE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iFAAiF,CAAC;QACtI,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,0EAA0E,CAAC;KACrI,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CACf,cAAc,EACd;QACI,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE,WAAW,CAAC,KAAK;KACjC,EACD,uBAAuB,CACnB,cAAc,EACd,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAClD,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE,SAAS;QACjB,MAAM;QACN,IAAI;QACJ,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAClD,OAAO,EACH,IAAI,KAAK,SAAS;YACd,CAAC,CAAC,uBAAuB,UAAU,eAAe,SAAS,GAAG;YAC9D,CAAC,CAAC,eAAe,UAAU,yBAAyB,SAAS,GAAG;QACxE,MAAM;KACT,CAAC,EACF,KAAK,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE;QAC/D,IAAI,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACnF,CAAC,CACJ,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/setFirewallSetting.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OmadaClient } from '../omadaClient/index.js';
+export declare function registerSetFirewallSettingTool(server: McpServer, client: OmadaClient): void;

package/dist/tools/setFirewallSetting.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { siteInputSchema, wrapMutationToolHandler } from '../server/common.js';
+const inputSchema = siteInputSchema.extend({
+    payload: z
+        .record(z.string(), z.unknown())
+        .describe('Firewall settings payload that matches the official Omada Open API firewall schema for the site.'),
+    dryRun: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('If true, fetch the current firewall settings and return the planned change without applying it.'),
+});
+export function registerSetFirewallSettingTool(server, client) {
+    server.registerTool('setFirewallSetting', {
+        description: 'Update site firewall settings through the official Omada Open API with dry-run preview support.',
+        inputSchema: inputSchema.shape,
+        annotations: {
+            destructiveHint: true,
+        },
+    }, wrapMutationToolHandler('setFirewallSetting', ({ siteId }, result, mode) => ({
+        action: 'set-firewall-setting',
+        target: siteId ?? 'default-site',
+        siteId,
+        mode,
+        status: mode === 'dry-run' ? 'planned' : 'applied',
+        summary: mode === 'dry-run' ? 'Planned firewall settings update.' : 'Firewall settings update requested.',
+        result,
+    }), async ({ payload, siteId, customHeaders, dryRun }) => {
+        const before = await client.getFirewallSetting(siteId, customHeaders);
+        if (dryRun) {
+            return {
+                accepted: true,
+                dryRun: true,
+                before,
+                plannedConfig: payload,
+            };
+        }
+        const applied = await client.setFirewallSetting(payload, siteId, customHeaders);
+        return {
+            before,
+            applied,
+        };
+    }));
+}
+//# sourceMappingURL=setFirewallSetting.js.map

package/dist/tools/setFirewallSetting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setFirewallSetting.js","sourceRoot":"","sources":["../../src/tools/setFirewallSetting.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC;SACL,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,CAAC,kGAAkG,CAAC;IACjH,MAAM,EAAE,CAAC;SACJ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,iGAAiG,CAAC;CACnH,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAAC,MAAiB,EAAE,MAAmB;IACjF,MAAM,CAAC,YAAY,CACf,oBAAoB,EACpB;QACI,WAAW,EAAE,iGAAiG;QAC9G,WAAW,EAAE,WAAW,CAAC,KAAK;QAC9B,WAAW,EAAE;YACT,eAAe,EAAE,IAAI;SACxB;KACJ,EACD,uBAAuB,CACnB,oBAAoB,EACpB,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3B,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,MAAM,IAAI,cAAc;QAChC,MAAM;QACN,IAAI;QACJ,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAClD,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,qCAAqC;QACzG,MAAM;KACT,CAAC,EACF,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE;QACjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAEtE,IAAI,MAAM,EAAE,CAAC;YACT,OAAO;gBACH,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;gBACZ,MAAM;gBACN,aAAa,EAAE,OAAO;aACzB,CAAC;QACN,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;QAChF,OAAO;YACH,MAAM;YACN,OAAO;SACV,CAAC;IACN,CAAC,CACJ,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/setGatewayConfig.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OmadaClient } from '../omadaClient/index.js';
+export declare function registerSetGatewayConfigTool(server: McpServer, client: OmadaClient): void;