@buzzposter/mcp 0.3.4 → 0.3.6

package/dist/tools.js

@@ -1378,16 +1378,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 +1708,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 +1813,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 +1999,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 +2046,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 +2251,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 +2272,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 +2507,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 +2533,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 +2649,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 +2698,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 +3101,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 +3140,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 +3529,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 +3568,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 +3714,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 +3810,22 @@ 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",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
     },
     async (args) => {
       const params = {};
@@ -3634,13 +3892,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",
@@ -3648,10 +3906,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",
@@ -3770,6 +4028,7 @@ export {
   registerImageTemplateTools,
   registerInsightsTools,
   registerMediaTools,
+  registerNewsletterTools,
   registerPostPreviewResource,
   registerPostTools,
   registerPublishingRulesTools,