@sendinel/mcp-server 1.0.93 → 1.0.95

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 339 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,12 +23,12 @@ 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 |
 | `connector` | 6 | BYOD connector status, table discovery, schema/view setup, mapping, resync |
-| `contacts` | 37 | Subscriber CRUD, saved views, tags, email log, suppression, merge, timeline |
+| `contacts` | 38 | Subscriber CRUD, saved views, tags, email log, suppression, merge, timeline |
 | `content` | 14 | Content blocks, gated asset links, blog ingest and auto-publish, sources |
 | `data` | 19 | Platform connectors, imports, API keys, migration jobs, notifications, tenant export |
 | `data-proposals` | 3 | Data-derived campaign proposal generation, listing, approval |

package/build/lib/action-approvals.js

@@ -53,6 +53,7 @@ const GATED_ACTIONS = new Set([
     'revoke_api_key', // breaks every integration using the key
     'tenant_export_full', // copies all customer data out of Sendinel
     'enroll_contact', // starts real emails to a contact
+    'identify_subscriber', // may enroll a new signup in sending campaigns
     'enroll_automation', // starts automated messages to a contact
     'enroll_in_escalation_ladder', // starts email/SMS escalation to a contact
     'set_contact_sms_consent', // changes the consent record that allows texting

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

@@ -82,7 +82,7 @@ export const ALL_TOOL_GROUPS = Object.keys(GROUP_REGISTRY);
 const WRITE_TOOLS = new Set([
     'recheck_domain_dns',
     'mark_agent_message', 'draft_agent_reply', 'create_agent_mailbox',
-    'add_subscriber', 'import_subscribers', 'update_subscriber', 'bulk_update_subscribers',
+    'add_subscriber', 'identify_subscriber', 'import_subscribers', 'update_subscriber', 'bulk_update_subscribers',
     'create_subscriber_view', 'update_subscriber_view', 'delete_subscriber_view',
     'enrich_subscriber',
     'create_campaign', 'update_campaign', 'delete_campaign', 'add_campaign_step', 'update_campaign_status',
@@ -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/contacts.js

@@ -3,6 +3,7 @@ import { CONTACT_ENRICHMENT_PROVIDERS } from '@desler/models';
 import { createContactEnrichmentAdapters, enrichContactFromConnections, } from '@desler/models/contact-enrichment';
 import { buildPreviewAttentionEnvelope, applySegmentRules, ContactPropertyAnomalyLogger, normalizeContactProperties, getAttentionDecision, getContactNeighborhood, getScheduledTouches, findContactDuplicateGroups, readAllPages, readAllRows, chunkIds, } from '@sendinel/domain';
 import { z } from 'zod';
+import { callSendinelV1 } from '../lib/v1-client.js';
 import { db, projectClientForWriteback } from '../db.js';
 import { getProjectId } from '../project.js';
 import { checkPlanLimit } from '../plan-limits.js';
@@ -535,6 +536,25 @@ async function exportSubscriberData(projectId, contactId) {
     };
 }
 export function registerContactTools(server) {
+    server.registerTool('identify_subscriber', {
+        title: 'Identify Subscriber',
+        description: 'Identify or update a contact through the v1 identify API. Optional signup/customer consent subscribes new or existing contacts without overriding opt-outs. Customer consent requires a topic; consent requires site_id. Without consent, site_id retains legacy create-only subscription behavior and returns a warning.',
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+        inputSchema: {
+            approval_id: z.string().uuid().optional().describe('Call once to request approval, then repeat the same arguments with the approved approval_id.'),
+            email: z.string().email(),
+            first_name: z.string().optional(),
+            last_name: z.string().optional(),
+            properties: z.record(z.string(), z.unknown()).optional(),
+            tags: z.array(z.string()).optional(),
+            site_id: z.string().uuid().optional(),
+            consent: z.enum(['signup', 'customer']).optional(),
+            topic: z.string().regex(/^[a-z0-9_]{1,64}$/).optional(),
+        },
+    }, withApproval('identify_subscriber', async (params) => {
+        const result = await callSendinelV1('/api/v1/identify', { method: 'POST', body: params });
+        return result.ok ? j(result.data) : err(JSON.stringify(result.error));
+    }));
     server.registerTool('get_subscriber_timeline', {
         title: 'Get Subscriber Timeline',
         annotations: {

package/package.json

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