@buzzposter/mcp 0.2.3 → 0.3.0

package/dist/tools.d.ts

@@ -31,6 +31,8 @@ declare class BuzzPosterClient {
     }): Promise<unknown>;
     listMedia(): Promise<unknown>;
     deleteMedia(key: string): Promise<unknown>;
+    createPreview(data: Record<string, unknown>): Promise<unknown>;
+    updatePreview(id: string, data: Record<string, unknown>): Promise<unknown>;
     listSubscribers(params?: Record<string, string>): Promise<unknown>;
     addSubscriber(data: Record<string, unknown>): Promise<unknown>;
     listBroadcasts(params?: Record<string, string>): Promise<unknown>;

package/dist/tools.js

@@ -101,6 +101,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(
@@ -1134,8 +1141,8 @@ function registerNewsletterTools(server, client, options = {}) {
     server,
     "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"),
@@ -1169,7 +1176,7 @@ function registerNewsletterTools(server, client, options = {}) {
         previewText: args.preview_text
       };
       if (args.template_id) payload.templateId = args.template_id;
-      const result = await client.createBroadcast(payload);
+      const result = await client.createPreview(payload);
       const response = {
         ...result,
         subject: args.subject,
@@ -1185,15 +1192,15 @@ function registerNewsletterTools(server, client, options = {}) {
   );
   server.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,
@@ -1204,7 +1211,44 @@ function registerNewsletterTools(server, client, 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 client.updateBroadcast(args.broadcast_id, data);
+      const result = await client.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) }
+        ]
+      };
+    }
+  );
+  server.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 client.createBroadcast(payload);
       const response = {
         ...result,
         subject: args.subject,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buzzposter/mcp",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "BuzzPoster MCP server - Social media, newsletters, and media hosting for any AI chatbot",
   "type": "module",
   "main": "dist/index.js",
@@ -42,10 +42,29 @@
     "zod": "^3.24.0"
   },
   "devDependencies": {
+    "@blocknote/core": "^0.47.0",
+    "@blocknote/mantine": "^0.47.0",
+    "@blocknote/react": "^0.47.0",
+    "@mantine/core": "^8.3.11",
+    "@mantine/hooks": "^8.3.11",
+    "@mantine/utils": "^6.0.22",
+    "@tiptap/core": "^3.13.0",
+    "@tiptap/pm": "^3.13.0",
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
     "@vitejs/plugin-react": "^5.1.4",
+    "prosemirror-commands": "^1.6.0",
+    "prosemirror-dropcursor": "^1.8.0",
+    "prosemirror-history": "^1.4.0",
+    "prosemirror-inputrules": "^1.4.0",
+    "prosemirror-keymap": "^1.2.0",
+    "prosemirror-model": "^1.25.0",
+    "prosemirror-schema-list": "^1.4.0",
+    "prosemirror-state": "^1.4.0",
+    "prosemirror-tables": "^1.8.0",
+    "prosemirror-transform": "^1.10.0",
+    "prosemirror-view": "^1.41.0",
     "react": "^18.3.0",
     "react-dom": "^18.3.0",
     "tsup": "^8.3.0",