@sendora/mcp 1.3.1 → 1.4.0

package/dist/tools/suppressions.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { toolError } from '../errors.js';
 import { READING } from '../tool.js';
-import { serverConnectionOf } from './server.js';
+import { modesOf, registerServerTool } from '../target.js';
 export const suppressionOutput = z.object({
     streamId: z.string().describe('The stream whose list the address is on.'),
     address: z.string().describe('The recipient, lower-cased.'),
@@ -26,7 +26,7 @@ export const listSuppressionsTool = {
     class: 'read',
     reach: 'server',
     operations: ['GET /v1/suppressions'],
-    register: (server, { connection }) => server.registerTool('list_suppressions', {
+    register: (server, { connection, targets }) => registerServerTool(server, targets, 'list_suppressions', {
         title: "List a stream's suppression list",
         description: 'Lists the addresses one stream of this server will not send to, and why: a hard bounce, a spam complaint, an unsubscribe or a manual entry. A send to one of them is refused with recipient_suppressed; a hard bounce or a manual entry can be lifted with remove_suppression.',
         inputSchema: z.object({
@@ -48,20 +48,27 @@ export const listSuppressionsTool = {
                 .describe('Pass as after for the next page; null on the last.'),
         }),
         annotations: READING,
-    }, async (query) => {
+    }, async (query, { sendora }) => {
         try {
-            const page = await serverConnectionOf(connection).sendora.suppressions.list(query);
+            const page = await sendora.suppressions.list(query);
             return {
                 content: [{ type: 'text', text: JSON.stringify(page) }],
                 structuredContent: page,
             };
         }
         catch (error) {
-            return toolError(error);
+            return toolError(error, connection);
         }
     }),
 };
 const REMOVE_DESCRIPTION = "Lifts an address from one stream's suppression list so this server may send to it again on that stream: a hard bounce or a manual entry. A spam complaint or an unsubscribe cannot be lifted, since the recipient asked.";
+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.`;
+}
 /** `remove_suppression` (docs/design/mcp.md §4.2): a hard bounce or a manual entry lifted. */
 export const removeSuppressionTool = {
     name: 'remove_suppression',
@@ -69,36 +76,31 @@ export const removeSuppressionTool = {
     class: 'write',
     reach: 'server',
     operations: ['POST /v1/suppressions/delete'],
-    register: (server, { connection }) => {
-        const { kind, sendora } = serverConnectionOf(connection);
-        server.registerTool('remove_suppression', {
-            title: 'Lift a suppression',
-            description: kind === 'live'
-                ? `${REMOVE_DESCRIPTION} On this live server the address is a real person's: confirm with the user first.`
-                : REMOVE_DESCRIPTION,
-            inputSchema: z.object({
-                address: z.email().describe('The address to send to again.'),
-                streamId: z.uuid().optional().describe(STREAM),
-            }),
-            outputSchema: removedOutput,
-            annotations: {
-                readOnlyHint: false,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, async ({ address, streamId }) => {
-            try {
-                await sendora.suppressions.delete({ address, streamId });
-            }
-            catch (error) {
-                return toolError(error);
-            }
-            const output = { address, streamId: streamId ?? null };
-            return {
-                content: [{ type: 'text', text: JSON.stringify(output) }],
-                structuredContent: output,
-            };
-        });
-    },
+    register: (server, { connection, targets }) => registerServerTool(server, targets, 'remove_suppression', {
+        title: 'Lift a suppression',
+        description: removeDescription(modesOf(targets)),
+        inputSchema: z.object({
+            address: z.email().describe('The address to send to again.'),
+            streamId: z.uuid().optional().describe(STREAM),
+        }),
+        outputSchema: removedOutput,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ address, streamId }, { sendora }) => {
+        try {
+            await sendora.suppressions.delete({ address, streamId });
+        }
+        catch (error) {
+            return toolError(error, connection);
+        }
+        const output = { address, streamId: streamId ?? null };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(output) }],
+            structuredContent: output,
+        };
+    }),
 };

