@buzzposter/mcp 0.1.11 → 0.1.12

package/dist/index.js

@@ -876,7 +876,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",
@@ -1729,7 +1729,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 +1924,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 +1978,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 +2029,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 +2071,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.js

@@ -870,7 +870,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",
@@ -2459,7 +2459,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 +2654,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 +2708,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 +2759,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 +2801,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.12",
   "description": "BuzzPoster MCP server - Social media, newsletters, and media hosting for Claude Desktop",
   "type": "module",
   "main": "dist/index.js",