@buzzposter/mcp 0.3.5 → 0.3.7

package/dist/tools.js

@@ -112,6 +112,79 @@ var BuzzPosterClient = class {
   async uploadFromUrl(data) {
     return this.request("POST", "/api/v1/media/upload-from-url", data);
   }
+  async uploadFile(filePath, filename) {
+    const fs4 = await import("fs");
+    const pathMod = await import("path");
+    const buffer = fs4.readFileSync(filePath);
+    const name = filename || pathMod.basename(filePath);
+    const ext = pathMod.extname(name).toLowerCase();
+    const mimeMap = {
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".png": "image/png",
+      ".gif": "image/gif",
+      ".webp": "image/webp",
+      ".svg": "image/svg+xml",
+      ".mp4": "video/mp4",
+      ".mov": "video/quicktime",
+      ".webm": "video/webm"
+    };
+    const mime = mimeMap[ext] || "application/octet-stream";
+    const formData = new FormData();
+    formData.append("file", new Blob([buffer], { type: mime }), name);
+    const url = new URL(`${this.baseUrl}/api/v1/media/upload`);
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    if (this.organizationId) {
+      headers["X-Organization-Id"] = this.organizationId;
+    }
+    const res = await fetch(url, { method: "POST", headers, body: formData });
+    if (!res.ok) {
+      const errorBody = await res.json().catch(() => ({ message: res.statusText }));
+      let message = `API error (${res.status})`;
+      if (errorBody && typeof errorBody === "object") {
+        const b = errorBody;
+        if (typeof b.message === "string" && b.message) message = b.message;
+        else if (typeof b.error === "string" && b.error) message = b.error;
+      }
+      throw new Error(`BuzzPoster API error (${res.status}): ${message}`);
+    }
+    const text = await res.text();
+    return text ? JSON.parse(text) : void 0;
+  }
+  async uploadBase64(data, filename, contentType) {
+    const buffer = Buffer.from(data, "base64");
+    const mime = contentType || "application/octet-stream";
+    const formData = new FormData();
+    formData.append("file", new Blob([buffer], { type: mime }), filename);
+    const url = new URL(`${this.baseUrl}/api/v1/media/upload`);
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    if (this.organizationId) {
+      headers["X-Organization-Id"] = this.organizationId;
+    }
+    const res = await fetch(url, { method: "POST", headers, body: formData });
+    if (!res.ok) {
+      const errorBody = await res.json().catch(() => ({ message: res.statusText }));
+      let message = `API error (${res.status})`;
+      if (errorBody && typeof errorBody === "object") {
+        const b = errorBody;
+        if (typeof b.message === "string" && b.message) message = b.message;
+        else if (typeof b.error === "string" && b.error) message = b.error;
+      }
+      throw new Error(`BuzzPoster API error (${res.status}): ${message}`);
+    }
+    const text = await res.text();
+    return text ? JSON.parse(text) : void 0;
+  }
+  async presignUpload(filename, contentType) {
+    return this.request("POST", "/api/v1/media/presign", { filename, content_type: contentType });
+  }
+  async confirmUpload(key, filename, contentType) {
+    return this.request("POST", "/api/v1/media/confirm-upload", { key, filename, content_type: contentType });
+  }
   async listMedia() {
     return this.request("GET", "/api/v1/media");
   }
@@ -1252,14 +1325,17 @@ function registerMediaTools(server, client) {
     "manage_media",
     {
       title: "Manage Media",
-      description: "Browse assets gallery, upload from URL, list files, or delete media.",
+      description: "Browse assets gallery, upload from URL, local file, or base64 data, list files, or delete media.",
       inputSchema: {
-        action: z3.enum(["get_assets", "upload", "list", "delete"]),
+        action: z3.enum(["get_assets", "upload", "upload_file", "upload_base64", "presign", "confirm_upload", "list", "delete"]),
         limit: z3.number().optional().describe("Max assets to return (get_assets, default 10, max 20)"),
         url: z3.string().optional().describe("Public URL to upload (upload)"),
-        filename: z3.string().optional().describe("Filename override (upload)"),
+        file_path: z3.string().optional().describe("Local file path to upload (upload_file)"),
+        data: z3.string().optional().describe("Base64-encoded file contents (upload_base64)"),
+        content_type: z3.string().optional().describe("MIME type e.g. image/png (upload_base64, presign, confirm_upload)"),
+        filename: z3.string().optional().describe("Filename (upload, upload_file, upload_base64, presign, confirm_upload)"),
         folder: z3.string().optional().describe("Storage folder path (upload)"),
-        key: z3.string().optional().describe("Media file key/path (delete)"),
+        key: z3.string().optional().describe("Media file key/path (delete, confirm_upload)"),
         confirmed: z3.boolean().default(false).describe("Confirm deletion (delete)")
       },
       annotations: {
@@ -1336,6 +1412,92 @@ function registerMediaTools(server, client) {
           content: [{ type: "text", text: lines.join("\n") }]
         };
       }
+      if (args.action === "upload_file") {
+        if (!args.file_path) {
+          return { content: [{ type: "text", text: "file_path is required for upload_file." }], isError: true };
+        }
+        if (!fs2.existsSync(args.file_path)) {
+          return { content: [{ type: "text", text: `File not found: ${args.file_path}` }], isError: true };
+        }
+        const result = await client.uploadFile(args.file_path, args.filename);
+        const lines = [];
+        lines.push("## Upload Complete");
+        lines.push("");
+        lines.push(`**URL:** ${result.url ?? "unknown"}`);
+        lines.push(`**Filename:** ${result.filename ?? "unknown"}`);
+        lines.push(`**Size:** ${formatSize(result.size)}`);
+        lines.push(`**Type:** ${result.mimeType ?? "unknown"}`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
+      if (args.action === "upload_base64") {
+        if (!args.data) {
+          return { content: [{ type: "text", text: "data (base64 string) is required for upload_base64." }], isError: true };
+        }
+        if (!args.filename) {
+          return { content: [{ type: "text", text: "filename is required for upload_base64." }], isError: true };
+        }
+        const result = await client.uploadBase64(args.data, args.filename, args.content_type);
+        const lines = [];
+        lines.push("## Upload Complete");
+        lines.push("");
+        lines.push(`**URL:** ${result.url ?? "unknown"}`);
+        lines.push(`**Filename:** ${result.filename ?? "unknown"}`);
+        lines.push(`**Size:** ${formatSize(result.size)}`);
+        lines.push(`**Type:** ${result.mimeType ?? "unknown"}`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
+      if (args.action === "presign") {
+        if (!args.filename) {
+          return { content: [{ type: "text", text: "filename is required for presign." }], isError: true };
+        }
+        if (!args.content_type) {
+          return { content: [{ type: "text", text: "content_type is required for presign (e.g. image/png)." }], isError: true };
+        }
+        const result = await client.presignUpload(args.filename, args.content_type);
+        const lines = [];
+        lines.push("## Presigned Upload URL");
+        lines.push("");
+        lines.push(`**Upload URL:** ${result.upload_url}`);
+        lines.push(`**CDN URL:** ${result.cdn_url}`);
+        lines.push(`**Key:** ${result.key}`);
+        lines.push(`**Expires:** ${result.expires_at}`);
+        lines.push("");
+        lines.push("**Step 1:** Upload the file:");
+        lines.push("```");
+        lines.push(`curl -X PUT -H "Content-Type: ${args.content_type}" --data-binary @${args.filename} "${result.upload_url}"`);
+        lines.push("```");
+        lines.push("");
+        lines.push(`**Step 2:** Register the upload by calling this tool with action=confirm_upload, key="${result.key}", filename="${args.filename}", content_type="${args.content_type}"`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
+      if (args.action === "confirm_upload") {
+        if (!args.key) {
+          return { content: [{ type: "text", text: "key is required for confirm_upload." }], isError: true };
+        }
+        if (!args.filename) {
+          return { content: [{ type: "text", text: "filename is required for confirm_upload." }], isError: true };
+        }
+        if (!args.content_type) {
+          return { content: [{ type: "text", text: "content_type is required for confirm_upload." }], isError: true };
+        }
+        const result = await client.confirmUpload(args.key, args.filename, args.content_type);
+        const lines = [];
+        lines.push("## Upload Confirmed");
+        lines.push("");
+        lines.push(`**URL:** ${result.url}`);
+        lines.push(`**Filename:** ${result.filename}`);
+        lines.push(`**Size:** ${formatSize(result.size)}`);
+        lines.push(`**Type:** ${result.mimeType}`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
       if (args.action === "list") {
         const result = await client.listMedia();
         const items = result?.media ?? [];
@@ -1378,16 +1540,267 @@ This will permanently delete this media file. Call this tool again with confirme
   );
 }
 
-// src/tools/rss.ts
+// src/tools/newsletter.ts
 import { z as z4 } from "zod";
+function registerNewsletterTools(server, client, options = {}) {
+  server.tool(
+    "manage_newsletters",
+    "Create, update, send, schedule, or list newsletters.\n\nIMPORTANT \u2014 Template-based creation:\n1. Call get_context with include_newsletter_template=true to get the user's template with section IDs\n2. Call create with template_id + sections array (NOT raw content HTML)\n3. The server assembles styled HTML from the template design + your section content\n\nOnly use raw content HTML if the user has no templates or explicitly asks for custom HTML.",
+    {
+      action: z4.enum(["create", "update", "send", "schedule", "list"]),
+      broadcast_id: z4.string().optional().describe("Newsletter ID (update/send/schedule)"),
+      subject: z4.string().optional().describe("Subject line (create/update, also search keyword for list)"),
+      content: z4.string().optional().describe("Raw HTML content (create/update). Only use when no template is available or user explicitly requests custom HTML. When a template exists, use sections instead."),
+      sections: z4.array(z4.object({
+        section_id: z4.string().describe("Section ID from the template's section config"),
+        heading: z4.string().optional(),
+        body: z4.string().optional().describe("Section body (basic HTML OK: p, strong, em, a, ul/li)"),
+        image_url: z4.string().optional(),
+        image_alt: z4.string().optional(),
+        cta_text: z4.string().optional(),
+        cta_url: z4.string().optional(),
+        quote: z4.string().optional(),
+        quote_attribution: z4.string().optional()
+      })).optional().describe("Structured section content matching the template's section IDs. PREFERRED over raw content \u2014 preserves the user's template design and style."),
+      preview_text: z4.string().optional().describe("Preview text (create/update)"),
+      template_id: z4.string().optional().describe("BuzzPoster template ID (from newsletter_templates). Used with sections to auto-generate HTML."),
+      esp_template_id: z4.string().optional().describe("ESP-native template ID (Kit: email_template_id, Beehiiv: post_template_id). Distinct from template_id which references BuzzPoster templates."),
+      scheduled_for: z4.string().optional().describe("ISO datetime (schedule)"),
+      page: z4.string().optional().describe("Page number (list)"),
+      status: z4.string().optional().describe("Filter status (list)"),
+      from_date: z4.string().optional().describe("ISO date from (list)"),
+      to_date: z4.string().optional().describe("ISO date to (list)"),
+      confirmed: z4.boolean().default(false).describe("Confirm action (send/schedule)")
+    },
+    {
+      title: "Manage Newsletters",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: true
+    },
+    async (args) => {
+      if (args.action === "create") {
+        if (!args.subject) {
+          return { content: [{ type: "text", text: "subject is required for create." }], isError: true };
+        }
+        if (!args.content && !args.sections) {
+          return { content: [{ type: "text", text: "content or sections is required for create." }], isError: true };
+        }
+        const payload = {
+          subject: args.subject,
+          previewText: args.preview_text
+        };
+        if (args.content) payload.content = args.content;
+        if (args.sections) payload.sections = args.sections;
+        if (args.template_id) payload.templateId = args.template_id;
+        if (args.esp_template_id) payload.espTemplateId = args.esp_template_id;
+        const result = await client.createBroadcast(payload);
+        const r = result;
+        const response = {
+          id: r.id,
+          subject: args.subject,
+          content: args.content ?? r.renderedHtml ?? void 0,
+          previewText: args.preview_text,
+          previewUrl: r.previewUrl,
+          editUrl: r.editUrl,
+          status: "draft"
+        };
+        return {
+          content: [
+            { type: "text", text: JSON.stringify(response) }
+          ]
+        };
+      }
+      if (args.action === "update") {
+        if (!args.broadcast_id) {
+          return { content: [{ type: "text", text: "broadcast_id is required for update." }], isError: true };
+        }
+        const data = {};
+        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 client.updateBroadcast(args.broadcast_id, data);
+        const r = result;
+        const response = {
+          id: args.broadcast_id,
+          subject: args.subject ?? r.subject,
+          content: args.content ?? r.renderedHtml ?? void 0,
+          previewText: args.preview_text,
+          previewUrl: r.previewUrl,
+          editUrl: r.editUrl,
+          status: r.status ?? "draft"
+        };
+        return {
+          content: [
+            { type: "text", text: JSON.stringify(response) }
+          ]
+        };
+      }
+      if (args.action === "send") {
+        if (!options.allowDirectSend) {
+          return {
+            content: [{
+              type: "text",
+              text: "Direct send is disabled. Enable it in your BuzzPoster dashboard settings under Publishing Rules."
+            }],
+            isError: true
+          };
+        }
+        if (!args.broadcast_id) {
+          return { content: [{ type: "text", text: "broadcast_id is required for send." }], isError: true };
+        }
+        if (args.confirmed !== true) {
+          let subscriberCount = "unknown";
+          let rulesText = "";
+          try {
+            const subData = await client.listSubscribers({ perPage: "1" });
+            subscriberCount = String(subData?.totalCount ?? subData?.total ?? subData?.subscribers?.length ?? "unknown");
+          } catch {
+          }
+          try {
+            const rules = await client.getPublishingRules();
+            rulesText = `
+### Safety Checks
+`;
+            rulesText += `- Double confirmation required: ${rules.requireDoubleConfirmNewsletter ? "**yes**" : "no"}
+`;
+            rulesText += `- Immediate send allowed: ${rules.allowImmediateSend ? "yes" : "**no**"}
+`;
+            if (rules.requiredDisclaimer) {
+              rulesText += `- Required disclaimer: "${rules.requiredDisclaimer}"
+`;
+            }
+          } catch {
+          }
+          let espText = "";
+          try {
+            const account = await client.getAccount();
+            espText = account?.espProvider ? `**ESP:** ${account.espProvider}
+` : "";
+          } catch {
+          }
+          const preview = `## Send Newsletter Confirmation
+
+**Broadcast ID:** ${args.broadcast_id}
+**Subscribers:** ~${subscriberCount} recipients
+` + espText + rulesText + `
+**This action cannot be undone.** Once sent, the email goes to every subscriber.
+
+Call this tool again with confirmed=true to send.`;
+          return { content: [{ type: "text", text: preview }] };
+        }
+        await client.sendBroadcast(args.broadcast_id);
+        return {
+          content: [{ type: "text", text: "Newsletter sent successfully." }]
+        };
+      }
+      if (args.action === "schedule") {
+        if (!args.broadcast_id) {
+          return { content: [{ type: "text", text: "broadcast_id is required for schedule." }], isError: true };
+        }
+        if (!args.scheduled_for) {
+          return { content: [{ type: "text", text: "scheduled_for is required for schedule." }], isError: true };
+        }
+        if (args.confirmed !== true) {
+          let subscriberCount = "unknown";
+          let rulesText = "";
+          try {
+            const subData = await client.listSubscribers({ perPage: "1" });
+            subscriberCount = String(
+              subData?.totalCount ?? subData?.total ?? subData?.subscribers?.length ?? "unknown"
+            );
+          } catch {
+          }
+          try {
+            const rules = await client.getPublishingRules();
+            rulesText = `
+### Safety Checks
+`;
+            rulesText += `- Double confirmation required: ${rules.requireDoubleConfirmNewsletter ? "**yes**" : "no"}
+`;
+            rulesText += `- Immediate send allowed: ${rules.allowImmediateSend ? "yes" : "**no**"}
+`;
+            if (rules.requiredDisclaimer) {
+              rulesText += `- Required disclaimer: "${rules.requiredDisclaimer}"
+`;
+            }
+          } catch {
+          }
+          let espText = "";
+          try {
+            const account = await client.getAccount();
+            espText = account?.espProvider ? `**ESP:** ${account.espProvider}
+` : "";
+          } catch {
+          }
+          const preview = `## Schedule Newsletter Confirmation
+
+**Broadcast ID:** ${args.broadcast_id}
+**Scheduled for:** ${args.scheduled_for}
+**Subscribers:** ~${subscriberCount} recipients
+` + espText + rulesText + `
+Scheduling can typically be cancelled or rescheduled later, but please verify the time is correct.
+
+Call this tool again with confirmed=true to schedule.`;
+          return { content: [{ type: "text", text: preview }] };
+        }
+        await client.scheduleBroadcast(args.broadcast_id, {
+          scheduledFor: args.scheduled_for
+        });
+        return {
+          content: [{
+            type: "text",
+            text: `Newsletter scheduled successfully for ${args.scheduled_for}.`
+          }]
+        };
+      }
+      if (args.action === "list") {
+        const params = {};
+        if (args.page) params.page = args.page;
+        if (args.status) params.status = args.status;
+        if (args.from_date) params.fromDate = args.from_date;
+        if (args.to_date) params.toDate = args.to_date;
+        if (args.subject) params.subject = args.subject;
+        const result = await client.listBroadcasts(params);
+        const broadcasts = result?.broadcasts ?? [];
+        if (broadcasts.length === 0) {
+          return {
+            content: [{ type: "text", text: "No newsletters found matching your filters." }]
+          };
+        }
+        let text = `## Newsletters (${broadcasts.length}`;
+        if (result?.totalCount != null) text += ` of ${result.totalCount}`;
+        text += ")\n\n";
+        for (const b of broadcasts) {
+          const status = (b.status ?? "unknown").toUpperCase();
+          const date = b.sentAt ? new Date(b.sentAt).toLocaleString() : b.createdAt ? new Date(b.createdAt).toLocaleString() : "";
+          text += `- **[${status}]** "${b.subject ?? "(no subject)"}"
+`;
+          text += `  ID: ${b.id}`;
+          if (date) text += ` | ${b.sentAt ? "Sent" : "Created"}: ${date}`;
+          text += "\n";
+        }
+        return { content: [{ type: "text", text }] };
+      }
+      return {
+        content: [{ type: "text", text: `Unknown action: ${args.action}` }],
+        isError: true
+      };
+    }
+  );
+}
+
+// src/tools/rss.ts
+import { z as z5 } from "zod";
 function registerRssTools(server, client) {
   server.tool(
     "rss",
     "Fetch RSS/Atom feed entries or extract full article content from a URL. Returns og_image when available.",
     {
-      action: z4.enum(["fetch_feed", "fetch_article"]),
-      url: z4.string().describe("Feed or article URL"),
-      limit: z4.number().optional().describe("Max feed entries (fetch_feed, default 100)")
+      action: z5.enum(["fetch_feed", "fetch_article"]),
+      url: z5.string().describe("Feed or article URL"),
+      limit: z5.number().optional().describe("Max feed entries (fetch_feed, default 100)")
     },
     {
       title: "RSS Tools",
@@ -1457,13 +1870,13 @@ function registerRssTools(server, client) {
 }
 
 // src/tools/account.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 function registerAccountTools(server, client) {
   server.tool(
     "manage_account",
     "Get account details/connections or check health status of connected social accounts.",
     {
-      action: z5.enum(["get_details", "check_health"])
+      action: z6.enum(["get_details", "check_health"])
     },
     {
       title: "Manage Account",
@@ -1562,21 +1975,21 @@ ${lines.join("\n")}`;
 }
 
 // src/tools/brand-voice.ts
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 function registerBrandVoiceTools(server, client) {
   server.tool(
     "manage_brand_voice",
     "Get, create, or update the brand voice profile. Call with action 'get' before creating content.",
     {
-      action: z6.enum(["get", "create", "update"]),
-      name: z6.string().max(80).optional().describe("Voice name (create required, update optional)"),
-      description: z6.string().max(2e3).optional().describe("Voice description (create/update)"),
-      dos: z6.array(z6.string().max(200)).max(15).optional().describe("Writing rules to follow (create/update)"),
-      donts: z6.array(z6.string().max(200)).max(15).optional().describe("Things to avoid (create/update)"),
-      platform_rules: z6.record(z6.string().max(300)).optional().describe("Per-platform guidelines (create/update)"),
-      platform_examples: z6.record(z6.array(z6.string().max(500)).max(3)).optional().describe("Per-platform examples (create/update)"),
-      example_posts: z6.array(z6.string().max(500)).max(5).optional().describe("Example posts (create/update)"),
-      confirmed: z6.boolean().default(false).describe("Confirm write (create/update)")
+      action: z7.enum(["get", "create", "update"]),
+      name: z7.string().max(80).optional().describe("Voice name (create required, update optional)"),
+      description: z7.string().max(2e3).optional().describe("Voice description (create/update)"),
+      dos: z7.array(z7.string().max(200)).max(15).optional().describe("Writing rules to follow (create/update)"),
+      donts: z7.array(z7.string().max(200)).max(15).optional().describe("Things to avoid (create/update)"),
+      platform_rules: z7.record(z7.string().max(300)).optional().describe("Per-platform guidelines (create/update)"),
+      platform_examples: z7.record(z7.array(z7.string().max(500)).max(3)).optional().describe("Per-platform examples (create/update)"),
+      example_posts: z7.array(z7.string().max(500)).max(5).optional().describe("Example posts (create/update)"),
+      confirmed: z7.boolean().default(false).describe("Confirm write (create/update)")
     },
     {
       title: "Manage Brand Voice",
@@ -1748,7 +2161,7 @@ function registerBrandVoiceTools(server, client) {
 }
 
 // src/tools/audience.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 function formatAudience(audience) {
   const lines = [];
   lines.push(`## ${audience.name}${audience.isDefault ? " (default)" : ""}`);
@@ -1795,17 +2208,17 @@ function registerAudienceTools(server, client) {
     "manage_audiences",
     "List, get, create, update, or delete audience profiles.",
     {
-      action: z7.enum(["list", "get", "create", "update", "delete"]),
-      name: z7.string().max(100).optional().describe("Audience name (get/create/update/delete)"),
-      description: z7.string().max(500).optional().describe("Description (create/update)"),
-      demographics: z7.string().max(500).optional().describe("Demographics (create/update)"),
-      pain_points: z7.array(z7.string().max(200)).max(10).optional().describe("Pain points, full list (create/update)"),
-      motivations: z7.array(z7.string().max(200)).max(10).optional().describe("Motivations, full list (create/update)"),
-      preferred_platforms: z7.array(z7.string()).max(6).optional().describe("Active platforms, full list (create/update)"),
-      tone_notes: z7.string().max(500).optional().describe("Tone guidance (create/update)"),
-      content_preferences: z7.string().max(500).optional().describe("Content preferences (create/update)"),
-      is_default: z7.boolean().optional().describe("Set as default (create/update)"),
-      confirmed: z7.boolean().default(false).describe("Confirm write (create/update/delete)")
+      action: z8.enum(["list", "get", "create", "update", "delete"]),
+      name: z8.string().max(100).optional().describe("Audience name (get/create/update/delete)"),
+      description: z8.string().max(500).optional().describe("Description (create/update)"),
+      demographics: z8.string().max(500).optional().describe("Demographics (create/update)"),
+      pain_points: z8.array(z8.string().max(200)).max(10).optional().describe("Pain points, full list (create/update)"),
+      motivations: z8.array(z8.string().max(200)).max(10).optional().describe("Motivations, full list (create/update)"),
+      preferred_platforms: z8.array(z8.string()).max(6).optional().describe("Active platforms, full list (create/update)"),
+      tone_notes: z8.string().max(500).optional().describe("Tone guidance (create/update)"),
+      content_preferences: z8.string().max(500).optional().describe("Content preferences (create/update)"),
+      is_default: z8.boolean().optional().describe("Set as default (create/update)"),
+      confirmed: z8.boolean().default(false).describe("Confirm write (create/update/delete)")
     },
     {
       title: "Manage Audiences",
@@ -2000,7 +2413,7 @@ Call again with confirmed=true to delete.` }]
 }
 
 // src/tools/calendar.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 import { registerAppTool as registerAppTool3 } from "@modelcontextprotocol/ext-apps/server";
 var BASE_CHAR_LIMITS2 = {
   twitter: 280,
@@ -2021,15 +2434,15 @@ function registerCalendarTools(server, client) {
       title: "Manage Content Calendar",
       description: "View content calendar, add posts to queue, or view queue schedule.",
       inputSchema: {
-        action: z8.enum(["get_calendar", "schedule_to_queue", "get_queue"]),
-        from: z8.string().optional().describe("ISO date from (get_calendar)"),
-        to: z8.string().optional().describe("ISO date to (get_calendar)"),
-        status: z8.string().optional().describe("Filter status (get_calendar)"),
-        type: z8.string().optional().describe("Filter type: social_post or newsletter (get_calendar)"),
-        content: z8.string().optional().describe("Post text (schedule_to_queue)"),
-        platforms: z8.array(z8.string()).optional().describe("Target platforms (schedule_to_queue)"),
-        media_urls: z8.array(z8.string()).optional().describe("Media URLs (schedule_to_queue)"),
-        confirmed: z8.boolean().default(false).describe("Confirm scheduling (schedule_to_queue)")
+        action: z9.enum(["get_calendar", "schedule_to_queue", "get_queue"]),
+        from: z9.string().optional().describe("ISO date from (get_calendar)"),
+        to: z9.string().optional().describe("ISO date to (get_calendar)"),
+        status: z9.string().optional().describe("Filter status (get_calendar)"),
+        type: z9.string().optional().describe("Filter type: social_post or newsletter (get_calendar)"),
+        content: z9.string().optional().describe("Post text (schedule_to_queue)"),
+        platforms: z9.array(z9.string()).optional().describe("Target platforms (schedule_to_queue)"),
+        media_urls: z9.array(z9.string()).optional().describe("Media URLs (schedule_to_queue)"),
+        confirmed: z9.boolean().default(false).describe("Confirm scheduling (schedule_to_queue)")
       },
       annotations: {
         readOnlyHint: false,
@@ -2256,7 +2669,7 @@ Next slot: ${slotDate2.toLocaleString()} (${dayNames[slotDate2.getDay()]})
 }
 
 // src/tools/sources.ts
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 var TYPE_LABELS = {
   feed: "RSS Feed",
   website: "Website",
@@ -2282,17 +2695,17 @@ function registerSourceTools(server, client) {
     "manage_sources",
     "List, add, update, or remove content sources (RSS feeds, websites, channels). Max 10 sources.",
     {
-      action: z9.enum(["list", "add", "update", "remove"]),
-      source_id: z9.number().optional().describe("Source ID (update/remove)"),
-      name: z9.string().optional().describe("Display name (add/update)"),
-      url: z9.string().optional().describe("Source URL (add/update)"),
-      type: z9.enum(SOURCE_TYPES).optional().describe("Source type (add/update)"),
-      category: z9.string().optional().describe("Category for organization (add/update)"),
-      tags: z9.array(z9.string()).optional().describe("Tags for filtering (add/update)"),
-      notes: z9.string().optional().describe("Notes about the source (add/update)"),
-      searchQuery: z9.string().optional().describe("Search keyword for 'search' type (add/update)"),
-      isActive: z9.boolean().optional().describe("Active status (update)"),
-      confirmed: z9.boolean().default(false).describe("Confirm removal (remove)")
+      action: z10.enum(["list", "add", "update", "remove"]),
+      source_id: z10.number().optional().describe("Source ID (update/remove)"),
+      name: z10.string().optional().describe("Display name (add/update)"),
+      url: z10.string().optional().describe("Source URL (add/update)"),
+      type: z10.enum(SOURCE_TYPES).optional().describe("Source type (add/update)"),
+      category: z10.string().optional().describe("Category for organization (add/update)"),
+      tags: z10.array(z10.string()).optional().describe("Tags for filtering (add/update)"),
+      notes: z10.string().optional().describe("Notes about the source (add/update)"),
+      searchQuery: z10.string().optional().describe("Search keyword for 'search' type (add/update)"),
+      isActive: z10.boolean().optional().describe("Active status (update)"),
+      confirmed: z10.boolean().default(false).describe("Confirm removal (remove)")
     },
     {
       title: "Manage Content Sources",
@@ -2398,7 +2811,7 @@ This will permanently remove this content source. Call again with confirmed=true
 }
 
 // src/tools/wordpress.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 import { registerAppTool as registerAppTool4 } from "@modelcontextprotocol/ext-apps/server";
 function mapWpStatus(wpStatus) {
   switch (wpStatus) {
@@ -2447,26 +2860,26 @@ function registerWordPressTools(server, client) {
       title: "Manage WordPress",
       description: "CRUD WordPress posts/pages, upload media, list categories/tags.",
       inputSchema: {
-        action: z10.enum(["create_post", "update_post", "publish_post", "list_posts", "get_post", "create_page", "delete_post", "upload_media", "list_categories", "list_tags"]),
-        post_id: z10.number().optional().describe("WordPress post/page ID (update/publish/get/delete)"),
-        title: z10.string().optional().describe("Title (create_post/create_page/update)"),
-        content: z10.string().optional().describe("HTML content (create_post/create_page/update)"),
-        wp_status: z10.enum(["draft", "publish", "pending", "private", "future"]).optional().describe("Post status (create_post/create_page/update, default draft)"),
-        categories: z10.array(z10.number()).optional().describe("Category IDs (create_post/update)"),
-        tags: z10.array(z10.number()).optional().describe("Tag IDs (create_post/update)"),
-        featured_media: z10.number().optional().describe("Featured image ID (create_post/create_page/update)"),
-        excerpt: z10.string().optional().describe("Excerpt (create_post/create_page/update)"),
-        date: z10.string().optional().describe("ISO 8601 date (create_post/update, required for 'future')"),
-        slug: z10.string().optional().describe("URL slug (create_post/create_page/update)"),
-        per_page: z10.string().optional().describe("Results per page (list_posts)"),
-        page: z10.string().optional().describe("Page number (list_posts)"),
-        search: z10.string().optional().describe("Search keyword (list_posts)"),
-        filter_categories: z10.string().optional().describe("Filter by category IDs, comma-separated (list_posts)"),
-        filter_tags: z10.string().optional().describe("Filter by tag IDs, comma-separated (list_posts)"),
-        force: z10.boolean().default(false).describe("Permanent delete instead of trash (delete_post)"),
-        url: z10.string().optional().describe("Public image URL (upload_media)"),
-        filename: z10.string().optional().describe("Filename for upload (upload_media)"),
-        confirmed: z10.boolean().default(false).describe("Confirm action (create non-draft/publish/delete)")
+        action: z11.enum(["create_post", "update_post", "publish_post", "list_posts", "get_post", "create_page", "delete_post", "upload_media", "list_categories", "list_tags"]),
+        post_id: z11.number().optional().describe("WordPress post/page ID (update/publish/get/delete)"),
+        title: z11.string().optional().describe("Title (create_post/create_page/update)"),
+        content: z11.string().optional().describe("HTML content (create_post/create_page/update)"),
+        wp_status: z11.enum(["draft", "publish", "pending", "private", "future"]).optional().describe("Post status (create_post/create_page/update, default draft)"),
+        categories: z11.array(z11.number()).optional().describe("Category IDs (create_post/update)"),
+        tags: z11.array(z11.number()).optional().describe("Tag IDs (create_post/update)"),
+        featured_media: z11.number().optional().describe("Featured image ID (create_post/create_page/update)"),
+        excerpt: z11.string().optional().describe("Excerpt (create_post/create_page/update)"),
+        date: z11.string().optional().describe("ISO 8601 date (create_post/update, required for 'future')"),
+        slug: z11.string().optional().describe("URL slug (create_post/create_page/update)"),
+        per_page: z11.string().optional().describe("Results per page (list_posts)"),
+        page: z11.string().optional().describe("Page number (list_posts)"),
+        search: z11.string().optional().describe("Search keyword (list_posts)"),
+        filter_categories: z11.string().optional().describe("Filter by category IDs, comma-separated (list_posts)"),
+        filter_tags: z11.string().optional().describe("Filter by tag IDs, comma-separated (list_posts)"),
+        force: z11.boolean().default(false).describe("Permanent delete instead of trash (delete_post)"),
+        url: z11.string().optional().describe("Public image URL (upload_media)"),
+        filename: z11.string().optional().describe("Filename for upload (upload_media)"),
+        confirmed: z11.boolean().default(false).describe("Confirm action (create non-draft/publish/delete)")
       },
       annotations: {
         readOnlyHint: false,
@@ -2850,7 +3263,7 @@ ${args.force ? "WARNING: This will permanently delete the post and cannot be und
 }
 
 // src/tools/ghost.ts
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 import { registerAppTool as registerAppTool5 } from "@modelcontextprotocol/ext-apps/server";
 function mapGhostStatus(ghostStatus) {
   switch (ghostStatus) {
@@ -2889,22 +3302,22 @@ function registerGhostTools(server, client) {
       title: "Manage Ghost",
       description: "CRUD Ghost posts, send newsletters, list members/newsletters.",
       inputSchema: {
-        action: z11.enum(["create", "update", "publish", "list", "get", "send_newsletter", "list_members", "list_newsletters"]),
-        post_id: z11.string().optional().describe("Ghost post ID (update/publish/get/send_newsletter)"),
-        title: z11.string().optional().describe("Post title (create/update)"),
-        html: z11.string().optional().describe("HTML content (create/update)"),
-        status: z11.enum(["draft", "published", "scheduled"]).optional().describe("Post status (create/update, default draft)"),
-        tags: z11.array(z11.string()).optional().describe("Tag names (create/update)"),
-        featured: z11.boolean().optional().describe("Featured flag (create/update)"),
-        custom_excerpt: z11.string().optional().describe("Custom excerpt (create/update)"),
-        feature_image: z11.string().optional().describe("Feature image URL (create/update)"),
-        updated_at: z11.string().optional().describe("Collision detection timestamp (update/publish/send_newsletter)"),
-        newsletter_id: z11.string().optional().describe("Newsletter ID (send_newsletter)"),
-        email_only: z11.boolean().default(false).describe("Email only, no publish (send_newsletter)"),
-        limit: z11.string().optional().describe("Results per page (list/list_members)"),
-        page: z11.string().optional().describe("Page number (list/list_members)"),
-        filter: z11.string().optional().describe("NQL filter (list_members)"),
-        confirmed: z11.boolean().default(false).describe("Confirm action (create non-draft/publish/send_newsletter)")
+        action: z12.enum(["create", "update", "publish", "list", "get", "send_newsletter", "list_members", "list_newsletters"]),
+        post_id: z12.string().optional().describe("Ghost post ID (update/publish/get/send_newsletter)"),
+        title: z12.string().optional().describe("Post title (create/update)"),
+        html: z12.string().optional().describe("HTML content (create/update)"),
+        status: z12.enum(["draft", "published", "scheduled"]).optional().describe("Post status (create/update, default draft)"),
+        tags: z12.array(z12.string()).optional().describe("Tag names (create/update)"),
+        featured: z12.boolean().optional().describe("Featured flag (create/update)"),
+        custom_excerpt: z12.string().optional().describe("Custom excerpt (create/update)"),
+        feature_image: z12.string().optional().describe("Feature image URL (create/update)"),
+        updated_at: z12.string().optional().describe("Collision detection timestamp (update/publish/send_newsletter)"),
+        newsletter_id: z12.string().optional().describe("Newsletter ID (send_newsletter)"),
+        email_only: z12.boolean().default(false).describe("Email only, no publish (send_newsletter)"),
+        limit: z12.string().optional().describe("Results per page (list/list_members)"),
+        page: z12.string().optional().describe("Page number (list/list_members)"),
+        filter: z12.string().optional().describe("NQL filter (list_members)"),
+        confirmed: z12.boolean().default(false).describe("Confirm action (create non-draft/publish/send_newsletter)")
       },
       annotations: {
         readOnlyHint: false,
@@ -3278,7 +3691,7 @@ Call this tool again with confirmed=true to send.`;
 }
 
 // src/tools/image-templates.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 import {
   registerAppResource as registerAppResource3,
   registerAppTool as registerAppTool6,
@@ -3317,13 +3730,13 @@ function registerImageTemplateTools(server, client) {
       title: "Manage Images",
       description: "Generate branded images, list templates, or list formats/dimensions.",
       inputSchema: {
-        action: z12.enum(["generate", "list_templates", "list_formats"]),
-        template_id: z12.string().optional().describe("Image template ID, omit for default (generate)"),
-        article_image_url: z12.string().optional().describe("Background image URL (generate)"),
-        headline: z12.string().optional().describe("Headline text overlay (generate)"),
-        summary: z12.string().optional().describe("Summary text below headline (generate)"),
-        formats: z12.array(z12.string()).optional().describe("Output formats: square, portrait, landscape, wide, story (generate)"),
-        platforms: z12.array(z12.string()).optional().describe("Platform shortcuts: instagram, facebook, linkedin, twitter (generate)")
+        action: z13.enum(["generate", "list_templates", "list_formats"]),
+        template_id: z13.string().optional().describe("Image template ID, omit for default (generate)"),
+        article_image_url: z13.string().optional().describe("Background image URL (generate)"),
+        headline: z13.string().optional().describe("Headline text overlay (generate)"),
+        summary: z13.string().optional().describe("Summary text below headline (generate)"),
+        formats: z13.array(z13.string()).optional().describe("Output formats: square, portrait, landscape, wide, story (generate)"),
+        platforms: z13.array(z13.string()).optional().describe("Platform shortcuts: instagram, facebook, linkedin, twitter (generate)")
       },
       annotations: {
         readOnlyHint: false,
@@ -3463,21 +3876,21 @@ function registerImageTemplateTools(server, client) {
 }
 
 // src/tools/publishing-rules.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 function registerPublishingRulesTools(server, client) {
   server.tool(
     "manage_publishing_rules",
     "Get or update publishing safety rules (immediate publish, blocked words, daily limits, default actions, Twitter Premium).",
     {
-      action: z13.enum(["get", "update"]),
-      allow_immediate_publish: z13.boolean().optional().describe("Allow immediate social publish (update)"),
-      allow_immediate_send: z13.boolean().optional().describe("Allow immediate newsletter send (update)"),
-      social_default_action: z13.enum(["draft", "schedule", "publish"]).optional().describe("Default social action (update)"),
-      newsletter_default_action: z13.enum(["draft", "schedule", "send"]).optional().describe("Default newsletter action (update)"),
-      max_posts_per_day: z13.number().int().min(1).max(100).nullable().optional().describe("Max posts/day, null=unlimited (update)"),
-      blocked_words: z13.array(z13.string().max(100)).max(200).nullable().optional().describe("Blocked words list (update)"),
-      twitter_premium: z13.boolean().optional().describe("Enable 25K char Twitter limit (update)"),
-      confirmed: z13.boolean().default(false).describe("Confirm update (update)")
+      action: z14.enum(["get", "update"]),
+      allow_immediate_publish: z14.boolean().optional().describe("Allow immediate social publish (update)"),
+      allow_immediate_send: z14.boolean().optional().describe("Allow immediate newsletter send (update)"),
+      social_default_action: z14.enum(["draft", "schedule", "publish"]).optional().describe("Default social action (update)"),
+      newsletter_default_action: z14.enum(["draft", "schedule", "send"]).optional().describe("Default newsletter action (update)"),
+      max_posts_per_day: z14.number().int().min(1).max(100).nullable().optional().describe("Max posts/day, null=unlimited (update)"),
+      blocked_words: z14.array(z14.string().max(100)).max(200).nullable().optional().describe("Blocked words list (update)"),
+      twitter_premium: z14.boolean().optional().describe("Enable 25K char Twitter limit (update)"),
+      confirmed: z14.boolean().default(false).describe("Confirm update (update)")
     },
     {
       title: "Manage Publishing Rules",
@@ -3559,15 +3972,15 @@ function registerPublishingRulesTools(server, client) {
 }
 
 // src/tools/context.ts
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 function registerContextTools(server, client) {
   server.tool(
     "get_context",
     "Get brand voice, audience, and knowledge in one call for content creation.",
     {
-      platform: z14.string().optional().describe("Filter voice rules for platform"),
-      topic: z14.string().optional().describe("Filter knowledge items by topic/tag"),
-      include_newsletter_stats: z14.boolean().optional().describe("Include recent analytics")
+      platform: z15.string().optional().describe("Filter voice rules for platform"),
+      topic: z15.string().optional().describe("Filter knowledge items by topic/tag"),
+      include_newsletter_stats: z15.boolean().optional().describe("Include recent analytics")
     },
     {
       title: "Get Context",
@@ -3641,13 +4054,13 @@ function registerContextTools(server, client) {
 }
 
 // src/tools/team.ts
-import { z as z15 } from "zod";
+import { z as z16 } from "zod";
 function registerTeamTools(server, client) {
   server.tool(
     "manage_team",
     "Manage team members, invitations, and organizations. List members, invite or remove members, manage invitations, and list organizations.",
     {
-      action: z15.enum([
+      action: z16.enum([
         "list_members",
         "invite_member",
         "remove_member",
@@ -3655,10 +4068,10 @@ function registerTeamTools(server, client) {
         "revoke_invitation",
         "list_organizations"
       ]),
-      email: z15.string().optional().describe("Email address (invite_member)"),
-      role: z15.string().optional().describe("Role for the member (invite_member), e.g. 'admin', 'member'"),
-      member_id: z15.string().optional().describe("Member ID (remove_member)"),
-      invitation_id: z15.string().optional().describe("Invitation ID (revoke_invitation)")
+      email: z16.string().optional().describe("Email address (invite_member)"),
+      role: z16.string().optional().describe("Role for the member (invite_member), e.g. 'admin', 'member'"),
+      member_id: z16.string().optional().describe("Member ID (remove_member)"),
+      invitation_id: z16.string().optional().describe("Invitation ID (revoke_invitation)")
     },
     {
       title: "Manage Team",
@@ -3777,6 +4190,7 @@ export {
   registerImageTemplateTools,
   registerInsightsTools,
   registerMediaTools,
+  registerNewsletterTools,
   registerPostPreviewResource,
   registerPostTools,
   registerPublishingRulesTools,