@sendinel/mcp-server 1.0.17 → 1.0.19

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/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.17",
+  "version": "1.0.19",
   "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",