@buzzposter/mcp 0.1.6 → 0.1.7

package/dist/index.js

@@ -262,6 +262,9 @@ var BuzzPosterClient = class {
   async getDefaultAudience() {
     return this.request("GET", "/api/v1/audiences/default");
   }
+  async createAudience(data) {
+    return this.request("POST", "/api/v1/audiences", data);
+  }
   async updateAudience(id, data) {
     return this.request("PUT", `/api/v1/audiences/${id}`, data);
   }
@@ -2134,16 +2137,17 @@ function registerAudienceTools(server2, client2) {
   );
   server2.tool(
     "update_audience",
-    `Update an existing audience profile. Only the fields you provide will be changed; omitted fields are left as-is.
+    `Create or update a target audience profile. This is an upsert \u2014 if no audience_id is provided it will try to update the default audience, or create a new one if none exists. Only the fields you provide will be changed; omitted fields are left as-is.
 
 USAGE GUIDELINES:
 - Call get_audience first to see the current state before making changes
 - Always set confirmed=false first to preview the changes, then confirmed=true after user approval
 - When updating array fields (pain_points, motivations, preferred_platforms), include the FULL array (existing + new items), not just the new ones
+- Omit audience_id to update the default audience or create a new one if none exists
 - Max limits: name 100 chars, description 500 chars`,
     {
-      audience_id: z9.string().describe("The audience ID to update (required)"),
-      name: z9.string().max(100).optional().describe("Audience profile name (e.g. 'SaaS Founders', 'Health-Conscious Millennials')"),
+      audience_id: z9.string().optional().describe("Audience ID to update. Omit to update the default audience, or create one if none exists."),
+      name: z9.string().max(100).optional().describe("Audience profile name (e.g. 'SaaS Founders', 'Health-Conscious Millennials'). Required when creating a new audience."),
       description: z9.string().max(500).optional().describe("Brief description of who this audience is"),
       demographics: z9.string().optional().describe("Demographic details \u2014 age range, location, income level, education, etc."),
       pain_points: z9.array(z9.string()).optional().describe("Problems and frustrations the audience faces. Send the FULL list, not just additions."),
@@ -2185,10 +2189,33 @@ USAGE GUIDELINES:
           isError: true
         };
       }
+      let targetId = args.audience_id;
+      let isCreating = false;
+      if (!targetId) {
+        try {
+          const defaultAudience = await client2.getDefaultAudience();
+          targetId = String(defaultAudience.id);
+        } catch {
+          isCreating = true;
+        }
+      }
+      if (isCreating && !payload.name) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "No audience exists yet. Provide a **name** to create one (e.g. name: 'SaaS Founders')."
+            }
+          ],
+          isError: true
+        };
+      }
       if (args.confirmed !== true) {
         const lines2 = [];
-        lines2.push("## Audience Update Preview");
-        lines2.push(`**Audience ID:** ${args.audience_id}`);
+        lines2.push(isCreating ? "## New Audience Preview" : "## Audience Update Preview");
+        if (!isCreating) {
+          lines2.push(`**Audience ID:** ${targetId}`);
+        }
         lines2.push("");
         if (payload.name) {
           lines2.push(`**Name:** ${payload.name}`);
@@ -2246,9 +2273,15 @@ USAGE GUIDELINES:
           content: [{ type: "text", text: lines2.join("\n") }]
         };
       }
-      const result = await client2.updateAudience(args.audience_id, payload);
+      let result;
+      if (isCreating) {
+        if (payload.isDefault === void 0) payload.isDefault = true;
+        result = await client2.createAudience(payload);
+      } else {
+        result = await client2.updateAudience(targetId, payload);
+      }
       const lines = [];
-      lines.push(`Audience "${result.name}" has been updated successfully.`);
+      lines.push(`Audience "${result.name}" has been ${isCreating ? "created" : "updated"} successfully.`);
       lines.push("");
       const summary = [];
       if (payload.name) summary.push("name");
@@ -2260,7 +2293,7 @@ USAGE GUIDELINES:
       if (payload.toneNotes) summary.push("tone notes");
       if (payload.contentPreferences) summary.push("content preferences");
       if (payload.isDefault !== void 0) summary.push("default status");
-      lines.push(`**Updated:** ${summary.join(", ")}`);
+      lines.push(`**${isCreating ? "Created with" : "Updated"}:** ${summary.join(", ")}`);
       return {
         content: [{ type: "text", text: lines.join("\n") }]
       };

package/dist/tools.d.ts

@@ -76,6 +76,7 @@ declare class BuzzPosterClient {
     updateBrandVoice(data: Record<string, unknown>): Promise<unknown>;
     getAudience(id: string): Promise<unknown>;
     getDefaultAudience(): Promise<unknown>;
+    createAudience(data: Record<string, unknown>): Promise<unknown>;
     updateAudience(id: string, data: Record<string, unknown>): Promise<unknown>;
     getTemplate(id?: string): Promise<unknown>;
     listTemplates(): Promise<unknown>;

package/dist/tools.js

@@ -256,6 +256,9 @@ var BuzzPosterClient = class {
   async getDefaultAudience() {
     return this.request("GET", "/api/v1/audiences/default");
   }
+  async createAudience(data) {
+    return this.request("POST", "/api/v1/audiences", data);
+  }
   async updateAudience(id, data) {
     return this.request("PUT", `/api/v1/audiences/${id}`, data);
   }
@@ -2864,16 +2867,17 @@ function registerAudienceTools(server, client) {
   );
   server.tool(
     "update_audience",
-    `Update an existing audience profile. Only the fields you provide will be changed; omitted fields are left as-is.
+    `Create or update a target audience profile. This is an upsert \u2014 if no audience_id is provided it will try to update the default audience, or create a new one if none exists. Only the fields you provide will be changed; omitted fields are left as-is.
 
 USAGE GUIDELINES:
 - Call get_audience first to see the current state before making changes
 - Always set confirmed=false first to preview the changes, then confirmed=true after user approval
 - When updating array fields (pain_points, motivations, preferred_platforms), include the FULL array (existing + new items), not just the new ones
+- Omit audience_id to update the default audience or create a new one if none exists
 - Max limits: name 100 chars, description 500 chars`,
     {
-      audience_id: z10.string().describe("The audience ID to update (required)"),
-      name: z10.string().max(100).optional().describe("Audience profile name (e.g. 'SaaS Founders', 'Health-Conscious Millennials')"),
+      audience_id: z10.string().optional().describe("Audience ID to update. Omit to update the default audience, or create one if none exists."),
+      name: z10.string().max(100).optional().describe("Audience profile name (e.g. 'SaaS Founders', 'Health-Conscious Millennials'). Required when creating a new audience."),
       description: z10.string().max(500).optional().describe("Brief description of who this audience is"),
       demographics: z10.string().optional().describe("Demographic details \u2014 age range, location, income level, education, etc."),
       pain_points: z10.array(z10.string()).optional().describe("Problems and frustrations the audience faces. Send the FULL list, not just additions."),
@@ -2915,10 +2919,33 @@ USAGE GUIDELINES:
           isError: true
         };
       }
+      let targetId = args.audience_id;
+      let isCreating = false;
+      if (!targetId) {
+        try {
+          const defaultAudience = await client.getDefaultAudience();
+          targetId = String(defaultAudience.id);
+        } catch {
+          isCreating = true;
+        }
+      }
+      if (isCreating && !payload.name) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "No audience exists yet. Provide a **name** to create one (e.g. name: 'SaaS Founders')."
+            }
+          ],
+          isError: true
+        };
+      }
       if (args.confirmed !== true) {
         const lines2 = [];
-        lines2.push("## Audience Update Preview");
-        lines2.push(`**Audience ID:** ${args.audience_id}`);
+        lines2.push(isCreating ? "## New Audience Preview" : "## Audience Update Preview");
+        if (!isCreating) {
+          lines2.push(`**Audience ID:** ${targetId}`);
+        }
         lines2.push("");
         if (payload.name) {
           lines2.push(`**Name:** ${payload.name}`);
@@ -2976,9 +3003,15 @@ USAGE GUIDELINES:
           content: [{ type: "text", text: lines2.join("\n") }]
         };
       }
-      const result = await client.updateAudience(args.audience_id, payload);
+      let result;
+      if (isCreating) {
+        if (payload.isDefault === void 0) payload.isDefault = true;
+        result = await client.createAudience(payload);
+      } else {
+        result = await client.updateAudience(targetId, payload);
+      }
       const lines = [];
-      lines.push(`Audience "${result.name}" has been updated successfully.`);
+      lines.push(`Audience "${result.name}" has been ${isCreating ? "created" : "updated"} successfully.`);
       lines.push("");
       const summary = [];
       if (payload.name) summary.push("name");
@@ -2990,7 +3023,7 @@ USAGE GUIDELINES:
       if (payload.toneNotes) summary.push("tone notes");
       if (payload.contentPreferences) summary.push("content preferences");
       if (payload.isDefault !== void 0) summary.push("default status");
-      lines.push(`**Updated:** ${summary.join(", ")}`);
+      lines.push(`**${isCreating ? "Created with" : "Updated"}:** ${summary.join(", ")}`);
       return {
         content: [{ type: "text", text: lines.join("\n") }]
       };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buzzposter/mcp",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "BuzzPoster MCP server - Social media, newsletters, and media hosting for Claude Desktop",
   "type": "module",
   "main": "dist/index.js",