@reveldigital/mcp-graphql-proxy 2.1.0 → 2.3.0

package/dist/index.js

@@ -119,9 +119,11 @@ server.tool('build_query', 'Build an optimized GraphQL query with field selectio
         'playlist', 'playlistGroups', 'schedule', 'scheduleGroups',
         'template', 'templateGroups', 'user',
         // Alerts & Monitoring
-        'alert',
+        'alert', 'alertRule',
         // Audit & Compliance
         'auditEvent',
+        // Connector Data
+        'connectorData',
         // Data Tables
         'dataTables', 'dataTable',
         // Device Commands & Permissions
@@ -159,6 +161,11 @@ server.tool('build_query', 'Build an optimized GraphQL query with field selectio
     // Alert-specific arguments
     activeOnly: z.boolean().optional().describe('Filter to show only active alerts (alert only)'),
     resolved: z.boolean().optional().describe('Filter by resolved state (alert only)'),
+    orgId: z.string().optional().describe('Filter by organization ID (alert, alertRule)'),
+    // Connector data arguments
+    datasourceId: z.string().optional().describe('Registered data source identifier (connectorData only)'),
+    datasetId: z.string().optional().describe('Registered dataset identifier on that source (connectorData only)'),
+    params: z.record(z.unknown()).optional().describe('Optional validated parameters for the dataset (connectorData only)'),
 }, async (args) => {
     try {
         const queryArgs = {};
@@ -197,6 +204,15 @@ server.tool('build_query', 'Build an optimized GraphQL query with field selectio
             queryArgs.activeOnly = args.activeOnly;
         if (args.resolved !== undefined)
             queryArgs.resolved = args.resolved;
+        if (args.orgId !== undefined)
+            queryArgs.orgId = args.orgId;
+        // Connector data arguments
+        if (args.datasourceId !== undefined)
+            queryArgs.datasourceId = args.datasourceId;
+        if (args.datasetId !== undefined)
+            queryArgs.datasetId = args.datasetId;
+        if (args.params !== undefined)
+            queryArgs.params = args.params;
         const { query, variables } = QueryBuilder.build({
             operation: args.operation,
             fields: args.fields ?? [],
@@ -1153,6 +1169,753 @@ mutation ReorderPlaylistSources($input: ReorderPlaylistSourcesInput) {
     }
 });
 // ============================================================================
+// Tool: Update Template
+// ============================================================================
+server.tool('update_template', "Update a template's properties (name, group, tags, dimensions, colors, orientation, script). Only provided fields are changed. Example: AI adjusts template dimensions to optimize for a new display resolution.", {
+    templateId: z.string().describe('The template ID to update'),
+    name: z.string().optional().describe('Template name'),
+    groupId: z.string().optional().describe('Group ID to assign the template to'),
+    tags: z.string().optional().describe('Tags (newline-delimited values stored in the Description field)'),
+    script: z.string().optional().describe('Template script for custom logic'),
+    backColor: z.string().optional().describe("Background color (e.g., '#000000')"),
+    width: z.number().optional().describe('Template width in pixels'),
+    height: z.number().optional().describe('Template height in pixels'),
+    orientation: z.number().optional().describe('Display orientation (0=Landscape, 1=Portrait, 2=Landscape Reversed, 3=Portrait Reversed)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation UpdateTemplate($input: UpdateTemplateInput) {
+  updateTemplate(input: $input) {
+    success
+    template {
+      id
+      name
+      width
+      height
+      orientation
+      modules {
+        id
+        name
+        type
+        left
+        top
+        width
+        height
+        playlistId
+        sequence
+      }
+    }
+    error
+  }
+}`;
+        const input = { templateId: args.templateId };
+        if (args.name !== undefined)
+            input.name = args.name;
+        if (args.groupId !== undefined)
+            input.groupId = args.groupId;
+        if (args.tags !== undefined)
+            input.tags = args.tags;
+        if (args.script !== undefined)
+            input.script = args.script;
+        if (args.backColor !== undefined)
+            input.backColor = args.backColor;
+        if (args.width !== undefined)
+            input.width = args.width;
+        if (args.height !== undefined)
+            input.height = args.height;
+        if (args.orientation !== undefined)
+            input.orientation = args.orientation;
+        const response = await graphqlClient.query(mutation, { input });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Add Template Module
+// ============================================================================
+server.tool('add_template_module', "Add a new module (zone/region) to a template. Modules define rectangular areas where content from a playlist is displayed. Example: AI adds a new weather module to show real-time conditions in the corner.", {
+    templateId: z.string().describe('The template ID to add the module to'),
+    module: z.object({
+        name: z.string().optional().describe('Module/zone name'),
+        type: z.string().optional().describe("Module/zone type (e.g., 'Playlist', 'Clock', 'Weather', 'Ticker', 'Web')"),
+        left: z.number().optional().describe('Left position in pixels'),
+        top: z.number().optional().describe('Top position in pixels'),
+        width: z.number().optional().describe('Width in pixels'),
+        height: z.number().optional().describe('Height in pixels'),
+        playlistId: z.string().optional().describe('Playlist ID assigned to this module'),
+        sequence: z.number().optional().describe('Z-order/sequence for overlapping modules (higher appears in front)'),
+    }).describe('The module to add'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation AddTemplateModule($input: AddTemplateModuleInput) {
+  addTemplateModule(input: $input) {
+    success
+    module {
+      id
+      name
+      type
+      left
+      top
+      width
+      height
+      playlistId
+      sequence
+      options {
+        id
+        name
+        value
+      }
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                module: args.module,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Update Template Module
+// ============================================================================
+server.tool('update_template_module', 'Update a module (zone/region) within a template. Only provided fields are changed. Example: AI repositions a module based on engagement analytics, or changes the assigned playlist.', {
+    templateId: z.string().describe('The template ID containing the module'),
+    moduleId: z.string().describe('The module ID to update'),
+    name: z.string().optional().describe('Module/zone name'),
+    type: z.string().optional().describe("Module/zone type (e.g., 'Playlist', 'Clock', 'Weather', 'Ticker', 'Web')"),
+    left: z.number().optional().describe('Left position in pixels'),
+    top: z.number().optional().describe('Top position in pixels'),
+    width: z.number().optional().describe('Width in pixels'),
+    height: z.number().optional().describe('Height in pixels'),
+    playlistId: z.string().optional().describe('Playlist ID assigned to this module'),
+    sequence: z.number().optional().describe('Z-order/sequence for overlapping modules'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation UpdateTemplateModule($input: UpdateTemplateModuleInput) {
+  updateTemplateModule(input: $input) {
+    success
+    module {
+      id
+      name
+      type
+      left
+      top
+      width
+      height
+      playlistId
+      sequence
+      options {
+        id
+        name
+        value
+      }
+    }
+    error
+  }
+}`;
+        const input = {
+            templateId: args.templateId,
+            moduleId: args.moduleId,
+        };
+        if (args.name !== undefined)
+            input.name = args.name;
+        if (args.type !== undefined)
+            input.type = args.type;
+        if (args.left !== undefined)
+            input.left = args.left;
+        if (args.top !== undefined)
+            input.top = args.top;
+        if (args.width !== undefined)
+            input.width = args.width;
+        if (args.height !== undefined)
+            input.height = args.height;
+        if (args.playlistId !== undefined)
+            input.playlistId = args.playlistId;
+        if (args.sequence !== undefined)
+            input.sequence = args.sequence;
+        const response = await graphqlClient.query(mutation, { input });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Remove Template Module
+// ============================================================================
+server.tool('remove_template_module', 'Remove a module (zone/region) from a template by module ID. Example: AI removes an underperforming ad module to optimize content flow.', {
+    templateId: z.string().describe('The template ID containing the module'),
+    moduleId: z.string().describe('The module ID to remove'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation RemoveTemplateModule($input: RemoveTemplateModuleInput) {
+  removeTemplateModule(input: $input) {
+    success
+    module {
+      id
+      name
+      type
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                moduleId: args.moduleId,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Reorder Template Modules
+// ============================================================================
+server.tool('reorder_template_modules', 'Reorder modules (zones) within a template by updating their sequence/z-order. Higher sequence values appear in front. Example: AI reorders modules to bring important content to the front based on viewer engagement.', {
+    templateId: z.string().describe('The template ID'),
+    moduleSequences: z.array(z.object({
+        moduleId: z.string().describe('The module ID'),
+        sequence: z.number().describe('The new sequence/z-order value'),
+    })).describe('List of module IDs with their new sequence numbers'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation ReorderTemplateModules($input: ReorderTemplateModulesInput) {
+  reorderTemplateModules(input: $input) {
+    success
+    template {
+      id
+      name
+      modules {
+        id
+        name
+        type
+        sequence
+      }
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                moduleSequences: args.moduleSequences,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Batch Update Template Modules
+// ============================================================================
+server.tool('batch_update_template_modules', 'Batch update multiple modules in a template at once. Each entry must include the moduleId; only provided fields are changed. Example: AI repositions all modules to create a new layout optimized for viewer attention.', {
+    templateId: z.string().describe('The template ID'),
+    modules: z.array(z.object({
+        moduleId: z.string().describe('The module ID to update'),
+        name: z.string().optional().describe('Module/zone name'),
+        type: z.string().optional().describe('Module/zone type'),
+        left: z.number().optional().describe('Left position in pixels'),
+        top: z.number().optional().describe('Top position in pixels'),
+        width: z.number().optional().describe('Width in pixels'),
+        height: z.number().optional().describe('Height in pixels'),
+        playlistId: z.string().optional().describe('Playlist ID assigned to this module'),
+        sequence: z.number().optional().describe('Z-order/sequence'),
+    })).describe('List of module updates to apply (each requires moduleId)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation BatchUpdateTemplateModules($input: BatchUpdateTemplateModulesInput) {
+  batchUpdateTemplateModules(input: $input) {
+    totalModules
+    successCount
+    failureCount
+    results {
+      success
+      module {
+        id
+        name
+        type
+        left
+        top
+        width
+        height
+        playlistId
+        sequence
+      }
+      error
+    }
+  }
+}`;
+        const modules = args.modules.map((m) => ({ ...m, templateId: args.templateId }));
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                modules,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Set Module Options
+// ============================================================================
+server.tool('set_module_options', 'Set all configuration options for a module/zone (replaces existing options). Options are key-value pairs storing type-specific settings. Example: AI configures a weather module with location, units, and API key settings.', {
+    templateId: z.string().describe('The template ID'),
+    moduleId: z.string().describe('The module ID'),
+    options: z.array(z.object({
+        name: z.string().describe("Option name/key (e.g., 'timezone', 'location', 'url')"),
+        value: z.string().describe('Option value (string representation, parsed by option type)'),
+    })).describe('List of options to set (replaces all existing options)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation SetModuleOptions($input: SetModuleOptionsInput) {
+  setModuleOptions(input: $input) {
+    success
+    module {
+      id
+      name
+      type
+      options {
+        id
+        name
+        value
+      }
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                moduleId: args.moduleId,
+                options: args.options,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Upsert Module Option
+// ============================================================================
+server.tool('upsert_module_option', 'Add or update a single module/zone option (matched by name). Example: AI updates the refresh interval for a web module.', {
+    templateId: z.string().describe('The template ID'),
+    moduleId: z.string().describe('The module ID'),
+    option: z.object({
+        name: z.string().describe("Option name/key (e.g., 'timezone', 'location', 'url')"),
+        value: z.string().describe('Option value (string representation, parsed by option type)'),
+    }).describe('The option to create or update (matched by name)'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation UpsertModuleOption($input: UpsertModuleOptionInput) {
+  upsertModuleOption(input: $input) {
+    success
+    option {
+      id
+      name
+      value
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                moduleId: args.moduleId,
+                option: args.option,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Remove Module Option
+// ============================================================================
+server.tool('remove_module_option', 'Remove a module/zone option by name. Example: AI removes an outdated configuration setting from a module.', {
+    templateId: z.string().describe('The template ID'),
+    moduleId: z.string().describe('The module ID'),
+    optionName: z.string().describe('The option name to remove'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation RemoveModuleOption($input: RemoveModuleOptionInput) {
+  removeModuleOption(input: $input) {
+    success
+    option {
+      id
+      name
+      value
+    }
+    error
+  }
+}`;
+        const response = await graphqlClient.query(mutation, {
+            input: {
+                templateId: args.templateId,
+                moduleId: args.moduleId,
+                optionName: args.optionName,
+            },
+        });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tools: Alert Rules (create / update / delete)
+// ============================================================================
+// The API takes ruleSet as a serialized JSON string, not a nested object. Condition
+// types and operators are case-sensitive and validated server-side.
+const ALERT_RULE_CONDITION_TYPES = [
+    'TimeOffline', 'LastUpdate', 'MemoryUsage', 'CpuUsage', 'DiskUsage', 'NoContent',
+    'BytesTxDay', 'BytesRxDay', 'BytesTotalDay', 'BytesTxPeriod', 'BytesRxPeriod',
+    'BytesTotalPeriod', 'ClockSkew', 'DisplayDetected', 'BatteryVoltage',
+    'BatteryPercentage', 'SystemTemperature',
+];
+const RULE_SET_DESCRIPTION = [
+    'Rule set configuration as a SERIALIZED JSON STRING (not a nested object).',
+    'Shape: an array of condition groups combined with logical AND; the `items` within each group are combined with logical OR.',
+    'Each item is {"type", "op", "value"}:',
+    `\`type\` (required, case-sensitive) one of: ${ALERT_RULE_CONDITION_TYPES.join(', ')}.`,
+    '`op` (optional) one of EQ, NE, GT, LT, GTE, LTE (defaults to EQ).',
+    '`value` (required) a non-empty array of numbers.',
+    'Example: [{"items":[{"type":"CpuUsage","op":"GTE","value":[90]}]}]',
+    'Invalid rule sets are rejected. Null or empty leaves the rule unevaluated.',
+].join(' ');
+const ALERT_RULE_SELECTION = `
+    success
+    alertRule {
+      id
+      name
+      ruleSet
+      isEnabled
+      period
+      threshold
+      webhookUrl
+      allDevices
+      allUsers
+      deviceIds
+      userIds
+      createdOn
+      updatedOn
+    }
+    error`;
+server.tool('create_alert_rule', 'Create a new alert rule — the conditions that trigger alerts. Example: create a rule that fires when a lobby display goes offline. Use build_query with the alertRule operation to read existing rules first.', {
+    name: z.string().describe('The name of the alert rule'),
+    ruleSet: z.string().optional().describe(RULE_SET_DESCRIPTION),
+    isEnabled: z.boolean().optional().describe('Whether the rule is enabled and will be evaluated. Disabled rules are stored but never trigger.'),
+    period: z.number().optional().describe('The look-back / evaluation period, in MINUTES, used by time-window based conditions such as NoContent. Ignored by conditions that read the current value (e.g. CpuUsage).'),
+    threshold: z.number().optional().describe('Legacy scalar threshold. Prefer expressing thresholds inside ruleSet.'),
+    webhookUrl: z.string().optional().describe('Optional HTTPS webhook URL invoked (HTTP POST) when the rule triggers'),
+    allDevices: z.boolean().optional().describe('If true, the rule is evaluated against every device in the account and deviceIds is ignored'),
+    allUsers: z.boolean().optional().describe('If true, all users in the account are notified and userIds is ignored'),
+    deviceIds: z.array(z.string()).optional().describe('Devices to associate with the rule. Ignored when allDevices is true.'),
+    userIds: z.array(z.string()).optional().describe('Users to notify. Ignored when allUsers is true.'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation CreateAlertRule($input: AlertRuleInput) {
+  createAlertRule(input: $input) {${ALERT_RULE_SELECTION}
+  }
+}`;
+        const input = { name: args.name };
+        if (args.ruleSet !== undefined)
+            input.ruleSet = args.ruleSet;
+        if (args.isEnabled !== undefined)
+            input.isEnabled = args.isEnabled;
+        if (args.period !== undefined)
+            input.period = args.period;
+        if (args.threshold !== undefined)
+            input.threshold = args.threshold;
+        if (args.webhookUrl !== undefined)
+            input.webhookUrl = args.webhookUrl;
+        if (args.allDevices !== undefined)
+            input.allDevices = args.allDevices;
+        if (args.allUsers !== undefined)
+            input.allUsers = args.allUsers;
+        if (args.deviceIds !== undefined)
+            input.deviceIds = args.deviceIds;
+        if (args.userIds !== undefined)
+            input.userIds = args.userIds;
+        const response = await graphqlClient.query(mutation, { input });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+server.tool('update_alert_rule', 'Update an existing alert rule. Only provided fields are changed. Example: disable a noisy rule, or widen its device scope.', {
+    id: z.string().describe('The alert rule ID to update'),
+    name: z.string().optional().describe('The name of the alert rule'),
+    ruleSet: z.string().optional().describe(RULE_SET_DESCRIPTION),
+    isEnabled: z.boolean().optional().describe('Whether the rule is enabled and will be evaluated'),
+    period: z.number().optional().describe('The look-back / evaluation period, in MINUTES, used by time-window based conditions such as NoContent. Ignored by conditions that read the current value (e.g. CpuUsage).'),
+    threshold: z.number().optional().describe('Legacy scalar threshold. Prefer expressing thresholds inside ruleSet.'),
+    webhookUrl: z.string().optional().describe('Optional HTTPS webhook URL invoked when the rule triggers'),
+    allDevices: z.boolean().optional().describe('If true, the rule is evaluated against every device and deviceIds is ignored'),
+    allUsers: z.boolean().optional().describe('If true, all users are notified and userIds is ignored'),
+    deviceIds: z.array(z.string()).optional().describe('Devices to associate with the rule. Ignored when allDevices is true.'),
+    userIds: z.array(z.string()).optional().describe('Users to notify. Ignored when allUsers is true.'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation UpdateAlertRule($input: AlertRuleInput) {
+  updateAlertRule(input: $input) {${ALERT_RULE_SELECTION}
+  }
+}`;
+        const input = { id: args.id };
+        if (args.name !== undefined)
+            input.name = args.name;
+        if (args.ruleSet !== undefined)
+            input.ruleSet = args.ruleSet;
+        if (args.isEnabled !== undefined)
+            input.isEnabled = args.isEnabled;
+        if (args.period !== undefined)
+            input.period = args.period;
+        if (args.threshold !== undefined)
+            input.threshold = args.threshold;
+        if (args.webhookUrl !== undefined)
+            input.webhookUrl = args.webhookUrl;
+        if (args.allDevices !== undefined)
+            input.allDevices = args.allDevices;
+        if (args.allUsers !== undefined)
+            input.allUsers = args.allUsers;
+        if (args.deviceIds !== undefined)
+            input.deviceIds = args.deviceIds;
+        if (args.userIds !== undefined)
+            input.userIds = args.userIds;
+        const response = await graphqlClient.query(mutation, { input });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+server.tool('delete_alert_rule', 'Delete an alert rule by ID. This stops the rule from ever triggering again — consider update_alert_rule with isEnabled=false if the rule may be needed later.', {
+    id: z.string().describe('The alert rule ID to delete'),
+}, async (args) => {
+    try {
+        const mutation = `
+mutation DeleteAlertRule($id: String) {
+  deleteAlertRule(id: $id) {${ALERT_RULE_SELECTION}
+  }
+}`;
+        const response = await graphqlClient.query(mutation, { id: args.id });
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const result = {
+            success: true,
+            data: response.data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
 // Tool: List Data Tables
 // ============================================================================
 server.tool('list_data_tables', 'List data tables in the account. Returns table summaries with pagination. Use to discover available tables before querying rows.', {
@@ -2142,6 +2905,10 @@ server.resource('schema://reveldigital/graphql', 'Revel Digital GraphQL Schema',
 
 ### Alerts & Monitoring
 - alert - Query system alerts for device issues and rule violations
+- alertRule - Query alert rules (the conditions that trigger alerts)
+
+### Connector Data
+- connectorData - Fetch a normalized dataset from a registered connector data source (datasourceId + datasetId + params)
 
 ### Analytics (require date range)
 Aggregated metrics optimized for AI context windows:
@@ -2171,6 +2938,11 @@ Raw logs return too much data for AI context windows.
 - send_device_command - Send commands to a specific device
 - send_bulk_device_commands - Send commands to multiple devices at once
 
+### Alert Rule Management
+- create_alert_rule - Create a new alert rule (conditions that trigger alerts)
+- update_alert_rule - Update an existing alert rule (partial update)
+- delete_alert_rule - Delete an alert rule
+
 ### Group Management
 - create_device_group - Create a new device group (optional parentId for nesting)
 - create_media_group - Create a new media group (optional parentId for nesting)
@@ -2191,6 +2963,17 @@ Raw logs return too much data for AI context windows.
 - remove_playlist_source - Remove a source from a playlist
 - reorder_playlist_sources - Reorder sources within a playlist
 
+### Template Management
+- update_template - Update a template's properties (name, group, tags, dimensions, colors, orientation, script)
+- add_template_module - Add a new module (zone) to a template
+- update_template_module - Update a module within a template
+- remove_template_module - Remove a module from a template
+- reorder_template_modules - Reorder modules within a template (sequence/z-order)
+- batch_update_template_modules - Update multiple modules in a template at once
+- set_module_options - Set all options for a module (replaces existing)
+- upsert_module_option - Add or update a single module option (matched by name)
+- remove_module_option - Remove a module option by name
+
 ### Data Table Management
 - create_data_table - Create a new data table with column schema
 - update_data_table - Update table definition (partial update)