@sendinel/mcp-server 1.0.94 → 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 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/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.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",