@sendinel/mcp-server 1.0.0

package/build/tools/warmup.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { db } from '../db.js';
+import { getProjectId } from '../project.js';
+const j = (data) => ({ content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] });
+export function registerWarmupTools(server) {
+    server.registerTool('get_warmup_status', {
+        description: 'Get warmup status for a sending site.',
+        inputSchema: { site_id: z.string().uuid() },
+    }, async ({ site_id }) => {
+        const { data, error } = await db().from('domain_health')
+            .select('warmup_day, warmup_daily_limit, total_sent, check_date')
+            .eq('project_id', getProjectId())
+            .eq('site_id', site_id)
+            .order('check_date', { ascending: false })
+            .limit(1)
+            .maybeSingle();
+        if (error)
+            return j({ error: error.message });
+        const day = data?.warmup_day ?? 0;
+        return j({
+            phase: day >= 42 ? 'complete' : day > 0 ? 'warming' : 'not_started',
+            daily_limit: data?.warmup_daily_limit ?? null,
+            current_volume: data?.total_sent ?? 0,
+            started_at: data?.check_date ?? null,
+            progress_pct: Math.min(100, Math.round((day / 42) * 100)),
+            next_milestone: day >= 42 ? null : `Day ${Math.min(42, day + 1)}`,
+        });
+    });
+    server.registerTool('update_warmup_schedule', {
+        description: 'Update warmup daily limit or phase metadata for a site.',
+        inputSchema: { site_id: z.string().uuid(), daily_limit: z.number().int().min(1).optional(), phase: z.string().optional() },
+    }, async ({ site_id, daily_limit, phase }) => {
+        const { error } = await db().from('warmup_schedules')
+            .upsert({ project_id: getProjectId(), site_id, target_volume: daily_limit ?? null, status: phase ?? 'active', updated_at: new Date().toISOString() }, { onConflict: 'site_id' });
+        if (error)
+            return j({ error: error.message });
+        return j({ updated: true });
+    });
+    server.registerTool('pause_warmup', {
+        description: 'Pause warmup for a sending site.',
+        inputSchema: { site_id: z.string().uuid(), reason: z.string().optional() },
+    }, async ({ site_id, reason }) => {
+        const { error } = await db().from('warmup_schedules').upsert({ project_id: getProjectId(), site_id, status: 'paused', pause_reason: reason ?? null, updated_at: new Date().toISOString() }, { onConflict: 'site_id' });
+        if (error)
+            return j({ error: error.message });
+        return j({ paused: true });
+    });
+    server.registerTool('resume_warmup', {
+        description: 'Resume warmup for a sending site.',
+        inputSchema: { site_id: z.string().uuid() },
+    }, async ({ site_id }) => {
+        const { error } = await db().from('warmup_schedules').upsert({ project_id: getProjectId(), site_id, status: 'active', updated_at: new Date().toISOString() }, { onConflict: 'site_id' });
+        if (error)
+            return j({ error: error.message });
+        return j({ resumed: true });
+    });
+}

package/build/tools/webhooks.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerWebhookTools(server: McpServer): void;

