@ssemble/mcp-server 1.0.4 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssemble/mcp-server",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "mcpName": "com.ssemble/mcp-server",
   "description": "MCP server for Ssemble AI Clipping — create viral short-form videos from any AI assistant",
   "type": "module",

package/server.json

@@ -3,7 +3,7 @@
   "name": "com.ssemble/mcp-server",
   "title": "Ssemble AI Clipping",
   "description": "Create AI-powered short-form video clips from YouTube videos using any AI assistant.",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "websiteUrl": "https://www.ssemble.com",
   "repository": {
     "url": "https://github.com/ssembleinc/ssemble-mcp-server",
@@ -14,7 +14,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@ssemble/mcp-server",
-      "version": "1.0.4",
+      "version": "1.0.5",
       "transport": {
         "type": "stdio"
       },

package/src/api/client.js

@@ -34,13 +34,13 @@ export class SsembleClient {
     if (!this.apiKey) {
       throw new SsembleApiError(401, {
         code: 'missing_api_key',
-        message: 'Ssemble API key required. Pass via X-Ssemble-API-Key header when using the remote endpoint, or set SSEMBLE_API_KEY env var for local usage. Get your key at https://app.ssemble.com → Settings → API Keys.',
+        message: 'Ssemble API key required. Pass via X-Ssemble-API-Key header when using the remote endpoint, or set SSEMBLE_API_KEY env var for local usage. Get your key at https://app.ssemble.com/api-keys',
       });
     }
     if (!this.apiKey.startsWith('sk_ssemble_')) {
       throw new SsembleApiError(401, {
         code: 'invalid_api_key',
-        message: 'Invalid API key format. Must start with sk_ssemble_',
+        message: 'Invalid API key format. Must start with sk_ssemble_. Get your key at https://app.ssemble.com/api-keys',
       });
     }
 
@@ -60,7 +60,7 @@ export class SsembleClient {
     const headers = {
       'X-API-Key': this.apiKey,
       'Content-Type': 'application/json',
-      'User-Agent': 'ssemble-mcp-server/1.0.4',
+      'User-Agent': 'ssemble-mcp-server/1.0.5',
     };
 
     const options = { method, headers };

package/src/transports/stdio.js

@@ -11,7 +11,7 @@ import { createSsembleMcpServer } from '../index.js';
 const apiKey = process.env.SSEMBLE_API_KEY;
 if (!apiKey) {
   console.error('Error: SSEMBLE_API_KEY environment variable is required.');
-  console.error('Get your API key at https://app.ssemble.com → Settings → API Keys');
+  console.error('Get your API key at https://app.ssemble.com/api-keys');
   process.exit(1);
 }
 

package/src/utils/format.js

@@ -171,11 +171,24 @@ export function formatDeleteResponse(result) {
 
 export function formatError(error) {
   if (error instanceof Error && error.code) {
-    let text = `**Error**: ${error.message}`;
-    if (error.code) text += ` (${error.code})`;
+    let text = `**Error**: ${error.message} (${error.code})`;
     if (error.details) {
       text += `\n\n**Details**: ${JSON.stringify(error.details, null, 2)}`;
     }
+
+    // Add helpful guidance based on error code
+    const helpLinks = {
+      missing_api_key: '\n\n**Get your API key**: https://app.ssemble.com/api-keys\n**Setup guide**: https://www.npmjs.com/package/@ssemble/mcp-server',
+      invalid_api_key: '\n\n**Get a valid API key**: https://app.ssemble.com/api-keys\nAPI keys start with `sk_ssemble_` and are 43 characters long.',
+      subscription_required: '\n\n**Subscribe to a plan**: https://app.ssemble.com/pricing\nAn active subscription is required to use the API.',
+      insufficient_credits: '\n\n**Get credits**: https://app.ssemble.com/pricing\nEach short creation costs 1 credit.',
+      user_not_found: '\n\n**Create an account**: https://app.ssemble.com\nThen generate an API key at https://app.ssemble.com/api-keys',
+    };
+
+    if (helpLinks[error.code]) {
+      text += helpLinks[error.code];
+    }
+
     if (error.rateLimits?.hourlyRemaining) {
       text += formatRateLimits(error.rateLimits);
     }