goatedit-mcp 1.1.4 → 1.1.5

package/bundle/goatedit-mcp.js

@@ -19338,16 +19338,38 @@ var BASE_TOOLS = [
   },
   {
     name: "create_sequence",
-    description: "Make a new, empty sequence with the project's frame size and rate. By default it opens, so the edits that follow build it; pass open: false to stay where you are and place it later with add_sequence_clip. Returns its id.",
+    description: "Make a new, empty sequence. It takes the project's frame size and rate unless width, height or fps say otherwise, and can be given a fixed length. By default it opens, so the edits that follow build it; pass open: false to stay where you are and place it later with add_sequence_clip. Returns its id.",
     inputSchema: {
       type: "object",
       properties: {
         name: str("Name for the sequence."),
-        open: { type: "boolean", description: "Open it for editing. Default true." }
+        open: { type: "boolean", description: "Open it for editing. Default true." },
+        width: num("Frame width in pixels."),
+        height: num("Frame height in pixels."),
+        fps: num("Frame rate."),
+        backgroundColor: str('Background colour, e.g. "#000000".'),
+        length: num("A fixed length in seconds: playback and export stop there whatever the clips do. 0 goes back to following the last clip.")
       }
     },
     method: "createSequence"
   },
+  {
+    name: "update_sequence",
+    description: "Rename a sequence or change its own frame size, frame rate, background or fixed length \u2014 the Sequence Settings dialog. Only the fields given change; clips are not rescaled, so check framing with render_preview_frame after a size change. Defaults to the open sequence.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sequenceId: str("Sequence id from list_sequences. Defaults to the open one."),
+        name: str("New name."),
+        width: num("Frame width in pixels."),
+        height: num("Frame height in pixels."),
+        fps: num("Frame rate."),
+        backgroundColor: str('Background colour, e.g. "#000000".'),
+        length: num("A fixed length in seconds: playback and export stop there whatever the clips do. 0 goes back to following the last clip.")
+      }
+    },
+    method: "updateSequence"
+  },
   {
     name: "open_sequence",
     description: "Open a sequence for editing \u2014 the same as clicking its tab. Every tool then reads and edits that sequence; clip and track ids from the one you left no longer apply, so call get_timeline next. Open the previous one again to go back out of a nest.",
@@ -19466,7 +19488,7 @@ var BASE_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        url: str("Publicly reachable https URL of the video, audio or image."),
+        url: str("Publicly reachable https URL of the video, audio or image, or a `magnific:<id>` url from search_stock."),
         name: str("Display name for the bin."),
         type: { type: "string", enum: ["video", "audio", "image"], description: "Kind of media." },
         duration: num("Duration in seconds. Required for video and audio, but treated as a hint \u2014 the probe on import overrides it when they disagree."),
@@ -19613,6 +19635,58 @@ var BASE_TOOLS = [
     },
     method: "updateShapeClip"
   },