package/build/tools/webhooks.js

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+import { db } from '../db.js';
+import { getProjectId } from '../project.js';
+import { validateWebhookUrl, generateWebhookSecret } from '../lib/webhook-events.js';
+const txt = (text) => ({ content: [{ type: 'text', text }] });
+const j = (data) => txt(JSON.stringify(data, null, 2));
+const VALID_EVENTS = [
+    'campaign.activated',
+    'campaign.completed',
+    'campaign.paused',
+    'email.delivered',
+    'email.bounced',
+    'email.complained',
+    'bounce_rate.warning',
+    'domain.dns_lost',
+    'approval.requested',
+    'approval.decided',
+    'social.post.created',
+    'social.post.updated',
+    'social.post.scheduled',
+    'social.post.published',
+    'social.post.failed',
+    'social.post.archived',
+];
+export function registerWebhookTools(server) {
+    server.registerTool('subscribe_webhook', {
+        description: `Register a webhook URL to receive push notifications when events occur. Sendinel signs each payload with HMAC-SHA256 so you can verify authenticity. Valid events: ${VALID_EVENTS.join(', ')}`,
+        inputSchema: {
+            url: z.string().url().describe('HTTPS endpoint that will receive POST requests'),
+            events: z.array(z.enum(VALID_EVENTS)).min(1).describe('Events to subscribe to'),
+            description: z.string().optional().describe('Human-readable label, e.g. "Production orchestrator"'),
+        },
+    }, async ({ url, events, description }) => {
+        // SSRF protection
+        const validation = validateWebhookUrl(url);
+        if (!validation.valid)
+            return txt(`Invalid URL: ${validation.reason}`);
+        const secret = generateWebhookSecret();
+        const { data, error } = await db()
+            .from('webhook_subscriptions')
+            .insert({
+            project_id: getProjectId(),
+            url,
+            secret,
+            events,
+            description: description ?? null,
+        })
+            .select('id, url, events, active, created_at')
+            .single();
+        if (error)
+            return txt(`Error creating subscription: ${error.message}`);
+        return j({
+            ...data,
+            secret, // Only returned on creation — store it securely
+            message: `Webhook registered. Store the secret — it won't be shown again. Sendinel will POST to ${url} with X-Sendinel-Signature header for verification.`,
+            verification_example: `const expected = crypto.createHmac('sha256', secret).update(requestBody).digest('hex'); if (header === 'sha256=' + expected) { /* valid */ }`,
+        });
+    });
+    server.registerTool('list_webhook_subscriptions', {
+        description: 'List all webhook subscriptions for this project. Secrets are redacted — only shown on creation.',
+        inputSchema: {
+            include_inactive: z.boolean().optional().default(false),
+        },
+    }, async ({ include_inactive }) => {
+        let q = db()
+            .from('webhook_subscriptions')
+            .select('id, url, events, active, description, created_at, updated_at')
+            .eq('project_id', getProjectId())
+            .order('created_at', { ascending: false });
+        if (!include_inactive)
+            q = q.eq('active', true);
+        const { data, error } = await q;
+        if (error)
+            return txt(`Error: ${error.message}`);
+        return j({ subscriptions: data ?? [], count: data?.length ?? 0 });
+    });
+    server.registerTool('update_webhook_subscription', {
+        description: 'Update a webhook subscription — change URL, events, or active status.',
+        inputSchema: {
+            subscription_id: z.string().uuid(),
+            url: z.string().url().optional(),
+            events: z.array(z.enum(VALID_EVENTS)).min(1).optional(),
+            active: z.boolean().optional(),
+            description: z.string().optional(),
+        },
+    }, async ({ subscription_id, url, events, active, description }) => {
+        if (url) {
+            const validation = validateWebhookUrl(url);
+            if (!validation.valid)
+                return txt(`Invalid URL: ${validation.reason}`);
+        }
+        const updates = { updated_at: new Date().toISOString() };
+        if (url !== undefined)
+            updates.url = url;
+        if (events !== undefined)
+            updates.events = events;
+        if (active !== undefined)
+            updates.active = active;
+        if (description !== undefined)
+            updates.description = description;
+        const { data, error } = await db()
+            .from('webhook_subscriptions')
+            .update(updates)
+            .eq('id', subscription_id)
+            .eq('project_id', getProjectId())
+            .select('id, url, events, active, description, updated_at')
+            .single();
+        if (error)
+            return txt(`Error: ${error.message}`);
+        return j(data);
+    });
+    server.registerTool('delete_webhook_subscription', {
+        description: 'Permanently delete a webhook subscription. This also deletes all delivery history for this subscription.',
+        inputSchema: {
+            subscription_id: z.string().uuid(),
+        },
+    }, async ({ subscription_id }) => {
+        const { error } = await db()
+            .from('webhook_subscriptions')
+            .delete()
+            .eq('id', subscription_id)
+            .eq('project_id', getProjectId());
+        if (error)
+            return txt(`Error: ${error.message}`);
+        return txt(`Subscription ${subscription_id} deleted.`);
+    });
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@sendinel/mcp-server",
+  "version": "1.0.0",
+  "description": "AI-controlled email operations control plane for campaigns, contacts, segments, analytics, and multi-provider sending via MCP.",
+  "mcpName": "io.github.kmdesle/sendinel",
+  "type": "module",
+  "bin": {
+    "sendinel-mcp": "build/index.js"
+  },
+  "files": [
+    "build/",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "npm --prefix ../models run build",
+    "clean": "node -e \"require('node:fs').rmSync('build', { recursive: true, force: true })\"",
+    "dev": "tsx src/index.ts",
+    "dev:http": "MCP_TRANSPORT=http tsx src/index.ts",
+    "build": "npm run clean && tsc",
+    "start": "node build/index.js",
+    "start:http": "MCP_TRANSPORT=http node build/index.js",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.93.0",
+    "@desler/models": "file:../models",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@supabase/supabase-js": "^2.98.0",
+    "dotenv": "^16.4.7",
+    "express": "^5.2.1",
+    "resend": "^6.9.3",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.3",
+    "@types/node": "^26.0.1",
+    "tsx": "^4.19.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "sendinel",
+    "email",
+    "claude",
+    "cursor",
+    "codex"
+  ],
+  "homepage": "https://sendinel.ai/developer",
+  "bugs": {
+    "url": "https://github.com/kmdesle/sendinel-ai/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kmdesle/sendinel-ai.git"
+  },
+  "license": "UNLICENSED"
+}