@sendinel/mcp-server 1.0.92 → 1.0.94

package/README.md

@@ -12,7 +12,7 @@ AI-controlled email operations control plane for campaigns, contacts, segments,
 
 ## Tool groups
 
-Sendinel currently exposes 35 tool groups and 337 tools (gateway mode exposes 4 meta-tools, sharing how_to with full mode). These counts are checked against the tool registry in CI, so this table matches what ships.
+Sendinel currently exposes 35 tool groups and 338 tools (gateway mode exposes 4 meta-tools, sharing how_to with full mode). These counts are checked against the tool registry in CI, so this table matches what ships.
 
 | Group | Count | Purpose |
 |-------|-------|---------|
@@ -23,7 +23,7 @@ Sendinel currently exposes 35 tool groups and 337 tools (gateway mode exposes 4
 | `analytics` | 15 | Stats, portfolio analytics, project switching, domain health, engagement, deliverability, revenue analytics |
 | `approvals` | 2 | Poll and list risk-tiered action approvals |
 | `automations` | 7 | Automation triggers, previews, and response-gated escalation ladders |
-| `brand_kit` | 5 | Brand Core text import, media library upload/URL ingest, asset-context reads |
+| `brand_kit` | 6 | Brand Core text import, media library upload/URL ingest, asset-context reads, project logo selection |
 | `campaigns` | 43 | Full campaign lifecycle: create, edit, approve, launch, enroll, schedule, sequence templates, convert imported campaigns |
 | `cloud-import` | 6 | Cloud storage import |
 | `compound` | 4 | Higher-level campaign/template/site setup and delivery diagnosis workflows |

package/build/lib/approval-exempt.js

@@ -100,6 +100,7 @@ export const APPROVAL_EXEMPT = {
     run_list_hygiene: "suppresses invalid or bouncing addresses, which only reduces who receives mail",
     run_portfolio_analysis: "writes an internal analysis report only",
     set_active_project: "switches which project this connection targets; no data written",
+    set_brand_logo: "copies an approved image to email storage and updates reversible project branding; sends nothing",
     set_campaign_goal: "sets a goal definition on a campaign; sends nothing",
     set_subscriber_tags: "edits tags on one contact; tag triggers go through enrollment rules the owner configured. FOLLOW-UP: confirm tag-triggered automations are covered",
     set_white_label_settings: "edits branding settings; reversible and sends nothing",

package/build/server.js

@@ -135,7 +135,7 @@ const WRITE_TOOLS = new Set([
     'create_signature', 'update_signature',
     'mark_ai_work_item_seen', 'snooze_ai_work_item', 'dismiss_ai_work_item',
     'submit_ai_context_event',
-    'import_brand_kit_text', 'rehost_brand_asset', 'ingest_brand_assets_by_url', 'upload_brand_asset',
+    'import_brand_kit_text', 'rehost_brand_asset', 'set_brand_logo', 'ingest_brand_assets_by_url', 'upload_brand_asset',
     'create_newsletter', 'update_newsletter', 'create_newsletter_issue', 'schedule_newsletter_issue',
     'send_newsletter_issue', 'subscribe_to_newsletter', 'unsubscribe_from_newsletter',
     'retry_send_queue_rows', 'cancel_send_queue_rows',

package/build/tools/brand-kit.js

@@ -63,6 +63,15 @@ export function registerBrandKitTools(server) {
         const result = await callBrandKitApi(`/api/v1/brand-kit/assets/${asset_id}/rehost`, { purpose, platforms });
         return result.ok ? j(result.data) : j({ error: result.error });
     });
+    server.registerTool('set_brand_logo', {
+        title: 'Set Project Brand Logo',
+        description: 'Use a confirmed PNG, JPEG, GIF or WebP brand asset as this project\'s email logo. Copies it to stable public email storage, preserves other brand settings, and reports site logo overrides without changing them.',
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        inputSchema: { asset_id: z.string().uuid() },
+    }, async ({ asset_id }) => {
+        const result = await callBrandKitApi(`/api/v1/brand-kit/assets/${asset_id}/use-as-logo`, {});
+        return result.ok ? j(result.data) : { ...j({ error: result.error }), isError: true };
+    });
     server.registerTool('list_brand_assets', {
         title: 'List Brand Assets',
         annotations: {

package/build/tools/campaigns.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import Anthropic from '@anthropic-ai/sdk';
-import { assertSendAccepted, 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, readAllRows, } from '@sendinel/domain';
+import { assertSendAccepted, 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, } 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
@@ -2342,7 +2342,7 @@ Do not include body_html in your response; Sendinel renders body_html from block
         // Site verification
         const { data: site } = await db()
             .from('sites')
-            .select('from_email, from_name, name, brand_voice')
+            .select('from_email, from_name, name, brand_voice, physical_address')
             .eq('id', site_id)
             .eq('project_id', projectId)
             .maybeSingle();
@@ -2351,6 +2351,7 @@ Do not include body_html in your response; Sendinel renders body_html from block
         let resolvedSubject = subject;
         let resolvedHtml = html;
         let resolvedText = text;
+        let brandWarningCodes = [];
         if (template_id) {
             const { data: template, error: templateError } = await db()
                 .from('campaign_templates')
@@ -2366,7 +2367,10 @@ Do not include body_html in your response; Sendinel renders body_html from block
             const projectBrand = (project?.brand_settings ?? null);
             const siteBrand = (site.brand_voice ?? null);
             const mergedBrand = projectBrand || siteBrand ? { ...(projectBrand ?? {}), ...(siteBrand ?? {}) } : null;
-            const brandVars = resolveBrandTokens(mergedBrand, site.name || undefined);
+            const brandVars = resolveBrandTokens(mergedBrand, site.name || undefined, { address: site.physical_address ?? undefined });
+            brandWarningCodes = brandWarnings(mergedBrand);
+            if (brandWarningCodes.length)
+                console.warn('MCP send brand warnings', { projectId, site_id, warnings: brandWarningCodes });
             const vars = template_vars ?? {};
             const renderVars = { ...brandVars, ...vars };
             const subjectFallingBack = !subject?.trim();
@@ -2378,6 +2382,7 @@ Do not include body_html in your response; Sendinel renders body_html from block
             const satisfied = new Set([
                 ...Object.keys(vars),
                 'brand_name', 'brand_logo_url', 'brand_bg_color', 'brand_text_color', 'brand_accent_color',
+                'brand_logo_html', 'brand_font', 'brand_address',
                 ...Object.keys(NAME_FALLBACKS),
             ]);
             const missing = requiredVars.filter((name) => !satisfied.has(name));
@@ -2385,14 +2390,14 @@ Do not include body_html in your response; Sendinel renders body_html from block
                 return txt(`Error: Missing required template variable(s): ${missing.join(', ')}`);
             }
             if (template.format === 'text') {
-                resolvedText = renderTemplateVars(template.body_text ?? '', renderVars);
+                resolvedText = renderTemplateVars(template.body_text ?? '', renderVars, { brandTokens: brandVars });
                 resolvedHtml = undefined;
             }
             else {
-                resolvedHtml = renderTemplateVars(template.body_html ?? '', renderVars);
+                resolvedHtml = renderTemplateVars(template.body_html ?? '', renderVars, { brandTokens: brandVars });
                 resolvedText = text ?? stripHtml(resolvedHtml);
             }
-            resolvedSubject = subject?.trim() || renderTemplateVars(template.subject_hint ?? '', renderVars);
+            resolvedSubject = subject?.trim() || renderTemplateVars(template.subject_hint ?? '', renderVars, { brandTokens: brandVars });
         }
         if (!resolvedSubject?.trim())
             return txt('Error: subject is required');
@@ -2432,6 +2437,7 @@ Do not include body_html in your response; Sendinel renders body_html from block
         }).select('id').single();
         return j({
             sent: true,
+            ...(brandWarningCodes.length ? { warnings: brandWarningCodes } : {}),
             id: logRow?.id,
             to,
             provider: sendResult.provider,
@@ -2525,7 +2531,7 @@ Do not include body_html in your response; Sendinel renders body_html from block
         // Site verification
         const { data: site } = await db()
             .from('sites')
-            .select('from_email, from_name, name, brand_voice')
+            .select('from_email, from_name, name, brand_voice, physical_address')
             .eq('id', site_id)
             .eq('project_id', projectId)
             .maybeSingle();
@@ -2534,6 +2540,7 @@ Do not include body_html in your response; Sendinel renders body_html from block
         let resolvedSubject = subject;
         let resolvedHtml = html;
         let resolvedText = text;
+        let brandWarningCodes = [];
         if (template_id) {
             const { data: template, error: templateError } = await db()
                 .from('campaign_templates')
@@ -2549,7 +2556,10 @@ Do not include body_html in your response; Sendinel renders body_html from block
             const projectBrand = (project?.brand_settings ?? null);
             const siteBrand = (site.brand_voice ?? null);
             const mergedBrand = projectBrand || siteBrand ? { ...(projectBrand ?? {}), ...(siteBrand ?? {}) } : null;
-            const brandVars = resolveBrandTokens(mergedBrand, site.name || undefined);
+            const brandVars = resolveBrandTokens(mergedBrand, site.name || undefined, { address: site.physical_address ?? undefined });
+            brandWarningCodes = brandWarnings(mergedBrand);
+            if (brandWarningCodes.length)
+                console.warn('MCP send brand warnings', { projectId, site_id, warnings: brandWarningCodes });
             const vars = template_vars ?? {};
             const renderVars = { ...brandVars, ...vars };
             const subjectFallingBack = !subject?.trim();
@@ -2561,6 +2571,7 @@ Do not include body_html in your response; Sendinel renders body_html from block
             const satisfied = new Set([
                 ...Object.keys(vars),
                 'brand_name', 'brand_logo_url', 'brand_bg_color', 'brand_text_color', 'brand_accent_color',
+                'brand_logo_html', 'brand_font', 'brand_address',
                 ...Object.keys(NAME_FALLBACKS),
             ]);
             const missing = requiredVars.filter((name) => !satisfied.has(name));
@@ -2568,14 +2579,14 @@ Do not include body_html in your response; Sendinel renders body_html from block
                 return txt(`Error: Missing required template variable(s): ${missing.join(', ')}`);
             }
             if (template.format === 'text') {
-                resolvedText = renderTemplateVars(template.body_text ?? '', renderVars);
+                resolvedText = renderTemplateVars(template.body_text ?? '', renderVars, { brandTokens: brandVars });
                 resolvedHtml = undefined;
             }
             else {
-                resolvedHtml = renderTemplateVars(template.body_html ?? '', renderVars);
+                resolvedHtml = renderTemplateVars(template.body_html ?? '', renderVars, { brandTokens: brandVars });
                 resolvedText = text ?? stripHtml(resolvedHtml);
             }
-            resolvedSubject = subject?.trim() || renderTemplateVars(template.subject_hint ?? '', renderVars);
+            resolvedSubject = subject?.trim() || renderTemplateVars(template.subject_hint ?? '', renderVars, { brandTokens: brandVars });
         }
         if (!resolvedSubject?.trim())
             return txt('Error: subject is required');
@@ -2666,6 +2677,7 @@ Do not include body_html in your response; Sendinel renders body_html from block
         }).eq('id', logRow.id);
         return j({
             sent: true,
+            ...(brandWarningCodes.length ? { warnings: brandWarningCodes } : {}),
             id: logRow.id,
             reply_action_id: minted.id,
             correlation_id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendinel/mcp-server",
-  "version": "1.0.92",
+  "version": "1.0.94",
   "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",