@buzzposter/mcp 0.1.11 → 0.1.13

package/dist/index.js

@@ -121,6 +121,9 @@ var BuzzPosterClient = class {
   async uploadFromUrl(data) {
     return this.request("POST", "/api/v1/media/upload-from-url", data);
   }
+  async uploadBase64(data) {
+    return this.request("POST", "/api/v1/media/upload-base64", data);
+  }
   async getUploadUrl(data) {
     return this.request("POST", "/api/v1/media/presign", data);
   }
@@ -876,7 +879,7 @@ function registerAccountTools(server2, client2) {
   );
   server2.tool(
     "check_accounts_health",
-    "Check the health status of all connected social media accounts. Shows which accounts are working, which have warnings, and which need reconnection. Call this before scheduling posts to make sure target platforms are healthy.",
+    "Check the health status of all connected social media accounts. Shows which accounts are working, which have warnings, and which need attention. Call this before scheduling posts to make sure target platforms are healthy. If a token is expiring or an account shows an error, direct the user to reconnect via the BuzzPoster web UI -- reconnection cannot be done through MCP.",
     {},
     {
       title: "Check Account Health",
@@ -1199,6 +1202,34 @@ function registerMediaTools(server2, client2) {
       };
     }
   );
+  server2.tool(
+    "upload_from_claude",
+    "Upload an image that the user has dropped or pasted into Claude. When a user shares an image in the conversation, Claude can read it natively as base64. Pass the base64 data, filename, and content_type to upload it to the BuzzPoster media library and get a CDN URL back. Do NOT show the base64 data to the user -- just call this tool silently and return the CDN URL.",
+    {
+      data: z4.string().describe("Base64-encoded image data (no data URI prefix needed, just the raw base64 string)"),
+      filename: z4.string().describe("Filename including extension (e.g. photo.jpg)"),
+      content_type: z4.string().describe("MIME type (e.g. image/jpeg, image/png, image/webp, image/gif)"),
+      folder: z4.string().optional().describe("Optional folder path within the customer's storage")
+    },
+    {
+      title: "Upload Image from Claude",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false
+    },
+    async (args) => {
+      const result = await client2.uploadBase64({
+        data: args.data,
+        filename: args.filename,
+        content_type: args.content_type,
+        folder: args.folder
+      });
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+      };
+    }
+  );
   server2.tool(
     "upload_from_url",
     "Upload media from a public URL. The server fetches the image/video and uploads it to storage. Returns a CDN URL that can be used in posts. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM up to 25MB.",
@@ -1729,7 +1760,7 @@ import { z as z7 } from "zod";
 function registerBrandVoiceTools(server2, client2) {
   server2.tool(
     "get_brand_voice",
-    "Get the customer's brand voice profile and writing rules. IMPORTANT: Call this tool BEFORE creating any post, draft, or content. Use the returned voice description, rules, and examples to match the customer's tone and style in everything you write for them. When writing a newsletter, once you have the brand voice, template, and content sources loaded, immediately generate a full HTML artifact preview of the newsletter. Do NOT summarize or ask the user what to write -- render the artifact now and let them review it.",
+    "Get the customer's brand voice profile and writing rules. Returns: name, description, dos (array), donts (array), platformRules (per-platform object), and examplePosts (array). IMPORTANT: Call this tool BEFORE creating any post, draft, or content. Use the returned voice description, rules, and examples to match the customer's tone and style in everything you write for them. This tool is read-only -- to update brand voice use update_brand_voice. Do NOT store brand voice data in the knowledge base. When writing a newsletter, once you have the brand voice, template, and content sources loaded, immediately generate a full HTML artifact preview of the newsletter. Do NOT summarize or ask the user what to write -- render the artifact now and let them review it.",
     {},
     {
       title: "Get Brand Voice",
@@ -1924,7 +1955,7 @@ import { z as z8 } from "zod";
 function registerKnowledgeTools(server2, client2) {
   server2.tool(
     "get_knowledge_base",
-    "Get all items from the customer's knowledge base. Use this to access reference material about the business, products, team, competitors, and other context that helps you write better content.",
+    "Get all items from the customer's knowledge base. Use this to access reference material about the business, products, team, competitors, and other context that helps you write better content. The knowledge base is ONLY for uploaded documents, URLs, and text references (company info, products, pricing, competitors, stats). Do NOT use this to store or retrieve brand voice profiles or audience definitions -- those have dedicated tools.",
     {},
     {
       title: "Get Knowledge Base",
@@ -1978,7 +2009,7 @@ function registerKnowledgeTools(server2, client2) {
   );
   server2.tool(
     "search_knowledge",
-    "Search the customer's knowledge base by tag or keyword. Use this to find specific reference material when writing about a topic.",
+    "Search the customer's knowledge base by tag or keyword. Use this to find specific reference material when writing about a topic. Search by tag first for best results, falls back to text search. Do NOT use this to find brand voice or audience data -- those have dedicated tools.",
     {
       query: z8.string().describe(
         "Search query - matches against tags first, then falls back to text search on title and content"
@@ -2029,7 +2060,7 @@ function registerKnowledgeTools(server2, client2) {
   );
   server2.tool(
     "add_knowledge",
-    "Add a new item to the customer's knowledge base. Use this to save useful information the customer shares during conversation.",
+    "Add reference material to the customer's knowledge base. Use ONLY for: company info, product details, pricing, team bios, competitor notes, brand guidelines, and statistics. Do NOT add brand voice profiles, audience profiles, or content drafts here -- those have dedicated tools. Always include relevant tags to make items easier to find later.",
     {
       title: z8.string().describe("Title for the knowledge item"),
       content: z8.string().describe("The content/text to save"),
@@ -2071,7 +2102,7 @@ import { z as z9 } from "zod";
 function registerAudienceTools(server2, client2) {
   server2.tool(
     "get_audience",
-    "Get the target audience profile for content creation. Use this tool to understand WHO the content is for \u2014 their demographics, pain points, motivations, preferred platforms, and tone preferences. Call this BEFORE writing any post or content so you can tailor messaging to resonate with the intended audience.",
+    "Get the target audience profile for content creation. Use this tool to understand WHO the content is for. Returns: name, description, demographics, painPoints (array), motivations (array), toneNotes, contentPreferences, preferredPlatforms (array), and isDefault. Call this BEFORE writing any post or content so you can tailor messaging to resonate with the intended audience. Pass an audienceId to fetch a specific profile, or omit it to get the default. Use list_audiences to see all available profiles. Do NOT store audience data in the knowledge base.",
     {
       audienceId: z9.string().optional().describe("Specific audience profile ID. If omitted, returns the default audience.")
     },

package/dist/tools.d.ts

@@ -31,6 +31,12 @@ declare class BuzzPosterClient {
         filename?: string;
         folder?: string;
     }): Promise<unknown>;
+    uploadBase64(data: {
+        data: string;
+        filename: string;
+        content_type: string;
+        folder?: string;
+    }): Promise<unknown>;
     getUploadUrl(data: {
         filename: string;
         content_type: string;

package/dist/tools.js

@@ -115,6 +115,9 @@ var BuzzPosterClient = class {
   async uploadFromUrl(data) {
     return this.request("POST", "/api/v1/media/upload-from-url", data);
   }
+  async uploadBase64(data) {
+    return this.request("POST", "/api/v1/media/upload-base64", data);
+  }
   async getUploadUrl(data) {
     return this.request("POST", "/api/v1/media/presign", data);
   }
@@ -870,7 +873,7 @@ function registerAccountTools(server, client) {
   );
   server.tool(
     "check_accounts_health",
-    "Check the health status of all connected social media accounts. Shows which accounts are working, which have warnings, and which need reconnection. Call this before scheduling posts to make sure target platforms are healthy.",
+    "Check the health status of all connected social media accounts. Shows which accounts are working, which have warnings, and which need attention. Call this before scheduling posts to make sure target platforms are healthy. If a token is expiring or an account shows an error, direct the user to reconnect via the BuzzPoster web UI -- reconnection cannot be done through MCP.",
     {},
     {
       title: "Check Account Health",
@@ -1193,6 +1196,34 @@ function registerMediaTools(server, client) {
       };
     }
   );
+  server.tool(
+    "upload_from_claude",
+    "Upload an image that the user has dropped or pasted into Claude. When a user shares an image in the conversation, Claude can read it natively as base64. Pass the base64 data, filename, and content_type to upload it to the BuzzPoster media library and get a CDN URL back. Do NOT show the base64 data to the user -- just call this tool silently and return the CDN URL.",
+    {
+      data: z4.string().describe("Base64-encoded image data (no data URI prefix needed, just the raw base64 string)"),
+      filename: z4.string().describe("Filename including extension (e.g. photo.jpg)"),
+      content_type: z4.string().describe("MIME type (e.g. image/jpeg, image/png, image/webp, image/gif)"),
+      folder: z4.string().optional().describe("Optional folder path within the customer's storage")
+    },
+    {
+      title: "Upload Image from Claude",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false
+    },
+    async (args) => {
+      const result = await client.uploadBase64({
+        data: args.data,
+        filename: args.filename,
+        content_type: args.content_type,
+        folder: args.folder
+      });
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+      };
+    }
+  );
   server.tool(
     "upload_from_url",
     "Upload media from a public URL. The server fetches the image/video and uploads it to storage. Returns a CDN URL that can be used in posts. Supports JPEG, PNG, GIF, WebP, MP4, MOV, WebM up to 25MB.",
@@ -2459,7 +2490,7 @@ import { z as z8 } from "zod";
 function registerBrandVoiceTools(server, client) {
   server.tool(
     "get_brand_voice",
-    "Get the customer's brand voice profile and writing rules. IMPORTANT: Call this tool BEFORE creating any post, draft, or content. Use the returned voice description, rules, and examples to match the customer's tone and style in everything you write for them. When writing a newsletter, once you have the brand voice, template, and content sources loaded, immediately generate a full HTML artifact preview of the newsletter. Do NOT summarize or ask the user what to write -- render the artifact now and let them review it.",
+    "Get the customer's brand voice profile and writing rules. Returns: name, description, dos (array), donts (array), platformRules (per-platform object), and examplePosts (array). IMPORTANT: Call this tool BEFORE creating any post, draft, or content. Use the returned voice description, rules, and examples to match the customer's tone and style in everything you write for them. This tool is read-only -- to update brand voice use update_brand_voice. Do NOT store brand voice data in the knowledge base. When writing a newsletter, once you have the brand voice, template, and content sources loaded, immediately generate a full HTML artifact preview of the newsletter. Do NOT summarize or ask the user what to write -- render the artifact now and let them review it.",
     {},
     {
       title: "Get Brand Voice",
@@ -2654,7 +2685,7 @@ import { z as z9 } from "zod";
 function registerKnowledgeTools(server, client) {
   server.tool(
     "get_knowledge_base",
-    "Get all items from the customer's knowledge base. Use this to access reference material about the business, products, team, competitors, and other context that helps you write better content.",
+    "Get all items from the customer's knowledge base. Use this to access reference material about the business, products, team, competitors, and other context that helps you write better content. The knowledge base is ONLY for uploaded documents, URLs, and text references (company info, products, pricing, competitors, stats). Do NOT use this to store or retrieve brand voice profiles or audience definitions -- those have dedicated tools.",
     {},
     {
       title: "Get Knowledge Base",
@@ -2708,7 +2739,7 @@ function registerKnowledgeTools(server, client) {
   );
   server.tool(
     "search_knowledge",
-    "Search the customer's knowledge base by tag or keyword. Use this to find specific reference material when writing about a topic.",
+    "Search the customer's knowledge base by tag or keyword. Use this to find specific reference material when writing about a topic. Search by tag first for best results, falls back to text search. Do NOT use this to find brand voice or audience data -- those have dedicated tools.",
     {
       query: z9.string().describe(
         "Search query - matches against tags first, then falls back to text search on title and content"
@@ -2759,7 +2790,7 @@ function registerKnowledgeTools(server, client) {
   );
   server.tool(
     "add_knowledge",
-    "Add a new item to the customer's knowledge base. Use this to save useful information the customer shares during conversation.",
+    "Add reference material to the customer's knowledge base. Use ONLY for: company info, product details, pricing, team bios, competitor notes, brand guidelines, and statistics. Do NOT add brand voice profiles, audience profiles, or content drafts here -- those have dedicated tools. Always include relevant tags to make items easier to find later.",
     {
       title: z9.string().describe("Title for the knowledge item"),
       content: z9.string().describe("The content/text to save"),
@@ -2801,7 +2832,7 @@ import { z as z10 } from "zod";
 function registerAudienceTools(server, client) {
   server.tool(
     "get_audience",
-    "Get the target audience profile for content creation. Use this tool to understand WHO the content is for \u2014 their demographics, pain points, motivations, preferred platforms, and tone preferences. Call this BEFORE writing any post or content so you can tailor messaging to resonate with the intended audience.",
+    "Get the target audience profile for content creation. Use this tool to understand WHO the content is for. Returns: name, description, demographics, painPoints (array), motivations (array), toneNotes, contentPreferences, preferredPlatforms (array), and isDefault. Call this BEFORE writing any post or content so you can tailor messaging to resonate with the intended audience. Pass an audienceId to fetch a specific profile, or omit it to get the default. Use list_audiences to see all available profiles. Do NOT store audience data in the knowledge base.",
     {
       audienceId: z10.string().optional().describe("Specific audience profile ID. If omitted, returns the default audience.")
     },

package/package.json

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