+  {
+    name: "create_3d_shape",
+    description: 'Make a 3D shape on the timeline \u2014 a ball, ring, pill, block, can, cone or blob \u2014 with no file to import. It is a 3D model clip: set_clip_effect on its "model3d" effect turns, spins, frames and lights it, and `material` gives it a look (Glass, Chrome, Iridescent, Candy Paint, Pearl\u2026), which keeps the shape\'s own colour or gradient. Position, scale, keyframes and parenting work as on any clip. Drawn at the sequence size on a transparent background, so it stacks over anything.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        shape: { type: "string", enum: ["sphere", "torus", "capsule", "box", "cylinder", "cone", "blob"], description: "sphere (ball), torus (ring), capsule (pill), box (block), cylinder (can), cone, blob." },
+        color: str('Colour when there is no gradient, "#rrggbb". Defaults to near-white.'),
+        gradient: { type: "string", enum: ["none", "around", "vertical", "diagonal"], description: 'Paint `colors` across the shape: "around" runs round its axis (the rainbow ring), "vertical" top to bottom, "diagonal" corner to corner. The gradient is in the mesh, so it turns with the shape and shows through glass.' },
+        colors: { type: "array", items: { type: "string" }, description: '2\u20136 "#rrggbb" colours, spread evenly, for the gradient. Repeat the first at the end for a seamless "around".' },
+        roughness: num("0 mirror-smooth \u2026 1 chalky. Defaults to 0.22 (glossy plastic)."),
+        metalness: num("0 plastic \u2026 1 metal. Defaults to 0."),
+        proportion: num("Ring: tube thickness as a share of its radius, 0.05\u20130.9. Pill, can, cone: length against width, 0\u20134. Blob: lumpiness, 0\u20131."),
+        size: { type: "array", items: { type: "number" }, description: "Block only: [width, height, depth], relative, 0.1\u20134 each." },
+        round: num("Block only: edge rounding, 0 sharp \u2026 1 fully round."),
+        seed: num("Blob only: which blob; the same seed is the same shape."),
+        material: str("A look by name: Original (default, the colour above), Chrome, Gold, Glass, Clay, Toon, Plastic, Matte, Iridescent, Wireframe, X-Ray Glow, Hologram, Crystal, Holographic, Candy Paint, Pearl."),
+        rotateX: num("Starting tilt, degrees."),
+        rotateY: num("Starting turn, degrees."),
+        rotateZ: num("Starting roll, degrees."),
+        spin: num("Turn while it plays, degrees per second."),
+        duration: num("Seconds on screen. Defaults to 5."),
+        startTime: num("Where it starts, seconds. Defaults to 0."),
+        trackId: str('Video track, or "__new_video__" (default) for one free across the span.'),
+        name: str("Display name.")
+      },
+      required: ["shape"]
+    },
+    method: "addShape3D"
+  },
+  {
+    name: "update_3d_shape",
+    description: "Change a 3D shape made with create_3d_shape \u2014 its kind, colour, gradient, gloss or proportions \u2014 keeping the clip, its keyframes and effects. Only the fields given change. Every clip using the same shape changes with it.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: CLIP_ID,
+        shape: { type: "string", enum: ["sphere", "torus", "capsule", "box", "cylinder", "cone", "blob"], description: "sphere (ball), torus (ring), capsule (pill), box (block), cylinder (can), cone, blob." },
+        color: str('Colour when there is no gradient, "#rrggbb". Defaults to near-white.'),
+        gradient: { type: "string", enum: ["none", "around", "vertical", "diagonal"], description: 'Paint `colors` across the shape: "around" runs round its axis (the rainbow ring), "vertical" top to bottom, "diagonal" corner to corner. The gradient is in the mesh, so it turns with the shape and shows through glass.' },
+        colors: { type: "array", items: { type: "string" }, description: '2\u20136 "#rrggbb" colours, spread evenly, for the gradient. Repeat the first at the end for a seamless "around".' },
+        roughness: num("0 mirror-smooth \u2026 1 chalky. Defaults to 0.22 (glossy plastic)."),
+        metalness: num("0 plastic \u2026 1 metal. Defaults to 0."),
+        proportion: num("Ring: tube thickness as a share of its radius, 0.05\u20130.9. Pill, can, cone: length against width, 0\u20134. Blob: lumpiness, 0\u20131."),
+        size: { type: "array", items: { type: "number" }, description: "Block only: [width, height, depth], relative, 0.1\u20134 each." },
+        round: num("Block only: edge rounding, 0 sharp \u2026 1 fully round."),
+        seed: num("Blob only: which blob; the same seed is the same shape.")
+      },
+      required: ["clipId"]
+    },
+    method: "updateShape3D"
+  },
   {
     name: "add_null",
     description: "Add a Null Object: an invisible handle that other clips are parented to (set_parent). Move, scale or rotate the null and everything under it follows, orbiting its position \u2014 the After Effects way to group a polaroid with its caption, or make a whole layout drift as one.",
@@ -20124,7 +20198,7 @@ var BASE_TOOLS = [
         clipId: CLIP_ID,
         type: {
           type: "string",
-          description: "Effect type: blur, invert, hue, saturation, brightness, contrast, exposure, grayscale, sepia, gradientMap, vignette, filmGrain, flicker, posterizeTime, lensDistortion, chromaticAberration, lensFlare, liquidGlass, opacityFx, colorCorrection, depthMap, gradientMap, glow, pixelDissolve, motionBlur, dropShadow, reflection, colorama, outline, echo, flutedGlass, lightRays, halftone, datamosh, roughenEdges, filmStock, halation, starGlow, thermal, colorBalance, duotone, levels, monochrome, channelMixer, dither, threshold, lensBlur, directionalBlur, spinBlur, zoomBlur, sharpen, cameraShake, bulge, twirl, ripple, waveWarp, polarCoords, turbulentDisplace, elasticGrid, gridSplit, cubify, glitch, vhs, ntsc, crtScreen, ledScreen, rgbSplit, jpegGlitch, ascii, macpaint, modulation, stripe, risograph, emboss, bevel, inkBleed, paperTexture, paperCutout, crossHatch, scatter, blobTracker, edgeGlow, plus transform, layer3d, model3d and showcase. Call describe_effect with a type for its parameters, their ranges and what they do before setting anything but the obvious. An unknown name comes back with the full list."
+          description: "Effect type: blur, invert, hue, saturation, brightness, contrast, exposure, grayscale, sepia, gradientMap, vignette, filmGrain, flicker, posterizeTime, lensDistortion, chromaticAberration, lensFlare, liquidGlass, opacityFx, colorCorrection, depthMap, gradientMap, glow, pixelDissolve, motionBlur, dropShadow, reflection, colorama, outline, echo, flutedGlass, lightRays, halftone, datamosh, roughenEdges, filmStock, halation, starGlow, thermal, colorBalance, duotone, levels, monochrome, channelMixer, dither, threshold, lensBlur, directionalBlur, spinBlur, zoomBlur, sharpen, cameraShake, bulge, twirl, ripple, waveWarp, polarCoords, turbulentDisplace, elasticGrid, gridSplit, cubify, glitch, vhs, ntsc, crtScreen, ledScreen, rgbSplit, jpegGlitch, ascii, macpaint, modulation, stripe, risograph, emboss, bevel, inkBleed, paperTexture, paperCutout, crossHatch, scatter, blobTracker, edgeGlow, pageTurn, lightSweep, deepGlow, twister, fill, grid, repeater, plus transform, layer3d, model3d and showcase. Call describe_effect with a type for its parameters, their ranges and what they do before setting anything but the obvious. An unknown name comes back with the full list."
         },
         params: {
           type: "object",
@@ -20272,7 +20346,7 @@ var BASE_TOOLS = [
   },
   {
     name: "search_stock",
-    description: "Search Pexels for stock footage and stills, through the editor's own proxy \u2014 the API key is held server-side, so no key is needed here and the public api.pexels.com endpoint must not be called directly. Results come back with one chosen encode each: the smallest that still covers the project width, because anything larger spends download and decode on pixels the frame discards. Pass a result's `url` straight to add_media_file to bring it into the bin; the browser downloads it itself, so the bytes never cross this bridge. Orientation defaults to the shape of the project, which is what keeps portrait projects from filling up with landscape shots that have to be scaled and cropped.",
+    description: "Search stock footage and stills. source \"pexels\" (default) goes through the editor's own proxy \u2014 the API key is held server-side, so no key is needed here and the public api.pexels.com endpoint must not be called directly. source \"magnific\" searches Magnific footage with the key the USER connected in the editor's Stock \u2192 Magnific panel; never ask for or pass that key here \u2014 if it is not connected the call says so. Magnific results carry a `magnific:<id>` url, `premium` and `aiGenerated`; adding one downloads the full-quality file in the tab and counts against the user's Magnific download quota, so add only what the edit will use. For Pexels: Results come back with one chosen encode each: the smallest that still covers the project width, because anything larger spends download and decode on pixels the frame discards. Pass a result's `url` straight to add_media_file to bring it into the bin; the browser downloads it itself, so the bytes never cross this bridge. Orientation defaults to the shape of the project, which is what keeps portrait projects from filling up with landscape shots that have to be scaled and cropped.",
     inputSchema: {
       type: "object",
       properties: {
@@ -20283,7 +20357,11 @@ var BASE_TOOLS = [
           enum: ["landscape", "portrait", "square"],
           description: "Defaults to the project's own shape \u2014 portrait for a vertical sequence."
         },
-        perPage: num("How many results, 1..80. Defaults to 12.")
+        perPage: num("How many results, 1..80. Defaults to 12."),
+        source: { type: "string", enum: ["pexels", "magnific"], description: "Where to search. Defaults to pexels." },
+        page: num("Magnific only: result page, from 1."),
+        freeOnly: { type: "boolean", description: "Magnific only: clips downloadable without a premium plan." },
+        excludeAi: { type: "boolean", description: "Magnific only: leave out AI-generated clips." }
       },
       required: ["query"]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goatedit-mcp",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "Local MCP server for the GoatEdit video editor: drive your open editor tab from Claude Code or any MCP client",
   "license": "UNLICENSED",
   "type": "module",