@buzzposter/mcp 0.1.0 → 0.1.1

package/dist/index.js

@@ -152,6 +152,17 @@ var BuzzPosterClient = class {
   async listForms() {
     return this.request("GET", "/api/v1/newsletters/forms");
   }
+  // Knowledge
+  async listKnowledge(params) {
+    return this.request("GET", "/api/v1/knowledge", void 0, params);
+  }
+  async createKnowledge(data) {
+    return this.request("POST", "/api/v1/knowledge", data);
+  }
+  // Brand Voice
+  async getBrandVoice() {
+    return this.request("GET", "/api/v1/brand-voice");
+  }
   // RSS
   async fetchFeed(url, limit) {
     const params = { url };
@@ -776,6 +787,198 @@ function registerAccountInfoTool(server2, client2) {
   );
 }
 
+// src/tools/brand-voice.ts
+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.",
+    {},
+    async () => {
+      try {
+        const voice = await client2.getBrandVoice();
+        const lines = [];
+        lines.push(`## Brand Voice: ${voice.name || "My Brand"}`);
+        lines.push("");
+        if (voice.description) {
+          lines.push("### Voice Description");
+          lines.push(voice.description);
+          lines.push("");
+        }
+        if (voice.dos && voice.dos.length > 0) {
+          lines.push("### Do's");
+          for (const rule of voice.dos) {
+            lines.push(`- ${rule}`);
+          }
+          lines.push("");
+        }
+        if (voice.donts && voice.donts.length > 0) {
+          lines.push("### Don'ts");
+          for (const rule of voice.donts) {
+            lines.push(`- ${rule}`);
+          }
+          lines.push("");
+        }
+        if (voice.platformRules && Object.keys(voice.platformRules).length > 0) {
+          lines.push("### Platform-Specific Rules");
+          for (const [platform, rules] of Object.entries(voice.platformRules)) {
+            lines.push(`**${platform}:** ${rules}`);
+          }
+          lines.push("");
+        }
+        if (voice.examplePosts && voice.examplePosts.length > 0) {
+          lines.push("### Example Posts");
+          voice.examplePosts.forEach((post, i) => {
+            lines.push(`${i + 1}. ${post}`);
+          });
+          lines.push("");
+        }
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        if (message.includes("404") || message.includes("No brand voice")) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "No brand voice has been configured yet. The customer can set one up at their BuzzPoster dashboard."
+              }
+            ]
+          };
+        }
+        throw error;
+      }
+    }
+  );
+}
+
+// src/tools/knowledge.ts
+import { z as z7 } 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.",
+    {},
+    async () => {
+      try {
+        const data = await client2.listKnowledge();
+        const items = data.items ?? [];
+        if (items.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "The knowledge base is empty. The customer can add reference material at their BuzzPoster dashboard."
+              }
+            ]
+          };
+        }
+        const totalChars = items.reduce(
+          (sum, item) => sum + item.content.length,
+          0
+        );
+        const shouldTruncate = totalChars > 1e4;
+        const lines = [];
+        lines.push(`## Knowledge Base (${items.length} items)`);
+        lines.push("");
+        for (const item of items) {
+          lines.push(`### ${item.title}`);
+          if (item.tags && item.tags.length > 0) {
+            lines.push(`Tags: ${item.tags.join(", ")}`);
+          }
+          if (shouldTruncate) {
+            lines.push(item.content.slice(0, 500) + " [truncated]");
+          } else {
+            lines.push(item.content);
+          }
+          lines.push("");
+        }
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        throw new Error(`Failed to get knowledge base: ${message}`);
+      }
+    }
+  );
+  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.",
+    {
+      query: z7.string().describe(
+        "Search query - matches against tags first, then falls back to text search on title and content"
+      )
+    },
+    async ({ query }) => {
+      try {
+        const data = await client2.listKnowledge({ tag: query });
+        const items = data.items ?? [];
+        if (items.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `No knowledge base items found matching "${query}".`
+              }
+            ]
+          };
+        }
+        const lines = [];
+        lines.push(
+          `## Knowledge Base Results for "${query}" (${items.length} items)`
+        );
+        lines.push("");
+        for (const item of items) {
+          lines.push(`### ${item.title}`);
+          if (item.tags && item.tags.length > 0) {
+            lines.push(`Tags: ${item.tags.join(", ")}`);
+          }
+          lines.push(item.content);
+          lines.push("");
+        }
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        throw new Error(`Failed to search knowledge base: ${message}`);
+      }
+    }
+  );
+  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.",
+    {
+      title: z7.string().describe("Title for the knowledge item"),
+      content: z7.string().describe("The content/text to save"),
+      tags: z7.array(z7.string()).optional().describe("Optional tags for categorization")
+    },
+    async ({ title, content, tags }) => {
+      try {
+        await client2.createKnowledge({
+          title,
+          content,
+          sourceType: "text",
+          tags: tags ?? []
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Added "${title}" to the knowledge base.`
+            }
+          ]
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        throw new Error(`Failed to add knowledge item: ${message}`);
+      }
+    }
+  );
+}
+
 // src/index.ts
 var apiKey = process.env.BUZZPOSTER_API_KEY;
 var apiUrl = process.env.BUZZPOSTER_API_URL ?? "https://api.buzzposter.com";
@@ -801,5 +1004,7 @@ registerMediaTools(server, client);
 registerNewsletterTools(server, client);
 registerRssTools(server, client);
 registerAccountInfoTool(server, client);
+registerBrandVoiceTools(server, client);
+registerKnowledgeTools(server, client);
 var transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

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