katto-mcp 0.3.1 → 0.4.0

package/index.mjs

@@ -135,9 +135,89 @@ const TOOLS = [
       "{ videos_used, videos_limit, videos_remaining }.",
     inputSchema: { type: "object", properties: {} },
   },
+  {
+    name: "katto_list_sources",
+    description:
+      "List the video platforms Katto can clip from, with an example URL for each. Use this to confirm a " +
+      "URL is supported before calling katto_create_clip_job.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "katto_list_clip_lengths",
+    description:
+      "List the valid values for the optional config.clipLength on katto_create_clip_job (target clip " +
+      "duration buckets).",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "katto_rerender_clip",
+    description:
+      "Re-render one finished clip with a new reframe layout and/or caption style. Does NOT use video quota. " +
+      "Returns a rerender_id; poll katto_get_rerender for the new clip url.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "Job id from katto_create_clip_job." },
+        clip_index: { type: "number", description: "0-based index of the clip to re-render." },
+        layout_mode: {
+          type: "string",
+          enum: ["face_tracking", "wide", "split_screen", "stacked", "passthrough", "grid_3", "grid_4"],
+        },
+        caption_style: { type: "string", description: "A caption style preset name." },
+      },
+      required: ["id", "clip_index"],
+    },
+  },
+  {
+    name: "katto_dub_clip",
+    description:
+      "Re-render one finished clip dubbed into one or more languages (en, es, fr, it, pt, hi, ja, zh). Does " +
+      "NOT use video quota. Returns a rerender_id; poll katto_get_rerender for the result.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "Job id." },
+        clip_index: { type: "number", description: "0-based clip index." },
+        languages: {
+          type: "array",
+          items: { type: "string", enum: ["en", "es", "fr", "it", "pt", "hi", "ja", "zh"] },
+        },
+      },
+      required: ["id", "clip_index", "languages"],
+    },
+  },
+  {
+    name: "katto_get_rerender",
+    description:
+      "Poll a re-render started by katto_rerender_clip or katto_dub_clip. Returns { status, clip_url, captions_url }.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "Job id." },
+        rerender_id: { type: "string", description: "The rerender_id returned by rerender/dub." },
+      },
+      required: ["id", "rerender_id"],
+    },
+  },
+];
+
+// Static reference data — returned by the list_* tools without an API call.
+const SOURCES = [
+  { id: 'youtube', example: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ' },
+  { id: 'twitch', example: 'https://www.twitch.tv/videos/123456789' },
+  { id: 'vimeo', example: 'https://vimeo.com/123456789' },
+  { id: 'rumble', example: 'https://rumble.com/v1a2b3c-title.html' },
+  { id: 'zoom', example: 'https://zoom.us/rec/share/abc123' },
+  { id: 'dailymotion', example: 'https://www.dailymotion.com/video/x8abcde' },
+];
+const CLIP_LENGTHS = [
+  { value: 'lt30', label: 'Under 30 seconds' },
+  { value: '30_60', label: '30 to 60 seconds' },
+  { value: '60_90', label: '60 to 90 seconds' },
+  { value: '90_180', label: '90 to 180 seconds' },
 ];
 
-const server = new Server({ name: "katto", version: "0.3.1" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "katto", version: "0.4.0" }, { capabilities: { tools: {} } });
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 
@@ -170,6 +250,19 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       data = await api(`/api/v1/jobs/${encodeURIComponent(args.id)}`, { method: "DELETE" });
     } else if (name === "katto_get_account") {
       data = await api("/api/v1/me");
+    } else if (name === "katto_list_sources") {
+      data = { sources: SOURCES, note: "You can also clip a local file via the REST API (POST /v1/uploads)." };
+    } else if (name === "katto_list_clip_lengths") {
+      data = { clip_lengths: CLIP_LENGTHS };
+    } else if (name === "katto_rerender_clip") {
+      const b = {};
+      if (args.layout_mode) b.layout_mode = args.layout_mode;
+      if (args.caption_style) b.caption_style = args.caption_style;
+      data = await api(`/api/v1/jobs/${encodeURIComponent(args.id)}/clips/${encodeURIComponent(args.clip_index)}/rerender`, { method: "POST", body: JSON.stringify(b) });
+    } else if (name === "katto_dub_clip") {
+      data = await api(`/api/v1/jobs/${encodeURIComponent(args.id)}/clips/${encodeURIComponent(args.clip_index)}/rerender`, { method: "POST", body: JSON.stringify({ dub: args.languages || [] }) });
+    } else if (name === "katto_get_rerender") {
+      data = await api(`/api/v1/jobs/${encodeURIComponent(args.id)}/rerenders/${encodeURIComponent(args.rerender_id)}`);
     } else {
       throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "katto-mcp",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "mcpName": "io.github.miracleweasel/katto-mcp",
   "description": "MCP server for Katto — turn long videos into scored, captioned 9:16 clips from any MCP client (Claude, Cursor, ...).",
   "type": "module",