package/dist/tools/webhooks.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { toolError } from '../errors.js';
 import { READING } from '../tool.js';
-import { serverConnectionOf } from './server.js';
+import { registerServerTool } from '../target.js';
 const eventName = z.enum([
     'delivered',
     'bounced',
@@ -88,7 +88,7 @@ export const listWebhooksTool = {
     class: 'read',
     reach: 'server',
     operations: ['GET /v1/webhooks'],
-    register: (server, { connection }) => server.registerTool('list_webhooks', {
+    register: (server, { connection, targets }) => registerServerTool(server, targets, 'list_webhooks', {
         title: "List the server's webhooks",
         description: "Lists this server's webhooks: where each posts, which events and stream, whether it is switched on, and its signing secrets by id and age. A secret's value is shown once, when it is made, and never answered again.",
         inputSchema: z.object({}),
@@ -96,16 +96,16 @@ export const listWebhooksTool = {
             webhooks: z.array(webhookOutput).describe("The server's webhooks."),
         }),
         annotations: READING,
-    }, async () => {
+    }, async (_input, { sendora }) => {
         try {
-            const list = await serverConnectionOf(connection).sendora.webhooks.list();
+            const list = await sendora.webhooks.list();
             return {
                 content: [{ type: 'text', text: JSON.stringify(list) }],
                 structuredContent: list,
             };
         }
         catch (error) {
-            return toolError(error);
+            return toolError(error, connection);
         }
     }),
 };
@@ -116,7 +116,7 @@ export const listWebhookDeliveriesTool = {
     class: 'read',
     reach: 'server',
     operations: ['GET /v1/webhooks/{id}/deliveries'],
-    register: (server, { connection }) => server.registerTool('list_webhook_deliveries', {
+    register: (server, { connection, targets }) => registerServerTool(server, targets, 'list_webhook_deliveries', {
         title: "List a webhook's deliveries",
         description: "Lists the events on their way to one webhook, newest first: pending with its next attempt, delivered, or dead after its retries, with the endpoint's last answer. A dead delivery can be sent again with replay_webhook_delivery.",
         inputSchema: z.object({
@@ -142,16 +142,16 @@ export const listWebhookDeliveriesTool = {
                 .describe('Pass as after for the next page; null on the last.'),
         }),
         annotations: READING,
-    }, async ({ webhookId: id, ...query }) => {
+    }, async ({ webhookId: id, ...query }, { sendora }) => {
         try {
-            const page = await serverConnectionOf(connection).sendora.webhooks.deliveries(id, query);
+            const page = await sendora.webhooks.deliveries(id, query);
             return {
                 content: [{ type: 'text', text: JSON.stringify(page) }],
                 structuredContent: page,
             };
         }
         catch (error) {
-            return toolError(error);
+            return toolError(error, connection);
         }
     }),
 };
@@ -162,7 +162,7 @@ export const replayWebhookDeliveryTool = {
     class: 'write',
     reach: 'server',
     operations: ['POST /v1/webhooks/{id}/deliveries/{deliveryId}/replay'],
-    register: (server, { connection }) => server.registerTool('replay_webhook_delivery', {
+    register: (server, { connection, targets }) => registerServerTool(server, targets, 'replay_webhook_delivery', {
         title: 'Replay a webhook delivery',
         description: 'Queues one delivery of a webhook again, whatever its state, with the same payload and a fresh signature: for an endpoint that was down or was fixed. Its count of attempts carries on, so a delivery that had used every retry is dead again after one more failure. Each replay posts the event once more.',
         inputSchema: z.object({
@@ -176,16 +176,16 @@ export const replayWebhookDeliveryTool = {
             idempotentHint: false,
             openWorldHint: false,
         },
-    }, async ({ webhookId: id, deliveryId }) => {
+    }, async ({ webhookId: id, deliveryId }, { sendora }) => {
         try {
-            const delivery = await serverConnectionOf(connection).sendora.webhooks.replay(id, deliveryId);
+            const delivery = await sendora.webhooks.replay(id, deliveryId);
             return {
                 content: [{ type: 'text', text: JSON.stringify(delivery) }],
                 structuredContent: delivery,
             };
         }
         catch (error) {
-            return toolError(error);
+            return toolError(error, connection);
         }
     }),
 };
@@ -196,7 +196,7 @@ export const createWebhookTool = {
     class: 'secret',
     reach: 'server',
     operations: ['POST /v1/webhooks'],
-    register: (server, { connection }) => server.registerTool('create_webhook', {
+    register: (server, { connection, targets }) => registerServerTool(server, targets, 'create_webhook', {
         title: 'Add a webhook',
         description: "Adds a webhook to this test server and answers its signing secret, shown this once: put it in the project's environment, such as SENDORA_WEBHOOK_SECRET in .env, never in a file under version control, and verify every delivery with the SDK: webhooks.receive or verifyWebhook in TypeScript, verify_webhook in Python. The API takes only a public https URL, so a local endpoint needs a tunnel. Events arrive as the simulator plays out each message.",
         inputSchema: createWebhookInput,
@@ -207,16 +207,16 @@ export const createWebhookTool = {
             idempotentHint: false,
             openWorldHint: false,
         },
-    }, async (request) => {
+    }, async (request, { sendora }) => {
         try {
-            const created = await serverConnectionOf(connection).sendora.webhooks.create(request);
+            const created = await sendora.webhooks.create(request);
             return {
                 content: [{ type: 'text', text: JSON.stringify(created) }],
                 structuredContent: created,
             };
         }
         catch (error) {
-            return toolError(error);
+            return toolError(error, connection);
         }
     }),
 };
@@ -227,7 +227,7 @@ export const deleteWebhookTool = {
     class: 'irreversible',
     reach: 'server',
     operations: ['DELETE /v1/webhooks/{id}'],
-    register: (server, { connection }) => server.registerTool('delete_webhook', {
+    register: (server, { connection, targets }) => registerServerTool(server, targets, 'delete_webhook', {
         title: 'Delete a webhook',
         description: 'Deletes a webhook of this test server with its secrets and deliveries; nothing more is posted to it, and it cannot be restored.',
         inputSchema: z.object({ webhookId }),
@@ -240,12 +240,12 @@ export const deleteWebhookTool = {
             idempotentHint: true,
             openWorldHint: false,
         },
-    }, async ({ webhookId: id }) => {
+    }, async ({ webhookId: id }, { sendora }) => {
         try {
-            await serverConnectionOf(connection).sendora.webhooks.delete(id);
+            await sendora.webhooks.delete(id);
         }
         catch (error) {
-            return toolError(error);
+            return toolError(error, connection);
         }
         const output = { webhookId: id };
         return {

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendora/mcp",
-  "version": "1.3.1",
+  "version": "1.4.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": "^4.0.0"
+    "@sendora/sdk": "^4.1.0"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "2.1.2",
@@ -38,10 +38,10 @@
     "typescript": "~7.0.2",
     "vitest": "^4.1.11",
     "@sendora/api": "0.0.0",
-    "@sendora/observability": "0.0.0",
+    "@sendora/db": "0.0.0",
     "@sendora/domain": "0.0.0",
-    "@sendora/site": "0.0.0",
-    "@sendora/db": "0.0.0"
+    "@sendora/observability": "0.0.0",
+    "@sendora/site": "0.0.0"
   },
   "scripts": {
     "build": "pnpm --filter @sendora/sdk build && node scripts/build-docs.ts && node -e \"fs.rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json && node -e \"fs.mkdirSync('dist/generated',{recursive:true});fs.copyFileSync('src/generated/docs.json','dist/generated/docs.json')\"",