@socialneuron/mcp-server 1.5.1 → 1.6.0

package/dist/index.js

@@ -14,7 +14,7 @@ var MCP_VERSION;
 var init_version = __esm({
   "src/lib/version.ts"() {
     "use strict";
-    MCP_VERSION = "1.5.1";
+    MCP_VERSION = "1.6.0";
   }
 });
 
@@ -3895,6 +3895,41 @@ function checkRateLimit(category, key) {
 
 // src/tools/ideation.ts
 init_supabase();
+
+// src/lib/tool-errors.ts
+function formatToolError(rawMessage) {
+  const msg = rawMessage.toLowerCase();
+  if (msg.includes("rate limit") || msg.includes("too many requests")) {
+    return `${rawMessage} Reduce request frequency or wait before retrying.`;
+  }
+  if (msg.includes("insufficient credit") || msg.includes("budget") || msg.includes("spending cap")) {
+    return `${rawMessage} Call get_credit_balance to check remaining credits. Consider a cheaper model or wait for monthly refresh.`;
+  }
+  if (msg.includes("oauth") || msg.includes("token expired") || msg.includes("not connected") || msg.includes("reconnect")) {
+    return `${rawMessage} Call list_connected_accounts to check status. User may need to reconnect at socialneuron.com/settings/connections.`;
+  }
+  if (msg.includes("generation failed") || msg.includes("failed to start") || msg.includes("no job id") || msg.includes("could not be parsed")) {
+    return `${rawMessage} Try simplifying the prompt, using a different model, or check credits with get_credit_balance.`;
+  }
+  if (msg.includes("not found") || msg.includes("no ") && msg.includes(" found")) {
+    return `${rawMessage} Verify the ID is correct \u2014 use the corresponding list tool to find valid IDs.`;
+  }
+  if (msg.includes("not accessible") || msg.includes("unauthorized") || msg.includes("permission")) {
+    return `${rawMessage} Check API key scopes with get_credit_balance. A higher-tier plan may be required.`;
+  }
+  if (msg.includes("ssrf") || msg.includes("url blocked")) {
+    return `${rawMessage} The URL was blocked for security. Use a publicly accessible HTTPS URL.`;
+  }
+  if (msg.includes("failed to schedule") || msg.includes("scheduling failed")) {
+    return `${rawMessage} Verify platform OAuth is active with list_connected_accounts, then retry.`;
+  }
+  if (msg.includes("no posts") || msg.includes("plan") && msg.includes("has no")) {
+    return `${rawMessage} Generate a plan with plan_content_week first, then save with save_content_plan.`;
+  }
+  return rawMessage;
+}
+
+// src/tools/ideation.ts
 function registerIdeationTools(server2) {
   server2.tool(
     "generate_content",
@@ -4068,7 +4103,7 @@ Content Type: ${content_type}`;
           content: [
             {
               type: "text",
-              text: `Content generation failed: ${error}`
+              text: formatToolError(`Content generation failed: ${error}`)
             }
           ],
           isError: true
@@ -4133,7 +4168,7 @@ Content Type: ${content_type}`;
           content: [
             {
               type: "text",
-              text: `Failed to fetch trends: ${error}`
+              text: formatToolError(`Failed to fetch trends: ${error}`)
             }
           ],
           isError: true
@@ -4301,7 +4336,7 @@ ${content}`,
           content: [
             {
               type: "text",
-              text: `Content adaptation failed: ${error}`
+              text: formatToolError(`Content adaptation failed: ${error}`)
             }
           ],
           isError: true
@@ -4612,7 +4647,7 @@ function registerContentTools(server2) {
           content: [
             {
               type: "text",
-              text: `Video generation failed to start: ${error}`
+              text: formatToolError(`Video generation failed to start: ${error}`)
             }
           ],
           isError: true
@@ -4629,7 +4664,7 @@ function registerContentTools(server2) {
           content: [
             {
               type: "text",
-              text: "Video generation failed: no job ID returned."
+              text: formatToolError("Video generation failed: no job ID returned.")
             }
           ],
           isError: true
@@ -4805,7 +4840,7 @@ function registerContentTools(server2) {
           content: [
             {
               type: "text",
-              text: `Image generation failed to start: ${error}`
+              text: formatToolError(`Image generation failed to start: ${error}`)
             }
           ],
           isError: true
@@ -4822,7 +4857,7 @@ function registerContentTools(server2) {
           content: [
             {
               type: "text",
-              text: "Image generation failed: no job ID returned."
+              text: formatToolError("Image generation failed: no job ID returned.")
             }
           ],
           isError: true
@@ -4946,7 +4981,7 @@ function registerContentTools(server2) {
           content: [
             {
               type: "text",
-              text: `Failed to look up job: ${sanitizeDbError(jobError)}`
+              text: formatToolError(`Failed to look up job: ${sanitizeDbError(jobError)}`)
             }
           ],
           isError: true
@@ -4963,7 +4998,7 @@ function registerContentTools(server2) {
           content: [
             {
               type: "text",
-              text: `No job found with ID "${job_id}". The ID may be incorrect or the job has expired.`
+              text: formatToolError(`No job found with ID "${job_id}". The ID may be incorrect or the job has expired.`)
             }
           ],
           isError: true
@@ -5211,7 +5246,7 @@ Return ONLY valid JSON in this exact format:
           content: [
             {
               type: "text",
-              text: `Storyboard generation failed: ${error}`
+              text: formatToolError(`Storyboard generation failed: ${error}`)
             }
           ],
           isError: true
@@ -5346,7 +5381,7 @@ Return ONLY valid JSON in this exact format:
           content: [
             {
               type: "text",
-              text: `Voiceover generation failed: ${error}`
+              text: formatToolError(`Voiceover generation failed: ${error}`)
             }
           ],
           isError: true
@@ -5363,7 +5398,7 @@ Return ONLY valid JSON in this exact format:
           content: [
             {
               type: "text",
-              text: "Voiceover generation failed: no audio URL returned."
+              text: formatToolError("Voiceover generation failed: no audio URL returned.")
             }
           ],
           isError: true
@@ -5526,7 +5561,7 @@ Return ONLY valid JSON in this exact format:
           content: [
             {
               type: "text",
-              text: `Carousel generation failed: ${error}`
+              text: formatToolError(`Carousel generation failed: ${error}`)
             }
           ],
           isError: true
@@ -5752,7 +5787,7 @@ Created with Social Neuron`;
           content: [
             {
               type: "text",
-              text: `Failed to schedule post: ${error}`
+              text: formatToolError(`Failed to schedule post: ${error}`)
             }
           ],
           isError: true
@@ -5840,7 +5875,7 @@ Created with Social Neuron`;
           content: [
             {
               type: "text",
-              text: `Failed to list connected accounts: ${sanitizeDbError(error)}`
+              text: formatToolError(`Failed to list connected accounts: ${sanitizeDbError(error)}`)
             }
           ],
           isError: true
@@ -5939,7 +5974,7 @@ Created with Social Neuron`;
           content: [
             {
               type: "text",
-              text: `Failed to list posts: ${sanitizeDbError(error)}`
+              text: formatToolError(`Failed to list posts: ${sanitizeDbError(error)}`)
             }
           ],
           isError: true
@@ -6144,7 +6179,7 @@ Created with Social Neuron`;
         });
         return {
           content: [
-            { type: "text", text: `Failed to find slots: ${message}` }
+            { type: "text", text: formatToolError(`Failed to find slots: ${message}`) }
           ],
           isError: true
         };
@@ -6214,7 +6249,7 @@ Created with Social Neuron`;
               content: [
                 {
                   type: "text",
-                  text: `Failed to load content plan: ${sanitizeDbError(storedError)}`
+                  text: formatToolError(`Failed to load content plan: ${sanitizeDbError(storedError)}`)
                 }
               ],
               isError: true
@@ -6225,7 +6260,7 @@ Created with Social Neuron`;
               content: [
                 {
                   type: "text",
-                  text: `No content plan found for plan_id=${plan_id}`
+                  text: formatToolError(`No content plan found for plan_id=${plan_id}`)
                 }
               ],
               isError: true
@@ -6240,7 +6275,7 @@ Created with Social Neuron`;
               content: [
                 {
                   type: "text",
-                  text: `Stored plan ${plan_id} has no posts array.`
+                  text: formatToolError(`Stored plan ${plan_id} has no posts array.`)
                 }
               ],
               isError: true
@@ -6279,7 +6314,7 @@ Created with Social Neuron`;
               content: [
                 {
                   type: "text",
-                  text: `Failed to load plan approvals: ${sanitizeDbError(approvalsError)}`
+                  text: formatToolError(`Failed to load plan approvals: ${sanitizeDbError(approvalsError)}`)
                 }
               ],
               isError: true
@@ -6714,7 +6749,7 @@ Created with Social Neuron`;
           content: [
             {
               type: "text",
-              text: `Batch scheduling failed: ${message}`
+              text: formatToolError(`Batch scheduling failed: ${message}`)
             }
           ],
           isError: true
@@ -6807,7 +6842,7 @@ function registerAnalyticsTools(server2) {
             content: [
               {
                 type: "text",
-                text: `Failed to fetch user-scoped posts: ${sanitizeDbError(postsError)}`
+                text: formatToolError(`Failed to fetch user-scoped posts: ${sanitizeDbError(postsError)}`)
               }
             ],
             isError: true
@@ -6854,7 +6889,7 @@ function registerAnalyticsTools(server2) {
             content: [
               {
                 type: "text",
-                text: `Failed to fetch analytics: ${sanitizeDbError(simpleError)}`
+                text: formatToolError(`Failed to fetch analytics: ${sanitizeDbError(simpleError)}`)
               }
             ],
             isError: true
@@ -6984,7 +7019,7 @@ function registerAnalyticsTools(server2) {
           content: [
             {
               type: "text",
-              text: `Error refreshing analytics: ${error}`
+              text: formatToolError(`Error refreshing analytics: ${error}`)
             }
           ],
           isError: true
@@ -7373,7 +7408,7 @@ function registerBrandTools(server2) {
           content: [
             {
               type: "text",
-              text: `Brand extraction failed: ${error}`
+              text: formatToolError(`Brand extraction failed: ${error}`)
             }
           ],
           isError: true
@@ -7483,7 +7518,7 @@ function registerBrandTools(server2) {
           content: [
             {
               type: "text",
-              text: `Failed to load brand profile: ${sanitizeDbError(error)}`
+              text: formatToolError(`Failed to load brand profile: ${sanitizeDbError(error)}`)
             }
           ],
           isError: true
@@ -7614,7 +7649,7 @@ function registerBrandTools(server2) {
           content: [
             {
               type: "text",
-              text: `Failed to save brand profile: ${sanitizeDbError(error)}`
+              text: formatToolError(`Failed to save brand profile: ${sanitizeDbError(error)}`)
             }
           ],
           isError: true
@@ -7790,7 +7825,7 @@ Version: ${payload.version ?? "N/A"}`
           content: [
             {
               type: "text",
-              text: `Failed to update platform voice: ${saveError.message}`
+              text: formatToolError(`Failed to update platform voice: ${saveError.message}`)
             }
           ],
           isError: true
@@ -8991,7 +9026,7 @@ function registerCommentsTools(server2) {
       if (error) {
         return {
           content: [
-            { type: "text", text: `Error listing comments: ${error}` }
+            { type: "text", text: formatToolError(`Error listing comments: ${error}`) }
           ],
           isError: true
         };
@@ -9095,7 +9130,7 @@ function registerCommentsTools(server2) {
           content: [
             {
               type: "text",
-              text: `Error replying to comment: ${error}`
+              text: formatToolError(`Error replying to comment: ${error}`)
             }
           ],
           isError: true
@@ -9181,7 +9216,7 @@ function registerCommentsTools(server2) {
         });
         return {
           content: [
-            { type: "text", text: `Error posting comment: ${error}` }
+            { type: "text", text: formatToolError(`Error posting comment: ${error}`) }
           ],
           isError: true
         };
@@ -9268,7 +9303,7 @@ function registerCommentsTools(server2) {
           content: [
             {
               type: "text",
-              text: `Error moderating comment: ${error}`
+              text: formatToolError(`Error moderating comment: ${error}`)
             }
           ],
           isError: true
@@ -9357,7 +9392,7 @@ function registerCommentsTools(server2) {
         });
         return {
           content: [
-            { type: "text", text: `Error deleting comment: ${error}` }
+            { type: "text", text: formatToolError(`Error deleting comment: ${error}`) }
           ],
           isError: true
         };
@@ -9633,7 +9668,7 @@ function registerCreditsTools(server2) {
           content: [
             {
               type: "text",
-              text: `Failed to fetch credit balance: ${sanitizeDbError(profileResult.error)}`
+              text: formatToolError(`Failed to fetch credit balance: ${sanitizeDbError(profileResult.error)}`)
             }
           ],
           isError: true
@@ -10279,7 +10314,7 @@ function registerExtractionTools(server2) {
               content: [
                 {
                   type: "text",
-                  text: `Failed to extract YouTube video: ${error ?? "No data returned"}`
+                  text: formatToolError(`Failed to extract YouTube video: ${error ?? "No data returned"}`)
                 }
               ],
               isError: true
@@ -10319,7 +10354,7 @@ function registerExtractionTools(server2) {
               content: [
                 {
                   type: "text",
-                  text: `Failed to extract YouTube channel: ${error ?? "No data returned"}`
+                  text: formatToolError(`Failed to extract YouTube channel: ${error ?? "No data returned"}`)
                 }
               ],
               isError: true
@@ -10350,7 +10385,7 @@ function registerExtractionTools(server2) {
               content: [
                 {
                   type: "text",
-                  text: `Failed to extract URL content: ${error ?? "No data returned"}`
+                  text: formatToolError(`Failed to extract URL content: ${error ?? "No data returned"}`)
                 }
               ],
               isError: true
@@ -10407,7 +10442,7 @@ function registerExtractionTools(server2) {
         });
         return {
           content: [
-            { type: "text", text: `Extraction failed: ${message}` }
+            { type: "text", text: formatToolError(`Extraction failed: ${message}`) }
           ],
           isError: true
         };
@@ -10909,7 +10944,7 @@ ${ideationContext.promptInjection.slice(0, 1500)}` : "",
             content: [
               {
                 type: "text",
-                text: `Plan generation failed: ${aiError ?? "No response from AI"}`
+                text: formatToolError(`Plan generation failed: ${aiError ?? "No response from AI"}`)
               }
             ],
             isError: true
@@ -10929,10 +10964,10 @@ ${ideationContext.promptInjection.slice(0, 1500)}` : "",
             content: [
               {
                 type: "text",
-                text: `AI response could not be parsed as JSON.
+                text: formatToolError(`AI response could not be parsed as JSON.
 
 Raw output (first 1000 chars):
-${rawText.slice(0, 1e3)}`
+${rawText.slice(0, 1e3)}`)
               }
             ],
             isError: true
@@ -11059,7 +11094,7 @@ ${rawText.slice(0, 1e3)}`
           content: [
             {
               type: "text",
-              text: `Plan generation failed: ${message}`
+              text: formatToolError(`Plan generation failed: ${message}`)
             }
           ],
           isError: true
@@ -11172,7 +11207,7 @@ ${rawText.slice(0, 1e3)}`
           content: [
             {
               type: "text",
-              text: `Failed to save content plan: ${message}`
+              text: formatToolError(`Failed to save content plan: ${message}`)
             }
           ],
           isError: true
@@ -11205,7 +11240,7 @@ ${rawText.slice(0, 1e3)}`
           content: [
             {
               type: "text",
-              text: `Failed to load content plan: ${sanitizeDbError(error)}`
+              text: formatToolError(`Failed to load content plan: ${sanitizeDbError(error)}`)
             }
           ],
           isError: true
@@ -11216,7 +11251,7 @@ ${rawText.slice(0, 1e3)}`
           content: [
             {
               type: "text",
-              text: `No content plan found for plan_id=${plan_id}`
+              text: formatToolError(`No content plan found for plan_id=${plan_id}`)
             }
           ],
           isError: true
@@ -11304,7 +11339,7 @@ ${rawText.slice(0, 1e3)}`
           content: [
             {
               type: "text",
-              text: `No content plan found for plan_id=${plan_id}`
+              text: formatToolError(`No content plan found for plan_id=${plan_id}`)
             }
           ],
           isError: true
@@ -11348,7 +11383,7 @@ ${rawText.slice(0, 1e3)}`
           content: [
             {
               type: "text",
-              text: `Failed to update content plan: ${sanitizeDbError(saveError)}`
+              text: formatToolError(`Failed to update content plan: ${sanitizeDbError(saveError)}`)
             }
           ],
           isError: true
@@ -11415,7 +11450,7 @@ ${rawText.slice(0, 1e3)}`
           content: [
             {
               type: "text",
-              text: `No content plan found for plan_id=${plan_id}`
+              text: formatToolError(`No content plan found for plan_id=${plan_id}`)
             }
           ],
           isError: true
@@ -11428,7 +11463,7 @@ ${rawText.slice(0, 1e3)}`
           content: [
             {
               type: "text",
-              text: `Plan ${plan_id} has no posts to submit.`
+              text: formatToolError(`Plan ${plan_id} has no posts to submit.`)
             }
           ],
           isError: true
@@ -11448,7 +11483,7 @@ ${rawText.slice(0, 1e3)}`
           content: [
             {
               type: "text",
-              text: `Failed to create approvals: ${sanitizeDbError(approvalError)}`
+              text: formatToolError(`Failed to create approvals: ${sanitizeDbError(approvalError)}`)
             }
           ],
           isError: true
@@ -11460,7 +11495,7 @@ ${rawText.slice(0, 1e3)}`
           content: [
             {
               type: "text",
-              text: `Failed to update plan status: ${sanitizeDbError(statusError)}`
+              text: formatToolError(`Failed to update plan status: ${sanitizeDbError(statusError)}`)
             }
           ],
           isError: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socialneuron/mcp-server",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "description": "MCP server for Social Neuron - AI content creation platform",
   "type": "module",
   "main": "dist/index.js",
@@ -22,6 +22,7 @@
     "type": "git",
     "url": "git+https://github.com/socialneuron/mcp-server.git"
   },
+  "source": "./src/index.ts",
   "exports": {
     ".": "./dist/index.js",
     "./http": "./dist/http.js"
@@ -43,6 +44,7 @@
     "tiktok",
     "instagram"
   ],
+  "mcpName": "com.socialneuron/mcp-server",
   "publishConfig": {
     "access": "public"
   },