@sendora/mcp 1.8.16 → 1.9.0

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

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

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

@@ -356,7 +356,7 @@ button:focus-visible {
   }
 
   // src/version.ts
-  var MCP_VERSION = "1.8.16";
+  var MCP_VERSION = "1.9.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 { addTrackingDomainTool, checkTrackingDomainTool, listTrackingDomainsTool, } from './tools/tracking-domains.js';
 import { createWebhookTool, deleteWebhookTool, listWebhookDeliveriesTool, listWebhooksTool, replayWebhookDeliveryTool, } from './tools/webhooks.js';
 /**
  * Every tool the server has, with its class, its reach and the operations it
@@ -47,5 +48,8 @@ export const toolTable = [
     listDomainsTool,
     checkDomainTool,
     addDomainTool,
+    listTrackingDomainsTool,
+    checkTrackingDomainTool,
+    addTrackingDomainTool,
     deleteTestServerTool,
 ];

package/dist/tools/tracking-domains.js

@@ -0,0 +1,155 @@
+import { z } from 'zod';
+import { toolError } from '../errors.js';
+import { READING } from '../tool.js';
+import { accountConnectionOf } from './servers.js';
+const trackingDomainOutput = z.object({
+    trackingDomainId: z.string().describe('What check_tracking_domain checks it by.'),
+    host: z.string().describe('The host tracked links and the open pixel use.'),
+    sendingDomainId: z
+        .string()
+        .nullable()
+        .describe('The sending domain whose new mail will use the host; null once that domain is deleted.'),
+    state: z
+        .enum([
+        'pending',
+        'waiting_for_certificate',
+        'ready',
+        'failing',
+        'stopped',
+        'sending_domain_lost',
+    ])
+        .describe('pending: the records have not been right yet. waiting_for_certificate: the records are right. ready: new mail from the sending domain uses the host. failing: a check found the records wrong, and new mail keeps using a host that was ready until 24 hours after failingSince. stopped: those 24 hours have passed. sending_domain_lost: the sending domain is deleted or has lost its verification.'),
+    createdAt: z.string().describe('When it was added.'),
+    lastCheckedAt: z.string().nullable().describe('When the records were last looked up.'),
+    certificateReadyAt: z
+        .string()
+        .nullable()
+        .describe('When the certificate was proved to work; null before that.'),
+    failingSince: z
+        .string()
+        .nullable()
+        .describe('When a check first found the records wrong on a host whose records have been right.'),
+    expiresAt: z
+        .string()
+        .nullable()
+        .describe('When a host whose records have never been right goes; null once they have been.'),
+    cname: z
+        .object({
+        type: z.literal('CNAME').describe('The record type.'),
+        host: z.string().describe('The name to create the record under.'),
+        value: z.string().describe('The value the record must hold.'),
+        check: z
+            .enum(['ok', 'missing', 'mismatch', 'proxied', 'dns_error'])
+            .nullable()
+            .describe('What the last check found; null before the first. mismatch is a record that points elsewhere, an A record included. proxied is a proxy in front of the name, which must be switched off. dns_error is a resolver failure and changes nothing.'),
+    })
+        .describe('The CNAME record for the user to add.'),
+    caa: z
+        .object({
+        check: z
+            .enum(['ok', 'no_lets_encrypt', 'other_account', 'no_http_01', 'dns_error'])
+            .nullable()
+            .describe('What the last check of the CAA records on the host and its parents found; null before the first. dns_error is a resolver failure and changes nothing.'),
+        record: z
+            .object({
+            type: z.literal('CAA').describe('The record type.'),
+            host: z.string().describe('The name that holds the CAA records in the way.'),
+            value: z.string().describe('The record to add beside them.'),
+        })
+            .nullable()
+            .describe('What lets the certificate be issued; null unless the check found a problem.'),
+    })
+        .describe('Whether CAA records let Let’s Encrypt issue the certificate.'),
+});
+export const listTrackingDomainsTool = {
+    name: 'list_tracking_domains',
+    title: 'List the tracking domains',
+    class: 'read',
+    reach: 'account',
+    operations: ['GET /v1/tracking-domains'],
+    register: (server, { connection }) => server.registerTool('list_tracking_domains', {
+        title: 'List the tracking domains',
+        description: "Lists the account's tracking domains, the hosts that tracked links and the open pixel use, each with the CNAME record it needs, its state and what the last check found. check_tracking_domain looks them up now. Tracking is not open to accounts yet, so a host carries no mail until it is.",
+        inputSchema: z.object({}),
+        outputSchema: z.object({
+            trackingDomains: z
+                .array(trackingDomainOutput)
+                .describe('Every tracking domain of the account.'),
+        }),
+        annotations: READING,
+    }, async () => {
+        try {
+            const list = await accountConnectionOf(connection).account.trackingDomains.list();
+            return {
+                content: [{ type: 'text', text: JSON.stringify(list) }],
+                structuredContent: list,
+            };
+        }
+        catch (error) {
+            return toolError(error, connection);
+        }
+    }),
+};
+export const checkTrackingDomainTool = {
+    name: 'check_tracking_domain',
+    title: 'Check a tracking domain',
+    class: 'read',
+    reach: 'account',
+    operations: ['POST /v1/tracking-domains/{id}/verify'],
+    register: (server, { connection }) => server.registerTool('check_tracking_domain', {
+        title: 'Check a tracking domain',
+        description: "Looks up the CNAME and the CAA records of one of the account's tracking domains now and answers it as it stands. A record just added may take a while to be seen. A dns_error changes nothing. A check that finds the records of a host wrong after they have been right begins a 24-hour warning and mails the account's administrators, as Sendora's own checks do.",
+        inputSchema: z.object({
+            trackingDomainId: z
+                .uuid()
+                .describe('The tracking domain, from list_tracking_domains or add_tracking_domain.'),
+        }),
+        outputSchema: trackingDomainOutput,
+        annotations: { ...READING, openWorldHint: true },
+    }, async ({ trackingDomainId }) => {
+        try {
+            const domain = await accountConnectionOf(connection).account.trackingDomains.verify(trackingDomainId);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(domain) }],
+                structuredContent: domain,
+            };
+        }
+        catch (error) {
+            return toolError(error, connection);
+        }
+    }),
+};
+export const addTrackingDomainTool = {
+    name: 'add_tracking_domain',
+    title: 'Add a tracking domain',
+    class: 'write',
+    reach: 'account',
+    operations: ['POST /v1/tracking-domains'],
+    register: (server, { connection }) => server.registerTool('add_tracking_domain', {
+        title: 'Add a tracking domain',
+        description: "Claims a host under one of the account's verified sending domains for tracked links and the open pixel, and answers the CNAME record for the user to add to the domain's DNS. check_tracking_domain then looks it up. A host whose records are not right within 7 days goes. Tracking is not open to accounts yet, so a host carries no mail until it is. This is for tracking only: add_domain adds the domain mail is sent from.",
+        inputSchema: z.object({
+            host: z
+                .string()
+                .describe('The host, such as links.example.se: a subdomain of a verified sending domain, never the domain itself.'),
+        }),
+        outputSchema: trackingDomainOutput,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (request) => {
+        try {
+            const domain = await accountConnectionOf(connection).account.trackingDomains.create(request);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(domain) }],
+                structuredContent: domain,
+            };
+        }
+        catch (error) {
+            return toolError(error, connection);
+        }
+    }),
+};

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendora/mcp",
-  "version": "1.8.16",
+  "version": "1.9.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.0.2"
+    "@sendora/sdk": "^5.1.0"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "2.1.2",