@sendinel/mcp-server 1.0.18 → 1.0.20

package/README.md

@@ -12,7 +12,7 @@ AI-controlled email operations control plane for campaigns, contacts, segments,
 
 ## Tool groups
 
-Sendinel currently exposes 34 tool groups and 311 tools (gateway mode adds 3 meta-tools). These counts are checked against the tool registry in CI, so this table matches what ships.
+Sendinel currently exposes 34 tool groups and 314 tools (gateway mode adds 3 meta-tools). These counts are checked against the tool registry in CI, so this table matches what ships.
 
 | Group | Count | Purpose |
 |-------|-------|---------|
@@ -45,7 +45,7 @@ Sendinel currently exposes 34 tool groups and 311 tools (gateway mode adds 3 met
 | `sites` | 5 | Site, sender, and brand voice management |
 | `skills` | 2 | Operator skills catalog |
 | `sms` | 7 | SMS send, log, consent, inbound |
-| `social-posts` | 6 | Social post creation, adaptation, scheduling state, archive/delete |
+| `social-posts` | 9 | Social post creation, adaptation, scheduling state, connection health, engagement reads, archive/delete |
 | `surveys` | 5 | Survey creation, listing, status, results |
 | `templates` | 7 | Email template CRUD, version restore, migration translation |
 | `warmup` | 4 | IP/domain warmup schedule control |

package/build/tools/contacts.js

@@ -2241,16 +2241,30 @@ Requirements: urgency without desperation, acknowledge the gap, one clear CTA, v
         });
         if (error) {
             // Fallback: inline query if RPC not yet available
-            const { data: rows, error: qErr } = await db()
-                .from('subscribers')
-                .select('custom_properties')
-                .eq('project_id', projectId)
-                .eq('source_site', site_id)
-                .not('custom_properties', 'is', null)
-                .order('created_at', { ascending: false })
-                .limit(500);
-            if (qErr)
-                return txt(`Error: ${qErr.message}`);
+            const SCHEMA_SAMPLE_LIMIT = 500;
+            async function sampleSubscriberProperties(scopeToSite) {
+                let query = db()
+                    .from('subscribers')
+                    .select('custom_properties')
+                    .eq('project_id', projectId)
+                    .not('custom_properties', 'is', null)
+                    .order('created_at', { ascending: false });
+                if (scopeToSite)
+                    query = query.eq('source_site', site_id);
+                return query.limit(SCHEMA_SAMPLE_LIMIT);
+            }
+            const siteSample = await sampleSubscriberProperties(true);
+            if (siteSample.error)
+                return txt(`Error: ${siteSample.error.message}`);
+            let rows = siteSample.data ?? [];
+            let scope = 'site';
+            if (rows.length === 0) {
+                const projectSample = await sampleSubscriberProperties(false);
+                if (projectSample.error)
+                    return txt(`Error: ${projectSample.error.message}`);
+                rows = projectSample.data ?? [];
+                scope = 'project';
+            }
             const keyMap = new Map();
             for (const row of rows ?? []) {
                 const props = row.custom_properties;
@@ -2277,9 +2291,12 @@ Requirements: urgency without desperation, acknowledge the gap, one clear CTA, v
             }));
             return j({
                 site_id,
+                scope,
                 total_keys: schema.length,
                 schema,
-                note: 'Use merge_tag syntax in email body/subject. For sensitive data, add a fallback: {{custom.plan|subscriber}}. ⚠️ custom_properties data passes through the Anthropic API — avoid storing sensitive PII (SSNs, passwords, financial account numbers).',
+                note: scope === 'project'
+                    ? `No contacts are tagged to site ${site_id} via source_site — sampled custom_properties across the whole project instead. Use merge_tag syntax in email body/subject. For sensitive data, add a fallback: {{custom.plan|subscriber}}. ⚠️ custom_properties data passes through the Anthropic API — avoid storing sensitive PII (SSNs, passwords, financial account numbers).`
+                    : 'Use merge_tag syntax in email body/subject. For sensitive data, add a fallback: {{custom.plan|subscriber}}. ⚠️ custom_properties data passes through the Anthropic API — avoid storing sensitive PII (SSNs, passwords, financial account numbers).',
             });
         }
         return j({

package/build/tools/social-posts.js

@@ -13,7 +13,27 @@ const PLATFORMS = [
     'instagram', 'linkedin', 'twitter', 'x', 'facebook', 'tiktok',
     'youtube', 'pinterest', 'threads', 'reddit', 'bluesky', 'google_business',
 ];
-const STATUSES = ['draft', 'scheduled', 'queued', 'publishing', 'published', 'failed', 'archived'];
+const STATUSES = ['draft', 'scheduled', 'queued', 'publishing', 'published', 'partially_published', 'failed', 'archived'];
+const ENGAGEMENT_STATUSES = ['open', 'replied', 'dismissed', 'failed', 'expired'];
+const SOCIAL_CONNECTION_COLUMNS = [
+    'platform', 'account_name', 'account_id', 'account_status', 'expires_at',
+    'follower_count', 'follower_count_synced_at', 'updated_at', 'created_at',
+];
+const SOCIAL_ENGAGEMENT_LIST_COLUMNS = [
+    'id', 'social_post_id', 'platform', 'engagement_type', 'direction',
+    'sender_name', 'sender_handle', 'body', 'status', 'received_at',
+    'responded_at', 'created_at',
+];
+// `metadata` is deliberately not selected: nothing in the dashboard writes it, so its contents are
+// unknown, and the v1 social-inbox route keeps to this same plain column list. Re-add it only once
+// something defines what it holds.
+const SOCIAL_ENGAGEMENT_DETAIL_COLUMNS = [
+    ...SOCIAL_ENGAGEMENT_LIST_COLUMNS,
+    'dismissed_at',
+];
+function selectFields(row, columns) {
+    return Object.fromEntries(columns.map((column) => [column, row[column]]));
+}
 function cleanText(value) {
     return typeof value === 'string' && value.trim() ? value.trim() : null;
 }
@@ -101,6 +121,103 @@ async function requireProjectCampaign(campaignId) {
         throw new Error('Email campaign not found for this project');
 }
 export function registerSocialPostTools(server) {
+    server.registerTool('list_social_connections', {
+        title: 'List Social Connections',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        description: 'List this organization\'s connected social accounts with platform, account identity, connection status, and when access expires. Use before scheduling to detect no connected accounts, expired access, or a reauth-required status.',
+        inputSchema: {},
+    }, async () => {
+        const projectId = getProjectId();
+        const { data: project, error: projectError } = await db()
+            .from('projects')
+            .select('org_id')
+            .eq('id', projectId)
+            .maybeSingle();
+        if (projectError)
+            return txt(`Error: ${projectError.message}`);
+        if (!project?.org_id)
+            return txt('Error: Project organization not found.');
+        const { data, error } = await db()
+            .from('social_platform_connections')
+            .select(SOCIAL_CONNECTION_COLUMNS.join(', '))
+            .eq('org_id', project.org_id)
+            .order('platform', { ascending: true });
+        if (error)
+            return txt(`Error: ${error.message}`);
+        const connections = (data ?? [])
+            .map((row) => selectFields(row, SOCIAL_CONNECTION_COLUMNS));
+        if (connections.length === 0) {
+            return j({ connections: [], message: 'No social accounts are connected.' });
+        }
+        return j({ connections });
+    });
+    server.registerTool('list_social_engagements', {
+        title: 'List Social Engagements',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        description: 'List inbound social inbox engagements such as comments, replies, direct messages, and mentions across connected platforms. Read-only: this tool never responds on a user\'s behalf.',
+        inputSchema: {
+            status: z.enum([...ENGAGEMENT_STATUSES, 'all']).optional().default('open'),
+            platform: z.string().optional(),
+            social_post_id: z.string().uuid().optional(),
+            limit: z.number().int().min(1).max(200).optional().default(50),
+        },
+    }, async ({ status, platform, social_post_id, limit }) => {
+        let query = db()
+            .from('social_engagements')
+            .select(SOCIAL_ENGAGEMENT_LIST_COLUMNS.join(', '))
+            .eq('project_id', getProjectId())
+            .eq('direction', 'inbound')
+            .order('received_at', { ascending: false })
+            .limit(limit ?? 50);
+        if (status && status !== 'all')
+            query = query.eq('status', status);
+        if (platform)
+            query = query.eq('platform', platform);
+        if (social_post_id)
+            query = query.eq('social_post_id', social_post_id);
+        const { data, error } = await query;
+        if (error)
+            return txt(`Error: ${error.message}`);
+        const engagements = (data ?? [])
+            .map((row) => selectFields(row, SOCIAL_ENGAGEMENT_LIST_COLUMNS));
+        if (engagements.length === 0) {
+            return j({ engagements: [], message: 'No social engagements matched the requested filters.' });
+        }
+        return j({ engagements });
+    });
+    server.registerTool('get_social_engagement', {
+        title: 'Get Social Engagement',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        description: 'Get one inbound social inbox engagement, including a comment, reply, direct message, or mention, for human review. Read-only: this tool does not respond.',
+        inputSchema: { engagement_id: z.string().uuid() },
+    }, async ({ engagement_id }) => {
+        const { data, error } = await db()
+            .from('social_engagements')
+            .select(SOCIAL_ENGAGEMENT_DETAIL_COLUMNS.join(', '))
+            .eq('project_id', getProjectId())
+            .eq('id', engagement_id)
+            .maybeSingle();
+        if (error)
+            return txt(`Error: ${error.message}`);
+        if (!data)
+            return j({ error: 'Social engagement not found', code: 'NOT_FOUND' });
+        return j(selectFields(data, SOCIAL_ENGAGEMENT_DETAIL_COLUMNS));
+    });
     server.registerTool('list_social_posts', {
         title: 'List Social Posts',
         annotations: {

package/package.json

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