@sendinel/mcp-server 1.0.94 → 1.0.96

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 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.
+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 |
 |-------|-------|---------|
@@ -28,7 +28,7 @@ Sendinel currently exposes 35 tool groups and 338 tools (gateway mode exposes 4
 | `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/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',

package/build/tools/campaigns.js

@@ -1,3 +1,4 @@
+import { CAMPAIGN_BRANCH_CONDITIONS, campaignBranchConditionValue } from "@sendinel/domain";
 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, brandWarnings, readAllRows, } from '@sendinel/domain';
@@ -296,7 +297,6 @@ function normalizeConsistencyResult(value) {
 //   app/api/dashboard/campaigns/goals/route.ts
 // If those lists change, change these. A value MCP accepts that REST rejects (or the
 // reverse) is a divergence between two front doors onto the same engine.
-const CAMPAIGN_BRANCH_CONDITIONS = ['tag_added', 'lifecycle_reached', 'conversion', 'link_clicked', 'custom_event', 'reply', 'click', 'booking'];
 const CAMPAIGN_BRANCH_ACTIONS = ['goto_step', 'goto_campaign', 'exit', 'complete'];
 const CAMPAIGN_GOAL_TYPES = ['conversion', 'tag_added', 'lifecycle_reached', 'link_clicked', 'custom_event'];
 const CAMPAIGN_GOAL_ACTIONS = ['exit', 'complete', 'move_to_campaign'];
@@ -3537,18 +3537,21 @@ Return ONLY valid JSON with this exact shape:
     server.registerTool('add_campaign_branch', {
         title: 'Add Campaign Branch',
         annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
-        description: 'Add an if/then rule to a campaign step so the sequence branches on what the contact does. Use this for conditional logic like: if they clicked the link send a different follow-up, if they replied skip ahead, if a tag was added move them to another campaign, otherwise continue. When the condition matches, the branch action runs instead of continuing to the next step. Lower priority is evaluated first.',
+        description: 'Add an if/then rule to a campaign step so the sequence branches on what the contact does or their current custom properties. Use this for conditional logic like: if they clicked the link send a different follow-up, if they replied skip ahead, if a tag was added move them to another campaign, otherwise continue. When the condition matches, the branch action runs instead of continuing to the next step. Lower priority is evaluated first.',
         inputSchema: {
             campaign_id: z.string().uuid(),
             from_step_id: z.string().uuid().describe('The step this branch leaves from'),
             condition_type: z.enum(CAMPAIGN_BRANCH_CONDITIONS).describe('What triggers the branch'),
-            condition_value: z.string().optional().describe('Condition argument, e.g. the tag name for tag_added or the URL for link_clicked'),
+            condition_value: z.union([z.string(), z.record(z.string(), z.unknown())]).optional().describe('Tag, URL or event name for existing conditions. For contact_property: {key, op: eq|neq, value: string} or {key, op: exists}; key matches [A-Za-z0-9_.-]{1,64}. Missing/null properties never match.'),
             action: z.enum(CAMPAIGN_BRANCH_ACTIONS).describe('goto_step and goto_campaign require their matching target'),
             target_step_id: z.string().uuid().optional().describe('Required when action is goto_step'),
             target_campaign_id: z.string().uuid().optional().describe('Required when action is goto_campaign'),
             priority: z.number().int().min(0).optional().default(0).describe('Lower runs first (default 0)'),
         },
     }, async ({ campaign_id, from_step_id, condition_type, condition_value, action, target_step_id, target_campaign_id, priority }) => {
+        const conditionValue = campaignBranchConditionValue(condition_type, condition_value);
+        if (!conditionValue.ok)
+            return { ...j({ error: conditionValue.error, code: 'INVALID_CONDITION_VALUE' }), isError: true };
         if (!(await campaignInProject(campaign_id)))
             return j({ error: 'Campaign not found in this project', code: 'CAMPAIGN_NOT_FOUND' });
         // Same requirement the REST route enforces: an action naming a target must have one,
@@ -3562,7 +3565,7 @@ Return ONLY valid JSON with this exact shape:
             campaign_id,
             from_step_id,
             condition_type,
-            condition_value: condition_value?.trim() || null,
+            condition_value: conditionValue.value,
             action,
             target_step_id: action === 'goto_step' ? target_step_id : null,
             target_campaign_id: action === 'goto_campaign' ? target_campaign_id : null,

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.94",
+  "version": "1.0.96",
   "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",