@ssemble/mcp-server 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssemble/mcp-server",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "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

@@ -2,26 +2,26 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "com.ssemble/mcp-server",
   "title": "Ssemble AI Clipping",
-  "description": "Create AI-powered short-form video clips from YouTube videos or uploaded files. Browse caption templates, background music, gameplay overlays, and meme hooks.",
-  "version": "1.0.2",
+  "description": "Create AI-powered short-form video clips from YouTube videos using any AI assistant.",
+  "version": "1.0.3",
   "websiteUrl": "https://www.ssemble.com",
   "repository": {
-    "type": "git",
-    "url": "https://gitlab.com/vlogr/ssemble-mcp-server.git"
+    "url": "https://gitlab.com/vlogr/ssemble-mcp-server",
+    "source": "gitlab"
   },
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@ssemble/mcp-server",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "transport": {
         "type": "stdio"
       },
       "environmentVariables": [
         {
           "name": "SSEMBLE_API_KEY",
-          "description": "Your Ssemble API key (starts with sk_ssemble_). Get it at https://app.ssemble.com → Settings → API Keys",
+          "description": "Your Ssemble API key (starts with sk_ssemble_)",
           "isRequired": true,
           "isSecret": true
         }
@@ -30,7 +30,7 @@
   ],
   "remotes": [
     {
-      "transportType": "streamable-http",
+      "type": "streamable-http",
       "url": "https://mcp.ssemble.com/mcp"
     }
   ]

package/src/api/client.js

@@ -17,18 +17,33 @@ export class SsembleApiError extends Error {
 }
 
 export class SsembleClient {
-  constructor(apiKey, baseUrl) {
-    if (!apiKey) {
-      throw new Error('SSEMBLE_API_KEY is required');
-    }
-    if (!apiKey.startsWith('sk_ssemble_')) {
-      throw new Error('Invalid API key format. Must start with sk_ssemble_');
+  constructor(apiKey, baseUrl, options = {}) {
+    if (!options.lazy) {
+      if (!apiKey) {
+        throw new Error('SSEMBLE_API_KEY is required');
+      }
+      if (!apiKey.startsWith('sk_ssemble_')) {
+        throw new Error('Invalid API key format. Must start with sk_ssemble_');
+      }
     }
     this.apiKey = apiKey;
     this.baseUrl = baseUrl || DEFAULT_BASE_URL;
   }
 
   async _request(method, path, { body, query } = {}) {
+    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.',
+      });
+    }
+    if (!this.apiKey.startsWith('sk_ssemble_')) {
+      throw new SsembleApiError(401, {
+        code: 'invalid_api_key',
+        message: 'Invalid API key format. Must start with sk_ssemble_',
+      });
+    }
+
     let url = `${this.baseUrl}${path}`;
 
     if (query) {

package/src/index.js

@@ -27,7 +27,9 @@ export function createSsembleMcpServer(apiKey, baseUrl) {
     version: '1.0.0',
   });
 
-  const client = new SsembleClient(apiKey, baseUrl);
+  // Client is created lazily — allows MCP initialize/discovery without an API key.
+  // Tools will get a clear error if key is missing when they actually call the API.
+  const client = new SsembleClient(apiKey, baseUrl, { lazy: true });
 
   // Register all 9 tools
   registerCreateShort(server, client);

package/src/transports/http.js

@@ -42,19 +42,10 @@ app.get('/.well-known/mcp/server-card.json', (_req, res) => {
 
 // MCP endpoint — stateless mode (each request is independent)
 app.all('/mcp', async (req, res) => {
-  const apiKey = req.headers['x-ssemble-api-key'] || process.env.SSEMBLE_API_KEY;
-
-  if (!apiKey) {
-    return res.status(401).json({
-      error: {
-        code: 'missing_api_key',
-        message: 'Ssemble API key required. Pass via X-Ssemble-API-Key header or set SSEMBLE_API_KEY env var.',
-      },
-    });
-  }
+  const apiKey = req.headers['x-ssemble-api-key'] || process.env.SSEMBLE_API_KEY || null;
+  const baseUrl = process.env.SSEMBLE_API_BASE_URL;
 
   try {
-    const baseUrl = process.env.SSEMBLE_API_BASE_URL;
     const server = createSsembleMcpServer(apiKey, baseUrl);
     const transport = new StreamableHTTPServerTransport({
       sessionIdGenerator: undefined, // stateless