@sendinel/mcp-server 1.0.108 → 1.0.109

package/build/tools/sites.js

@@ -1,4 +1,6 @@
 import { z } from 'zod';
+import { validateSiteUnsubscribeSettings } from '@sendinel/domain';
+import { logAudit } from '../audit.js';
 import { db } from '../db.js';
 import { getProjectId } from '../project.js';
 import { checkPlanLimit } from '../plan-limits.js';
@@ -112,14 +114,14 @@ export function registerSiteTools(server) {
             idempotentHint: true,
             openWorldHint: false,
         },
-        description: 'Read the brand voice configuration for a sender/site.',
+        description: 'Read the brand voice configuration and current site-wide footer, unsubscribe link settings, unsubscribe text, and physical mailing address for a sender/site.',
         inputSchema: {
             site_id: z.string().uuid(),
         },
     }, async ({ site_id }) => {
         const { data, error } = await db()
             .from('sites')
-            .select('id, name, brand_voice')
+            .select('id, name, brand_voice, physical_address, unsub_link_enabled, unsub_one_click_enabled, unsub_custom_url, unsub_footer_template, unsub_custom_message, unsub_brand_logo_url, unsub_brand_color')
             .eq('project_id', getProjectId())
             .eq('id', site_id)
             .maybeSingle();
@@ -184,15 +186,23 @@ export function registerSiteTools(server) {
             idempotentHint: true,
             openWorldHint: false,
         },
-        description: 'Update a site name, from address, or other settings',
+        description: 'Update site-wide email footer, unsubscribe text, unsubscribe link, one-click unsubscribe, unsubscribe page branding, sender name/from address, active status, or physical mailing address. unsub_footer_template must be non-empty and include <unsubscribe>link text</unsubscribe>. Omitted settings and physical_address stay unchanged. Returns stored settings and previous_unsub_footer_template when the footer changes, so callers can undo.',
         inputSchema: {
             site_id: z.string().uuid(),
             name: z.string().optional(),
             from_email: z.string().email().optional(),
             from_name: z.string().optional(),
             active: z.boolean().optional(),
+            physical_address: z.string().trim().min(1).optional().describe('Physical mailing address; unchanged unless explicitly supplied.'),
+            unsub_link_enabled: z.boolean().optional().describe('Enable the unsubscribe link in the email footer.'),
+            unsub_one_click_enabled: z.boolean().optional().describe('Enable one-click unsubscribe headers.'),
+            unsub_custom_url: z.string().nullable().optional().describe('HTTP(S) unsubscribe URL; null or blank clears it.'),
+            unsub_footer_template: z.string().nullable().optional().describe('Non-empty site-wide footer including <unsubscribe>link text</unsubscribe>.'),
+            unsub_custom_message: z.string().nullable().optional().describe('Unsubscribe page message, up to 280 characters; null or blank clears it.'),
+            unsub_brand_logo_url: z.string().nullable().optional().describe('HTTP(S) unsubscribe page logo URL; null or blank clears it.'),
+            unsub_brand_color: z.string().nullable().optional().describe('Six-digit hex unsubscribe page color; null or blank clears it.'),
         },
-    }, async ({ site_id, name, from_email, from_name, active }) => {
+    }, async ({ site_id, name, from_email, from_name, active, physical_address, ...unsubscribeInput }) => {
         const updates = {};
         if (name)
             updates.name = name;
@@ -202,18 +212,54 @@ export function registerSiteTools(server) {
             updates.from_name = from_name;
         if (active !== undefined)
             updates.active = active;
+        if (physical_address !== undefined)
+            updates.physical_address = physical_address.trim().slice(0, 500);
+        const unsubscribe = validateSiteUnsubscribeSettings(unsubscribeInput);
+        if (!unsubscribe.ok)
+            return txt(`Error: ${unsubscribe.error}`);
+        Object.assign(updates, unsubscribe.value);
         if (!Object.keys(updates).length)
             return txt('No fields to update.');
+        // Read only when a footer is supplied, and guard the write so the undo value is exact.
+        const sb = db();
+        const projectId = getProjectId();
+        let previousTemplate;
+        if (updates.unsub_footer_template !== undefined) {
+            const { data: current, error } = await sb
+                .from('sites')
+                .select('unsub_footer_template')
+                .eq('id', site_id)
+                .eq('project_id', projectId)
+                .maybeSingle();
+            if (error)
+                return txt(`Error: ${error.message}`);
+            if (!current)
+                return j({ error: 'Site not found', code: 'NOT_FOUND' });
+            previousTemplate = current.unsub_footer_template;
+        }
         updates.updated_at = new Date().toISOString();
-        const { data, error } = await db()
+        let query = sb
             .from('sites')
             .update(updates)
             .eq('id', site_id)
-            .eq('project_id', getProjectId())
-            .select()
-            .single();
+            .eq('project_id', projectId);
+        if (previousTemplate === null)
+            query = query.is('unsub_footer_template', null);
+        else if (previousTemplate !== undefined)
+            query = query.eq('unsub_footer_template', previousTemplate);
+        const { data, error } = await query.select().maybeSingle();
         if (error)
             return txt(`Error: ${error.message}`);
-        return j(data);
+        if (!data)
+            return j({ error: 'Site not found or footer changed during update. Read the site and retry.', code: 'SITE_CHANGED_OR_NOT_FOUND' });
+        await logAudit({
+            action: 'site.updated', resourceType: 'site', resourceId: site_id,
+            details: { fields: Object.keys(updates).filter((field) => field !== 'updated_at') },
+        });
+        return j({
+            ...data,
+            ...(previousTemplate !== undefined && previousTemplate !== data.unsub_footer_template
+                ? { previous_unsub_footer_template: previousTemplate } : {}),
+        });
     });
 }

package/build/tools/tool-search.js

@@ -12,6 +12,7 @@ export const STOPWORDS = new Set([
  * Only tools that exist in the registry belong here.
  */
 export const TOOL_ALIASES = {
+    update_site: ['footer', 'email footer', 'unsubscribe text', 'unsubscribe link', 'site footer', 'unsubscribe settings'],
     set_campaign_trigger: ['trigger', 'event', 'fires on', 'fires-on', 'dunning', 'set campaign trigger event name', 'invoice payment failed', 'trial ending'],
     send_broadcast: [
         'send email', 'send an email', 'email blast', 'blast', 'newsletter', 'announce', 'announcement', 'one-off email',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendinel/mcp-server",
-  "version": "1.0.108",
+  "version": "1.0.109",
   "description": "AI-controlled email operations control plane for campaigns, contacts, segments, analytics, and multi-provider sending via MCP.",
   "mcpName": "ai.sendinel/mcp-server",
   "type": "module",