@zyphr-dev/mcp-server 0.1.0

package/src/tools/webhooks.ts

@@ -0,0 +1,82 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { getZyphrClient } from '../client.js';
+import { isToolEnabled, type ToolGuards } from '../config.js';
+import { runTool } from '../result.js';
+import {
+  createWebhookShape,
+  getWebhookDeliveriesShape,
+  listWebhooksShape,
+} from '../schemas.js';
+
+export function registerWebhookTools(server: McpServer, guards: ToolGuards): void {
+  if (isToolEnabled({ name: 'list_webhooks', mutates: false }, guards)) {
+    server.registerTool(
+      'list_webhooks',
+      {
+        title: 'List webhooks',
+        description: 'List webhook endpoints configured for the account.',
+        inputSchema: listWebhooksShape,
+      },
+      async (args) => {
+        return runTool(async () => {
+          const zyphr = getZyphrClient();
+          return await zyphr.webhooks.listWebhooks(args.limit, args.offset);
+        });
+      },
+    );
+  }
+
+  if (isToolEnabled({ name: 'create_webhook', mutates: true }, guards)) {
+    server.registerTool(
+      'create_webhook',
+      {
+        title: 'Create webhook',
+        description:
+          'Register a new webhook endpoint. Subscribe to event types like "email.*", "subscriber.created", or "*".',
+        inputSchema: createWebhookShape,
+      },
+      async (args) => {
+        return runTool(async () => {
+          const zyphr = getZyphrClient();
+          return await zyphr.webhooks.createWebhook({
+            url: args.url,
+            events: args.events,
+            description: args.description,
+            secret: args.secret,
+            metadata: args.metadata,
+            headers: args.headers,
+            version: args.version,
+            rateLimit: args.rateLimit,
+          });
+        });
+      },
+    );
+  }
+
+  if (isToolEnabled({ name: 'get_webhook_deliveries', mutates: false }, guards)) {
+    server.registerTool(
+      'get_webhook_deliveries',
+      {
+        title: 'List webhook deliveries',
+        description:
+          'Inspect delivery history for a webhook endpoint. Filter by status (pending/delivering/delivered/failed/exhausted), event type, or date range. Useful for debugging why a webhook is not firing.',
+        inputSchema: getWebhookDeliveriesShape,
+      },
+      async (args) => {
+        return runTool(async () => {
+          const zyphr = getZyphrClient();
+          return await zyphr.webhooks.listWebhookDeliveries(
+            args.webhookId,
+            args.status,
+            args.eventType,
+            args.search,
+            args.startDate ? new Date(args.startDate) : undefined,
+            args.endDate ? new Date(args.endDate) : undefined,
+            args.limit,
+            args.offset,
+          );
+        });
+      },
+    );
+  }
+}