@buzzposter/mcp 0.2.3 → 0.3.0

package/dist/index.js

@@ -107,6 +107,13 @@ var BuzzPosterClient = class {
   async deleteMedia(key) {
     return this.request("DELETE", `/api/v1/media/${encodeURIComponent(key)}`);
   }
+  // Newsletter Preview (no ESP required)
+  async createPreview(data) {
+    return this.request("POST", "/api/v1/newsletters/preview", data);
+  }
+  async updatePreview(id, data) {
+    return this.request("PUT", `/api/v1/newsletters/preview/${id}`, data);
+  }
   // Newsletter
   async listSubscribers(params) {
     return this.request(
@@ -1140,8 +1147,8 @@ function registerNewsletterTools(server2, client2, options = {}) {
     server2,
     "create_newsletter",
     {
-      title: "Create Newsletter Draft",
-      description: "Push a newsletter to the user's ESP as a draft. Always call get_brand_voice first. Show an HTML preview to the user before calling this. Use table-based layouts, inline CSS only, 600px max width, email-safe fonts only (Arial, Helvetica, Georgia, Verdana), all images must use absolute URLs, keep under 102KB to avoid Gmail clipping. Optionally pass template_id to use an ESP-native template. Use list_esp_templates to discover available templates.",
+      title: "Create Newsletter Preview",
+      description: "Create a newsletter preview. Uploads HTML to a preview URL for review in Newsletter Studio. Does NOT push to ESP \u2014 use push_newsletter_to_esp for that. Always call get_brand_voice first. Use table-based layouts, inline CSS only, 600px max width, email-safe fonts only (Arial, Helvetica, Georgia, Verdana), all images must use absolute URLs, keep under 102KB to avoid Gmail clipping.",
       inputSchema: {
         subject: z5.string().describe("Email subject line"),
         content: z5.string().describe("HTML content of the newsletter"),
@@ -1175,7 +1182,7 @@ function registerNewsletterTools(server2, client2, options = {}) {
         previewText: args.preview_text
       };
       if (args.template_id) payload.templateId = args.template_id;
-      const result = await client2.createBroadcast(payload);
+      const result = await client2.createPreview(payload);
       const response = {
         ...result,
         subject: args.subject,
@@ -1191,15 +1198,15 @@ function registerNewsletterTools(server2, client2, options = {}) {
   );
   server2.tool(
     "update_newsletter",
-    "Update an existing newsletter draft.",
+    "Update an existing newsletter preview.",
     {
-      broadcast_id: z5.string().describe("The broadcast/newsletter ID to update"),
+      preview_id: z5.string().describe("The preview ID to update"),
       subject: z5.string().optional().describe("Updated subject line"),
       content: z5.string().optional().describe("Updated HTML content"),
       preview_text: z5.string().optional().describe("Updated preview text")
     },
     {
-      title: "Update Newsletter Draft",
+      title: "Update Newsletter Preview",
       readOnlyHint: false,
       destructiveHint: false,
       idempotentHint: true,
@@ -1210,7 +1217,44 @@ function registerNewsletterTools(server2, client2, options = {}) {
       if (args.subject) data.subject = args.subject;
       if (args.content) data.content = args.content;
       if (args.preview_text) data.previewText = args.preview_text;
-      const result = await client2.updateBroadcast(args.broadcast_id, data);
+      const result = await client2.updatePreview(args.preview_id, data);
+      const response = {
+        ...result,
+        subject: args.subject,
+        content: args.content,
+        previewText: args.preview_text
+      };
+      return {
+        content: [
+          { type: "text", text: JSON.stringify(response, null, 2) }
+        ]
+      };
+    }
+  );
+  server2.tool(
+    "push_newsletter_to_esp",
+    "Push a newsletter to the user's ESP as a draft broadcast. Requires ESP to be configured. Use create_newsletter first for preview, then push when the user is happy with the content.",
+    {
+      subject: z5.string().describe("Email subject line"),
+      content: z5.string().describe("HTML content of the newsletter"),
+      preview_text: z5.string().optional().describe("Preview text shown in email clients"),
+      template_id: z5.string().optional().describe("ESP-native template ID")
+    },
+    {
+      title: "Push Newsletter to ESP",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
+    async (args) => {
+      const payload = {
+        subject: args.subject,
+        content: args.content,
+        previewText: args.preview_text
+      };
+      if (args.template_id) payload.templateId = args.template_id;
+      const result = await client2.createBroadcast(payload);
       const response = {
         ...result,
         subject: args.subject,