@sendora/mcp 1.11.0 → 1.12.0

package/dist/generated/screens/domain-records.html

@@ -360,7 +360,7 @@ button:focus-visible {
   }
 
   // src/version.ts
-  var MCP_VERSION = "1.11.0";
+  var MCP_VERSION = "1.12.0";
 
   // screens/host.ts
   var PROTOCOL_VERSION = "2026-01-26";

package/dist/generated/screens/message-timeline.html

@@ -360,7 +360,7 @@ button:focus-visible {
   }
 
   // src/version.ts
-  var MCP_VERSION = "1.11.0";
+  var MCP_VERSION = "1.12.0";
 
   // screens/host.ts
   var PROTOCOL_VERSION = "2026-01-26";

package/dist/tool-table.js

@@ -10,6 +10,7 @@ import { getServerTool } from './tools/server.js';
 import { deleteTestServerTool, listServersTool } from './tools/servers.js';
 import { archiveStreamTool, createStreamTool } from './tools/streams.js';
 import { listSuppressionsTool, removeSuppressionTool } from './tools/suppressions.js';
+import { addTrackingOptOutTool, listTrackingOptOutsTool, removeTrackingOptOutTool, } from './tools/tracking-opt-outs.js';
 import { addTrackingDomainTool, checkTrackingDomainTool, listTrackingDomainsTool, } from './tools/tracking-domains.js';
 import { createWebhookTool, deleteWebhookTool, listWebhookDeliveriesTool, listWebhooksTool, replayWebhookDeliveryTool, } from './tools/webhooks.js';
 /**
@@ -26,6 +27,9 @@ export const toolTable = [
     getMessageTool,
     listSuppressionsTool,
     removeSuppressionTool,
+    listTrackingOptOutsTool,
+    addTrackingOptOutTool,
+    removeTrackingOptOutTool,
     createStreamTool,
     archiveStreamTool,
     sendBroadcastTool,

package/dist/tools/tracking-opt-outs.js

@@ -0,0 +1,135 @@
+import { z } from 'zod';
+import { toolError } from '../errors.js';
+import { READING } from '../tool.js';
+import { modesOf, registerServerTool } from '../target.js';
+export const trackingOptOutOutput = z.object({
+    address: z
+        .string()
+        .nullable()
+        .describe('The recipient, lower-cased. Null once an erasure has left only a keyed hash.'),
+    source: z
+        .enum(['manual', 'recipient'])
+        .describe('manual: added through the API or the dashboard. recipient: the recipient asked for it.'),
+    messageId: z
+        .string()
+        .nullable()
+        .describe('The message that a recipient asked from. Null on a manual entry, and once that message or the address has gone.'),
+    createdAt: z.string().describe('When it was put on the list.'),
+});
+export const removedTrackingOptOutOutput = z.object({
+    address: z.string().describe('The address taken off the list.'),
+});
+const NOT_OPEN_YET = 'Tracking is not open to accounts yet, so the list changes nothing until it is.';
+export const listTrackingOptOutsTool = {
+    name: 'list_tracking_opt_outs',
+    title: 'List the not-tracked addresses',
+    class: 'read',
+    reach: 'server',
+    operations: ['GET /v1/tracking-opt-outs'],
+    register: (server, { connection, targets }) => registerServerTool(server, targets, 'list_tracking_opt_outs', {
+        title: 'List the not-tracked addresses',
+        description: `Lists the addresses this server never tracks, on any of its streams, newest first. An entry whose address is null was erased, and only a keyed hash of it remains. ${NOT_OPEN_YET}`,
+        inputSchema: z.object({
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .default(20)
+                .describe('Addresses per page, 1 to 100.'),
+            after: z.uuid().optional().describe('The next value of the previous page.'),
+        }),
+        outputSchema: z.object({
+            trackingOptOuts: z.array(trackingOptOutOutput).describe('The page of the list.'),
+            next: z
+                .string()
+                .nullable()
+                .describe('Pass as after for the next page; null on the last.'),
+        }),
+        annotations: READING,
+    }, async (query, { sendora }) => {
+        try {
+            const page = await sendora.trackingOptOuts.list(query);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(page) }],
+                structuredContent: page,
+            };
+        }
+        catch (error) {
+            return toolError(error, connection);
+        }
+    }),
+};
+export const addTrackingOptOutTool = {
+    name: 'add_tracking_opt_out',
+    title: 'Add a not-tracked address',
+    class: 'write',
+    reach: 'server',
+    operations: ['POST /v1/tracking-opt-outs'],
+    register: (server, { connection, targets }) => registerServerTool(server, targets, 'add_tracking_opt_out', {
+        title: 'Add a not-tracked address',
+        description: `Puts an address on this server's not-tracked list. New mail to it goes untracked, and its later opens and clicks are not recorded, from mail already sent too. An address already on the list changes nothing, and the answer is its entry as it stands. ${NOT_OPEN_YET}`,
+        inputSchema: z.object({
+            address: z.email().describe('The address never to track.'),
+        }),
+        outputSchema: trackingOptOutOutput,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ address }, { sendora }) => {
+        try {
+            const entry = await sendora.trackingOptOuts.add({ address });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(entry) }],
+                structuredContent: entry,
+            };
+        }
+        catch (error) {
+            return toolError(error, connection);
+        }
+    }),
+};
+const REMOVE_DESCRIPTION = "Takes an address off this server's not-tracked list, so its mail can be tracked again. Remove an entry whose source is recipient only after the recipient has given new consent. An erased entry is found by its address too.";
+function removeDescription(modes) {
+    if (!modes.includes('live')) {
+        return REMOVE_DESCRIPTION;
+    }
+    const server = modes.includes('test') ? 'a live server' : 'this live server';
+    return `${REMOVE_DESCRIPTION} On ${server} the address is a real person's: confirm with the user first.`;
+}
+export const removeTrackingOptOutTool = {
+    name: 'remove_tracking_opt_out',
+    title: 'Remove a not-tracked address',
+    class: 'write',
+    reach: 'server',
+    operations: ['POST /v1/tracking-opt-outs/delete'],
+    register: (server, { connection, targets }) => registerServerTool(server, targets, 'remove_tracking_opt_out', {
+        title: 'Remove a not-tracked address',
+        description: removeDescription(modesOf(targets)),
+        inputSchema: z.object({
+            address: z.email().describe('The address to track again.'),
+        }),
+        outputSchema: removedTrackingOptOutOutput,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ address }, { sendora }) => {
+        try {
+            await sendora.trackingOptOuts.delete({ address });
+        }
+        catch (error) {
+            return toolError(error, connection);
+        }
+        const output = { address };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(output) }],
+            structuredContent: output,
+        };
+    }),
+};

package/dist/version.js

@@ -1,2 +1,2 @@
 /** This package's version, held equal to its package.json by a test. */
-export const MCP_VERSION = '1.11.0';
+export const MCP_VERSION = '1.12.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendora/mcp",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "The official MCP server for Sendora: its documentation and API for coding agents.",
   "license": "MIT",
   "type": "module",
@@ -25,7 +25,7 @@
   "dependencies": {
     "@modelcontextprotocol/server": "^2.1.0",
     "zod": "^4.6.2",
-    "@sendora/sdk": "^5.3.0"
+    "@sendora/sdk": "^5.4.0"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "2.1.2",