@sendinel/mcp-server 1.0.107 → 1.0.109

package/build/tools/campaigns.js

@@ -2,7 +2,7 @@ import { readCampaignPeriods, campaignPeriodFields } from "@sendinel/domain";
 import { CAMPAIGN_BRANCH_CONDITIONS, campaignBranchConditionValue, isContactPropertyConditionList, STEP_PROPERTY_CONDITIONS_ERROR, validateStepPropertyRules } from "@sendinel/domain";
 import { z } from 'zod';
 import Anthropic from '@anthropic-ai/sdk';
-import { assertSendAccepted, providerSendError, sendError, SendRefusedError, BLOCKING_CONTENT_ISSUE_KINDS, computeSendContentKey, findContentIssues, sendingHostOf, NAME_FALLBACKS, ONE_SEND_MATCH_STATUSES, ONE_SEND_SENT_STATUSES, ONE_SEND_WINDOW_DAYS, normalizeTriggerConfig, renderTemplateString as renderTemplateVars, resolveBrandTokens, brandWarnings, readAllRows, isSegmentRulesError, scopeSegmentRulesToSite, SegmentRulesError, validateSegmentRules, } from '@sendinel/domain';
+import { assertSendAccepted, providerSendError, sendError, SendRefusedError, BLOCKING_CONTENT_ISSUE_KINDS, computeSendContentKey, findContentIssues, sendingHostOf, NAME_FALLBACKS, ONE_SEND_MATCH_STATUSES, ONE_SEND_SENT_STATUSES, ONE_SEND_WINDOW_DAYS, normalizeTriggerConfig, renderTemplateString as renderTemplateVars, resolveBrandTokens, brandWarnings, readAllRows, isSegmentRulesError, scopeSegmentRulesToSite, SegmentRulesError, validateSegmentRules, validateUnsubFooterTemplate, } from '@sendinel/domain';
 // Subpath import, not the barrel above -- reply-actions.ts uses node:crypto,
 // and MCP-server-side that's fine (this never runs in an Edge Function), but
 // keeping it off the shared barrel avoids re-creating the Edge-Function
@@ -652,7 +652,7 @@ export function registerCampaignTools(server) {
     }, async ({ site_id, status, limit, period }) => {
         let q = db()
             .from('campaigns')
-            .select('id, site_id, name, type, status, sends_per_hour, total_enrolled, total_sent, total_opened, total_clicked, created_at, period_key, segment_id, trigger_type, trigger_event_name, trigger_tag, trigger_config')
+            .select('id, site_id, name, type, status, sends_per_hour, total_enrolled, total_sent, total_opened, total_clicked, created_at, period_key, segment_id, trigger_type, trigger_event_name, trigger_tag, trigger_config, send_class, unsub_footer_template')
             .eq('project_id', getProjectId())
             .order('created_at', { ascending: false })
             .limit(limit ?? 25);
@@ -2966,6 +2966,8 @@ Return ONLY valid JSON with this exact shape:
             site_id: z.string().uuid().describe('Site to send from'),
             name: z.string().min(1).max(200).describe('Campaign name'),
             type: z.enum(['sequence', 'broadcast', 'triggered']).describe('Campaign type'),
+            send_class: z.enum(['broadcast', 'product']).optional().describe("Consent class: broadcast (marketing, default) or product (account, onboarding, trial and billing mail)."),
+            unsub_footer_template: z.string().nullable().optional().describe('Campaign unsubscribe footer override. Must contain <unsubscribe>link text</unsubscribe>. Null uses the site footer.'),
             trigger_event_name: z.string().nullable().optional(),
             trigger_tag: z.string().nullable().optional(),
             trigger_type: z.enum(['manual', 'date_field', 'contact_event']).nullable().optional(),
@@ -2984,7 +2986,14 @@ Return ONLY valid JSON with this exact shape:
             confirmed: z.boolean().optional().default(false).describe('Two-call confirmation. First call previews, second call with confirmed=true executes.'),
             approval_id: z.string().uuid().optional().describe('Approval token from a previous call. Required when activate=true — get this by calling once without it, then have a human approve via the dashboard.'),
         },
