@ssemble/mcp-server 1.1.0 → 1.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssemble/mcp-server",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "mcpName": "com.ssemble/mcp-server",
   "description": "MCP server for Ssemble AI Clipping — create viral short-form videos from any AI assistant. Webhook callbacks for n8n, Zapier, and Make automation.",
   "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. Supports webhook callbacks.",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "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.1.0",
+      "version": "1.1.1",
       "transport": {
         "type": "stdio"
       },

package/src/tools/create-short.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { formatCreateShortResponse, formatError } from '../utils/format.js';
+import { saveRequest } from '../utils/session-store.js';
 
 const SUPPORTED_LANGUAGES = [
   'en', 'es', 'fr', 'de', 'it', 'pt', 'ru', 'ja', 'ko', 'zh',
@@ -55,6 +56,15 @@ export function registerCreateShort(server, client) {
 
       try {
         const result = await client.createShort(params);
+        const requestId = result.data?.requestId;
+        if (requestId) {
+          saveRequest(requestId, {
+            url: params.url || params.fileUrl || '',
+            title: null,
+            status: 'queued',
+            createdAt: new Date().toISOString(),
+          });
+        }
         return { content: [{ type: 'text', text: formatCreateShortResponse(result) }] };
       } catch (error) {
         return { content: [{ type: 'text', text: formatError(error) }], isError: true };

package/src/tools/get-shorts.js

@@ -1,9 +1,10 @@
 import { z } from 'zod';
 import { registerAppTool } from '@modelcontextprotocol/ext-apps/server';
-import { formatShortsResponse, formatError } from '../utils/format.js';
+import { formatShortsResponse, formatRecentRequests, formatError } from '../utils/format.js';
+import { getRecentRequests, hasRequests, updateRequest } from '../utils/session-store.js';
 
 const schema = {
-  requestId: z.string().regex(/^[0-9a-fA-F]{24}$/).describe('The request ID from create_short (24-char hex)'),
+  requestId: z.string().regex(/^[0-9a-fA-F]{24}$/).describe('The request ID from create_short (24-char hex). Omit to see your recent requests.').optional(),
 };
 
 export function registerGetShorts(server, client) {
@@ -13,15 +14,33 @@ export function registerGetShorts(server, client) {
     {
       title: 'Get Shorts',
       description:
-        'Retrieve all generated short clips for a completed request. Returns video URLs, AI-generated titles, descriptions, viral scores, and durations sorted by viral score.',
+        'Retrieve all generated short clips for a completed request. Provide a request ID, or omit it to see your recent requests and pick one.',
       inputSchema: schema,
       _meta: {
         ui: { resourceUri: 'ui://ssemble/shorts-app.html' },
       },
     },
     async ({ requestId }) => {
+      if (!requestId) {
+        // No ID given — show recent requests so user can pick
+        if (hasRequests()) {
+          const recent = getRecentRequests(5);
+          return { content: [{ type: 'text', text: formatRecentRequests(recent, 'get_shorts') }] };
+        }
+        try {
+          const result = await client.listRequests({ limit: 5, sortOrder: 'desc' });
+          return { content: [{ type: 'text', text: formatRecentRequests(result.data?.requests || [], 'get_shorts', true) }] };
+        } catch (error) {
+          return { content: [{ type: 'text', text: formatError(error) }], isError: true };
+        }
+      }
+
       try {
         const result = await client.getShorts(requestId);
+        // Save the video title back to session store for future lookups
+        if (result.data?.title) {
+          updateRequest(requestId, { title: result.data.title, status: result.data.status });
+        }
         const textFallback = formatShortsResponse(result);
         const d = result.data;
 

package/src/tools/get-status.js

@@ -1,18 +1,35 @@
 import { z } from 'zod';
-import { formatStatusResponse, formatError } from '../utils/format.js';
+import { formatStatusResponse, formatRecentRequests, formatError } from '../utils/format.js';
+import { getRecentRequests, hasRequests, updateRequest } from '../utils/session-store.js';
 
 const schema = {
-  requestId: z.string().regex(/^[0-9a-fA-F]{24}$/).describe('The request ID from create_short (24-char hex)'),
+  requestId: z.string().regex(/^[0-9a-fA-F]{24}$/).describe('The request ID from create_short (24-char hex). Omit to see your recent requests.').optional(),
 };
 
 export function registerGetStatus(server, client) {
   server.tool(
     'get_status',
-    'Check processing status and progress of a short creation request. Returns status (queued/processing/completed/failed), progress percentage, and current step.',
+    'Check processing status of a short creation request. Provide a request ID, or omit it to see your recent requests and pick one.',
     schema,
     async ({ requestId }) => {
+      if (!requestId) {
+        // No ID given — show recent requests so user can pick
+        if (hasRequests()) {
+          const recent = getRecentRequests(5);
+          return { content: [{ type: 'text', text: formatRecentRequests(recent, 'get_status') }] };
+        }
+        // Nothing in session — fall back to API list
+        try {
+          const result = await client.listRequests({ limit: 5, sortOrder: 'desc' });
+          return { content: [{ type: 'text', text: formatRecentRequests(result.data?.requests || [], 'get_status', true) }] };
+        } catch (error) {
+          return { content: [{ type: 'text', text: formatError(error) }], isError: true };
+        }
+      }
+
       try {
         const result = await client.getStatus(requestId);
+        updateRequest(requestId, { status: result.data?.status });
         return { content: [{ type: 'text', text: formatStatusResponse(result) }] };
       } catch (error) {
         return { content: [{ type: 'text', text: formatError(error) }], isError: true };

package/src/utils/format.js

@@ -99,23 +99,51 @@ export function formatListRequestsResponse(result) {
   }
 
   let text = `## Your Requests (Page ${p.page}/${p.totalPages}, ${p.totalCount} total)\n\n`;
-  text += `| # | Request ID | Status | Progress | Created | Duration |\n`;
-  text += `|---|-----------|--------|----------|---------|----------|\n`;
 
   requests.forEach((req, i) => {
+    const num = (p.page - 1) * p.limit + i + 1;
     const created = req.createdAt ? new Date(req.createdAt).toLocaleDateString() : 'N/A';
-    const duration = req.duration ? `${req.duration}s` : 'N/A';
-    text += `| ${(p.page - 1) * p.limit + i + 1} | \`${req.requestId}\` | ${req.status} | ${req.progress || 0}% | ${created} | ${duration} |\n`;
+    const label = req.title || req.url || req.fileUrl || 'Unknown source';
+    const short = label.length > 60 ? label.substring(0, 57) + '...' : label;
+    text += `**${num}. ${short}**\n`;
+    text += `   ID: \`${req.requestId}\` | Status: ${req.status} | Progress: ${req.progress || 0}% | Created: ${created}\n\n`;
   });
 
   if (p.totalPages > 1) {
-    text += `\nPage ${p.page} of ${p.totalPages}. Use \`page\` parameter to browse more.`;
+    text += `Page ${p.page} of ${p.totalPages}. Use \`page\` parameter to browse more.`;
   }
 
   text += formatRateLimits(result.rateLimits);
   return text;
 }
 
+/**
+ * Formats recent requests for the "no requestId given" UX.
+ * Used by get_status and get_shorts when called without a requestId.
+ * @param {Array} requests - from session store or API list_requests
+ * @param {string} tool - 'get_status' or 'get_shorts'
+ * @param {boolean} fromApi - true if coming from list_requests API (different field names)
+ */
+export function formatRecentRequests(requests, tool, fromApi = false) {
+  if (requests.length === 0) {
+    return `No recent requests found. Use \`create_short\` to create one.`;
+  }
+
+  let text = `## Your Recent Requests\n\nWhich request would you like to check?\n\n`;
+
+  requests.forEach((req, i) => {
+    const id = fromApi ? req.requestId : req.requestId;
+    const label = req.title || req.url || req.fileUrl || 'Unknown source';
+    const short = label.length > 70 ? label.substring(0, 67) + '...' : label;
+    const status = req.status || 'unknown';
+    text += `**${i + 1}. ${short}**\n`;
+    text += `   ID: \`${id}\` | Status: ${status}\n\n`;
+  });
+
+  text += `Reply with the number or paste the request ID, and I'll call \`${tool}\` for you.`;
+  return text;
+}
+
 export function formatTemplatesResponse(result) {
   const d = result.data;
   const templates = d.templates || [];

package/src/utils/session-store.js

@@ -0,0 +1,30 @@
+/**
+ * In-memory session store for request metadata.
+ * Maps requestId → { url, title, status, createdAt }
+ * Title is populated from get_shorts response once available.
+ * Lost when the MCP server process restarts (by design — use list_requests for history).
+ */
+
+const store = new Map();
+
+export function saveRequest(requestId, meta) {
+  store.set(requestId, { ...meta, savedAt: Date.now() });
+}
+
+export function updateRequest(requestId, updates) {
+  const existing = store.get(requestId);
+  if (existing) {
+    store.set(requestId, { ...existing, ...updates });
+  }
+}
+
+export function getRecentRequests(limit = 5) {
+  return [...store.entries()]
+    .sort((a, b) => b[1].savedAt - a[1].savedAt)
+    .slice(0, limit)
+    .map(([requestId, meta]) => ({ requestId, ...meta }));
+}
+
+export function hasRequests() {
+  return store.size > 0;
+}