@sendora/mcp 1.9.1 → 1.11.0

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

@@ -97,6 +97,10 @@ time {
   line-height: var(--font-text-xs-line-height, 1.4);
 }
 
+.reason {
+  overflow-wrap: anywhere;
+}
+
 .badge {
   display: inline-block;
   padding: 1px 8px;
@@ -356,7 +360,7 @@ button:focus-visible {
   }
 
   // src/version.ts
-  var MCP_VERSION = "1.9.1";
+  var MCP_VERSION = "1.11.0";
 
   // screens/host.ts
   var PROTOCOL_VERSION = "2026-01-26";

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

@@ -97,6 +97,10 @@ time {
   line-height: var(--font-text-xs-line-height, 1.4);
 }
 
+.reason {
+  overflow-wrap: anywhere;
+}
+
 .badge {
   display: inline-block;
   padding: 1px 8px;
@@ -356,7 +360,7 @@ button:focus-visible {
   }
 
   // src/version.ts
-  var MCP_VERSION = "1.9.1";
+  var MCP_VERSION = "1.11.0";
 
   // screens/host.ts
   var PROTOCOL_VERSION = "2026-01-26";
@@ -541,7 +545,14 @@ button:focus-visible {
     AdminRebind: "Rerouted",
     DeferredInjectionRebind: "Rerouted",
     Rejection: "Refused",
-    Delayed: "Delayed"
+    Delayed: "Delayed",
+    Open: "Opened",
+    Click: "Clicked"
+  };
+  var automatedWords = {
+    likely: "Likely a machine",
+    unlikely: "Likely a person",
+    unknown: "A person or a machine"
   };
   var SETTLED = /* @__PURE__ */ new Set(["delivered", "bounced", "expired"]);
   function isMessage(content) {
@@ -588,6 +599,11 @@ button:focus-visible {
     );
   }
   function reasonOf(event) {
+    if (event.tracking !== null) {
+      const who = automatedWords[event.tracking.automated];
+      const url = event.tracking.link?.url ?? null;
+      return url === null ? who : `${who}: ${url}`;
+    }
     const code = event.code === null ? "" : String(event.code);
     const details = event.details ?? "";
     const said = details.startsWith(code) ? details : `${code} ${details}`.trim();

package/dist/tools/broadcasts.js

@@ -41,6 +41,26 @@ export const broadcastOutput = z.object({
         .nullable()
         .describe('When nothing was left to send, or it was cancelled.'),
 });
+export const broadcastDetailOutput = broadcastOutput.extend({
+    opened: z
+        .number()
+        .int()
+        .describe("Recipients with an open, machines' included, or a click that was likely a person's."),
+    openedByPeople: z.number().int().describe('Those of them likely to be people.'),
+    clicked: z.number().int().describe("Recipients who clicked a link, machines' included."),
+    clickedByPeople: z.number().int().describe('Those of them likely to be people.'),
+    links: z
+        .array(z.object({
+        index: z.number().int().describe("The link's position in the HTML, counting from 0."),
+        url: z
+            .string()
+            .nullable()
+            .describe('Where the first click led, since a substitution can give a link another URL per recipient; null once it has gone with the content.'),
+        clicked: z.number().int().describe("Recipients who clicked this link, machines' included."),
+        clickedByPeople: z.number().int().describe('Those of them likely to be people.'),
+    }))
+        .describe('Each tracked link that has a click, by its index, counted from the clicks each recipient keeps.'),
+});
 /** The SDK's request for the tool's input. */
 export function broadcastRequestOf(input) {
     const fields = {
@@ -104,9 +124,9 @@ export const getBroadcastTool = {
     operations: ['GET /v1/broadcasts/{id}'],
     register: (server, { connection, targets }) => registerServerTool(server, targets, 'get_broadcast', {
         title: 'Read a broadcast',
-        description: 'Reads a broadcast of this server and how far it has come: released and failed move as its messages leave, and status is completed once none is left. Each of its messages is in the log; search_messages with its broadcastId finds them.',
+        description: 'Reads a broadcast of this server and how far it has come: released and failed move as its messages leave, and status is completed once none is left. Where its mail is tracked, it also counts the recipients who opened and clicked, and those likely to be people, in all and per link. Each of its messages is in the log; search_messages with its broadcastId finds them.',
         inputSchema: broadcastIdInput,
-        outputSchema: broadcastOutput,
+        outputSchema: broadcastDetailOutput,
         annotations: READING,
     }, async ({ broadcastId }, { sendora }) => {
         try {

package/dist/tools/messages.js

@@ -25,6 +25,19 @@ export const messageOutput = z.object({
         address: z.string().describe('The recipient.'),
         kind: z.enum(['to', 'cc', 'bcc']).describe('Whether it was in to, cc or bcc.'),
         status: recipientStatus.describe('queued until the receiver answers; delivered, bounced or expired once it has settled; deferred while it is retried.'),
+        tracked: z
+            .boolean()
+            .describe('Whether tracking applied to its copy when it left. It does not say to opens, links or both, or that the HTML held a link to track.'),
+        opens: z.number().int().describe("Opens recorded, machines' included."),
+        clicks: z.number().int().describe("Clicks recorded, machines' included."),
+        firstOpenAt: z
+            .string()
+            .nullable()
+            .describe("The first open, or the first click that was likely a person's."),
+        firstHumanOpenAt: z
+            .string()
+            .nullable()
+            .describe('The same, counting only what was likely a person.'),
     }))
         .describe('Each recipient and its state: queued, delivered, deferred, bounced or expired.'),
 });
@@ -47,8 +60,10 @@ export const messageEventOutput = z.object({
         'DeferredInjectionRebind',
         'Rejection',
         'Delayed',
+        'Open',
+        'Click',
     ])
-        .describe('Reception when the mail server took it, Delivery, TransientFailure for a deferral, Bounce, OOB for a bounce report by mail, Feedback for a spam complaint, and the rest.'),
+        .describe('Reception when the mail server took it, Delivery, TransientFailure for a deferral, Bounce, OOB for a bounce report by mail, Feedback for a spam complaint, Open and Click for what tracking recorded, and the rest.'),
     at: z.string().describe('When it happened.'),
     code: z.number().int().nullable().describe('The SMTP status code the receiver answered.'),
     details: z.string().nullable().describe("The receiver's response text."),
@@ -56,8 +71,83 @@ export const messageEventOutput = z.object({
         .string()
         .nullable()
         .describe('How a bounce was classified, such as InvalidRecipient.'),
+    tracking: z
+        .object({
+        automated: z
+            .enum(['likely', 'unlikely', 'unknown'])
+            .describe("Whether a machine rather than a person did it: unknown where nobody can tell, as with Apple's privacy protection."),
+        agent: z
+            .enum([
+            'apple_privacy',
+            'gmail_prefetch',
+            'gmail_proxy',
+            'yahoo_proxy',
+            'outlook_prefetch',
+            'proton_proxy',
+            'scanner',
+            'crawler',
+        ])
+            .nullable()
+            .describe('The proxy or machine it came through, where Sendora knows it.'),
+        reasons: z
+            .array(z.enum([
+            'privacy_proxy',
+            'prefetch_signature',
+            'delivery_timing',
+            'link_burst',
+            'scanner_network',
+            'bot_user_agent',
+            'many_networks',
+        ]))
+            .describe("Why it was labelled a machine's."),
+        client: z
+            .enum([
+            'apple_mail',
+            'gmail',
+            'outlook',
+            'yahoo',
+            'thunderbird',
+            'proton',
+            'browser',
+            'other',
+        ])
+            .nullable()
+            .describe('The mail program, where Sendora knows it.'),
+        device: z
+            .enum(['desktop', 'mobile', 'tablet'])
+            .nullable()
+            .describe('The kind of device, where Sendora knows it.'),
+        first: z.boolean().describe("The recipient's first event of this kind."),
+        firstHuman: z
+            .boolean()
+            .describe("The recipient's first event of this kind that was likely a person's."),
+        link: z
+            .object({
+            index: z.number().int().describe("The link's position in the HTML, counting from 0."),
+            url: z
+                .string()
+                .nullable()
+                .describe("Where it led; null once it has gone with the message's text and HTML."),
+        })
+            .nullable()
+            .describe('The link clicked; null on an Open.'),
+    })
+        .nullable()
+        .describe('What tracking knows of an Open or a Click; null on any other event.'),
 });
 export const messageDetailOutput = messageOutput.extend({
+    tracking: z
+        .object({
+        recordingOpens: z
+            .boolean()
+            .describe("Whether new opens are recorded now, by the message's own setting, then its broadcast's, then its stream's at this moment. It says nothing of what a copy already sent carries; each recipient's tracked says whether its copy was tracked."),
+        recordingClicks: z.boolean().describe('The same for clicks on its links.'),
+        skipped: z
+            .enum(['no_tracking_domain', 'gmail_clipping'])
+            .nullable()
+            .describe('Why tracking stayed out of at least one copy: the from domain had no working tracking domain, or tracked links would have taken the HTML past where Gmail clips it.'),
+    })
+        .describe('Whether opens and clicks are recorded now, and why tracking may have stayed out.'),
     attachments: z
         .array(z.object({
         name: z.string().describe('The file name.'),
@@ -68,7 +158,7 @@ export const messageDetailOutput = messageOutput.extend({
         .describe('Each attachment described; the content is never returned.'),
     events: z
         .array(messageEventOutput)
-        .describe("The timeline, oldest event first, with the receiver's answer: Reception, Delivery, TransientFailure, Bounce, Feedback for a complaint and more."),
+        .describe("The timeline, oldest event first, with the receiver's answer: Reception, Delivery, TransientFailure, Bounce, Feedback for a complaint and more, and Open and Click where the message was tracked. Opens and clicks are capped, while each recipient's opens and clicks count them all."),
 });
 export const searchInput = z.object({
     recipient: z
@@ -135,7 +225,7 @@ export const getMessageTool = {
     screen: messageTimeline,
     register: (server, { connection, targets }) => registerServerTool(server, targets, 'get_message', {
         title: 'Read one message and its timeline',
-        description: "Reads one message of this server's log by its messageId: its recipients and their state, its attachments described but never their content, and every event on its timeline, oldest first, with the receiver's answer. The body is never returned.",
+        description: "Reads one message of this server's log by its messageId: its recipients and their state, its attachments described but never their content, and the events on its timeline, oldest first, with the receiver's answer and any opens and clicks. The body is never returned.",
         inputSchema: z.object({
             messageId: z.uuid().describe('The message, from send_email or search_messages.'),
         }),

package/dist/tools/webhooks.js

@@ -8,6 +8,8 @@ const eventName = z.enum([
     'deferred',
     'spam_complaint',
     'unsubscribed',
+    'opened',
+    'clicked',
     'cap_warning',
     'cap_reached',
     'inbound',
@@ -73,7 +75,7 @@ export const createWebhookInput = z.object({
         .array(eventName)
         .min(1)
         .optional()
-        .describe('The events to deliver; every event when left out.'),
+        .describe('The events to deliver; every event except opened and clicked when left out.'),
     streamId: z
         .uuid()
         .optional()

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.9.1';
+export const MCP_VERSION = '1.11.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendora/mcp",
-  "version": "1.9.1",
+  "version": "1.11.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.1.0"
+    "@sendora/sdk": "^5.3.0"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "2.1.2",