-    }, async ({ site_id, name, type, steps, segment_id, sends_per_hour, activate, confirmed, approval_id, trigger_event_name, trigger_tag, trigger_type, trigger_config }) => {
+    }, async ({ site_id, name, type, steps, segment_id, sends_per_hour, activate, confirmed, approval_id, trigger_event_name, trigger_tag, trigger_type, trigger_config, send_class, unsub_footer_template }) => {
+        const footerTemplate = unsub_footer_template?.trim() ?? null;
+        if (footerTemplate !== null) {
+            const footerError = validateUnsubFooterTemplate(footerTemplate);
+            if (footerError)
+                return j({ error: footerError, code: 'INVALID_FIELD' });
+        }
+        const sendClass = send_class ?? 'broadcast';
         const targeting = {};
         const triggerInput = { trigger_event_name, trigger_tag, trigger_type, trigger_config };
         const targetingError = await applyCampaignTargetingFields(targeting, triggerInput, getProjectId());
@@ -2996,7 +3005,7 @@ Return ONLY valid JSON with this exact shape:
         const canActivateOnTrigger = campaignType === 'triggered' && (hasEventOrTag || targeting.trigger_type === 'date_field' || targeting.trigger_type === 'contact_event');
         // Human-in-the-loop gate for activation
         if (activate && confirmed) {
-            const approvalParams = { site_id, name, type, steps, segment_id, sends_per_hour, activate, ...triggerInput };
+            const approvalParams = { site_id, name, type, steps, segment_id, sends_per_hour, activate, send_class, unsub_footer_template, ...triggerInput };
             const channelContext = currentChannelContext();
             const decision = assertChannelCanExecute('create_campaign_with_content', { activate }, channelContext);
             if (!decision.allowed)
@@ -3042,7 +3051,7 @@ Return ONLY valid JSON with this exact shape:
         if (!confirmed) {
             return j({
                 confirmation_required: true,
-                campaign: { name, type: campaignType, site: site.name, ...targeting },
+                campaign: { name, type: campaignType, site: site.name, send_class: sendClass, unsub_footer_template: footerTemplate, ...targeting },
                 steps: steps.map((s, i) => ({
                     step: i + 1,
                     subject: s.subject,
@@ -3066,6 +3075,8 @@ Return ONLY valid JSON with this exact shape:
             site_id,
             name,
             type: campaignType,
+            send_class: sendClass,
+            unsub_footer_template: footerTemplate,
             ...targeting,
             status: 'draft',
             segment_id: segment_id ?? null,
@@ -3150,6 +3161,8 @@ Return ONLY valid JSON with this exact shape:
             campaign_id: campaign.id,
             name,
             type: campaignType,
+            send_class: campaign.send_class,
+            unsub_footer_template: campaign.unsub_footer_template,
             ...targeting,
             fires_on: buildCampaignFiresOn({ ...campaign, status: willActivate ? 'active' : 'draft' }),
             trigger_diagnostics: buildCampaignTriggerDiagnostics({ ...campaign, status: willActivate ? 'active' : 'draft' }),
@@ -3415,6 +3428,7 @@ Return ONLY valid JSON with this exact shape:
             type: z.enum(['sequence', 'triggered']).optional().describe("Switch a DRAFT campaign between 'sequence' and 'triggered'. Event and tag triggers only start campaigns of type 'triggered'."),
             sends_per_hour: z.number().int().min(1).nullable().optional().describe('Optional hourly send cap for wave sending. Set null to clear.'),
             send_in_contact_timezone: z.boolean().optional(),
+            unsub_footer_template: z.string().nullable().optional().describe('Campaign unsubscribe footer override. Must contain <unsubscribe>link text</unsubscribe>. Set null to use the site footer.'),
             send_class: z.enum(['broadcast', 'product']).optional().describe("Who may receive it when the project's consent gate is on: 'broadcast' (default) = only contacts who opted in to marketing; 'product' = also the customer's signed-up users (onboarding, trial, account mail)."),
         },
     }, async ({ approval_id, ...input }) => {
@@ -3422,9 +3436,14 @@ Return ONLY valid JSON with this exact shape:
             const result = await resumeCampaignEdit('update_campaign', approval_id, input);
             return j(result.error ? result : { ...result, fires_on: buildCampaignFiresOn(result), trigger_diagnostics: buildCampaignTriggerDiagnostics(result) });
         }
-        const { campaign_id, name, site_id, segment_id, send_at, topic, trigger_event_name, trigger_tag, trigger_type, trigger_config, type, sends_per_hour, send_in_contact_timezone, send_class } = input;
+        const { campaign_id, name, site_id, segment_id, send_at, topic, trigger_event_name, trigger_tag, trigger_type, trigger_config, type, sends_per_hour, send_in_contact_timezone, send_class, unsub_footer_template } = input;
         if (!campaign_id)
             return j({ error: 'campaign_id is required', code: 'INVALID_FIELD' });
+        if (unsub_footer_template !== undefined && unsub_footer_template !== null) {
+            const footerError = validateUnsubFooterTemplate(unsub_footer_template);
+            if (footerError)
+                return j({ error: footerError, code: 'INVALID_FIELD' });
+        }
         const projectId = getProjectId();
         let campaignType;
         const loadExisting = () => db()
@@ -3491,6 +3510,8 @@ Return ONLY valid JSON with this exact shape:
             updates.send_in_contact_timezone = send_in_contact_timezone;
         if (send_class !== undefined)
             updates.send_class = send_class;
+        if (unsub_footer_template !== undefined)
+            updates.unsub_footer_template = unsub_footer_template?.trim() ?? null;
         const targetingError = await applyCampaignTargetingFields(updates, { trigger_event_name, trigger_tag, trigger_type, trigger_config, segment_id }, projectId, existingCampaignForTargeting);
         if (targetingError)
             return j({ error: targetingError, code: targetingError === 'Segment not found' ? 'NOT_FOUND' : 'INVALID_FIELD' });

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.107",
+  "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",