goatedit-mcp 1.1.4 → 1.1.6

package/bundle/goatedit-mcp.js

@@ -19194,7 +19194,13 @@ var TEXT_STYLE_PROPS = {
   textSticker: { type: "string", enum: ["ghost", "arrow", "pen", "star", "flame"], description: "Small sticker drawn beside the accent word." },
   textLayoutMode: { type: "string", enum: ["side-grid", "luxury-stack", "editorial-hero", "slanted-red", "double-hero"], description: "Editorial layout engine for multi-word titles." },
   posX: num("Horizontal position as a fraction of the frame, 0..1. 0.5 is centre."),
-  posY: num("Vertical position as a fraction of the frame, 0..1. 0.5 is centre.")
+  posY: num("Vertical position as a fraction of the frame, 0..1. 0.5 is centre."),
+  path: {
+    type: ["object", "null"],
+    description: "Set the text along a curve instead of in a block: { points: [[x, y], ...] (fractions of the frame, at least two; anchors without handles are smoothed into a curve through them, and points may lie outside 0..1 so a ribbon runs off the frame), ribbonColor? (paints a band along the path behind the letters), ribbonWidth? (px @1080p, default 380), waveLength? (px between wave crests, default 900), waveSpeed? (crests per second, default 0.5) }. The clip's position moves the whole path. null returns the text to a block. Text animations do not apply along a path; animate pathOffset and pathWave with set_keyframes (as textPathOffset / textPathWave) instead."
+  },
+  pathOffset: num("Where the middle of the text sits along its path, 0 at the start, 1 at the end (default 0.5). Below 0 or above 1 runs the words off the ends, so keyframing it from -0.3 to 0.5 slides a word in along its ribbon."),
+  pathWave: num("Height of the wave travelling down the path, px @1080p (default 0, flat). It bends the ribbon and the letters together.")
 };
 var BASE_TOOLS = [
   {
@@ -19338,16 +19344,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 +19494,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."),
@@ -19524,6 +19552,7 @@ var BASE_TOOLS = [
       type: "object",
       properties: {
         text: str("The text to display."),
+        name: str("The layer's name in the timeline. Defaults to the text itself."),
         duration: num("How long the card stays on screen, in seconds."),
         startTime: num("Where it starts on the timeline, in seconds. Defaults to 0."),
         trackId: str("Target video track. Defaults to the topmost one that is free across the card\u2019s span, creating a new track above everything if none is free."),
@@ -19613,6 +19642,62 @@ 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", "pile"], description: `sphere (ball), torus (ring), capsule (pill), box (block), cylinder (can), cone, blob, or pile: many balls that burst from the middle and settle in a heap over 3 seconds (its "Burst" animation, which then holds still; delay it with the model3d effect's animOffset, slow it with animSpeed).` },
+        color: str('A solid colour, "#rrggbb". Given on its own it turns any gradient off. 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. "around" closes back on the first colour by itself. For a pile, 1\u20136 colours the balls take turns from.' },
+        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: which blob. Pile: how the balls fall. The same seed gives the same result."),
+        count: num("Pile only: how many balls, 3\u2013150. Defaults to 40."),
+        arrange: { type: "string", enum: ["heap", "burst"], description: 'Pile only: "heap" (default) \u2014 the balls fall and settle in a heap; "burst" \u2014 they fly out every way and hang in the air in a wide cloud, for an explosion of balls around something.' },
+        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", "pile"], description: `sphere (ball), torus (ring), capsule (pill), box (block), cylinder (can), cone, blob, or pile: many balls that burst from the middle and settle in a heap over 3 seconds (its "Burst" animation, which then holds still; delay it with the model3d effect's animOffset, slow it with animSpeed).` },
+        color: str('A solid colour, "#rrggbb". Given on its own it turns any gradient off. 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. "around" closes back on the first colour by itself. For a pile, 1\u20136 colours the balls take turns from.' },
+        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: which blob. Pile: how the balls fall. The same seed gives the same result."),
+        count: num("Pile only: how many balls, 3\u2013150. Defaults to 40."),
+        arrange: { type: "string", enum: ["heap", "burst"], description: 'Pile only: "heap" (default) \u2014 the balls fall and settle in a heap; "burst" \u2014 they fly out every way and hang in the air in a wide cloud, for an explosion of balls around something.' }
+      },
+      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.",
@@ -19701,24 +19786,101 @@ var BASE_TOOLS = [
   },
   {
     name: "join_scenes",
-    description: "Join two scenes at a cut so the edit flows instead of cutting: push (one camera move across a shared canvas \u2014 the outgoing scene speeds out and the incoming arrives at the same speed, so the cut falls mid-motion), zoomThrough (push into one element of the outgoing scene until it fills the frame; the incoming scene opens out of it), or matchCut (a layer of the incoming scene starts exactly where a layer of the outgoing one was \u2014 position, size, turn, through parents, 3D models included \u2014 then settles into its own place). push and zoomThrough add a camera null per side and parent that side's top-level clips to it, so every layer stays editable and the camera's keyframes can be tuned afterwards. at is the cut: outgoing clips end there and incoming clips start there.",
+    description: "Join two scenes at a cut so the edit flows instead of cutting: push (one camera move across a shared canvas \u2014 the outgoing scene speeds out and the incoming arrives at the same speed, so the cut falls mid-motion), zoomThrough (push into one element of the outgoing scene until it fills the frame; the incoming scene opens out of it), or morph (every pair of layers at once, Smart Animate style: each incoming layer starts on the drawn pixels of its outgoing partner \u2014 a tag inside a full-frame snippet counts as the tag \u2014 and stretches and slides into place, pairs staggered left to right), or matchCut (a layer of the incoming scene starts exactly where a layer of the outgoing one was \u2014 position, size, turn, through parents, 3D models included \u2014 then settles into its own place). push and zoomThrough add a camera null per side and parent that side's top-level clips to it, so every layer stays editable and the camera's keyframes can be tuned afterwards. at is the cut: outgoing clips end there and incoming clips start there.",
     inputSchema: {
       type: "object",
       properties: {
         at: num("The cut time in seconds."),
-        type: { type: "string", enum: ["push", "zoomThrough", "matchCut"], description: "Which join." },
+        type: { type: "string", enum: ["auto", "push", "zoomThrough", "matchCut", "morph"], description: "Which join. auto picks one from what is on each side: morph when incoming layers are named after outgoing ones and not animated yet, a push in the outgoing scene's own direction when it is already moving into the cut, a zoom through one small element near the middle, else a push \u2014 and says why in `picked`." },
         duration: num("Seconds the move takes on each side of the cut. Default 0.4."),
         direction: { type: "string", enum: ["left", "right", "up", "down"], description: "push: which way the picture travels. Default left." },
         clipId: str("zoomThrough: the element of the outgoing scene to fly into."),
         zoom: num("zoomThrough: how far in the outgoing camera goes. Default: until the element overfills the frame."),
         inZoom: num("zoomThrough: scale the incoming scene opens from. Default 1.8."),
         fromClipId: str("matchCut: the outgoing layer to match."),
-        toClipId: str("matchCut: the incoming layer that takes its place.")
+        toClipId: str("matchCut: the incoming layer that takes its place."),
+        pairs: {
+          type: "array",
+          items: { type: "object" },
+          description: 'morph: [{ from, to }] clip ids \u2014 each incoming layer starts on its outgoing partner. Omit to pair automatically: layers whose names end in the same word ("S2 tag New" \u2192 "S2 block New"), then the rest left to right. Full-frame grounds are left out.'
+        },
+        stagger: num("morph: seconds between one pair starting and the next, left to right. Default 0.04.")
       },
       required: ["at", "type"]
     },
     method: "joinScenes"
   },
+  {
+    name: "animate_clip",
+    description: "Give one layer a named move from the motion recipe library, already eased, timed and overshot by the motion principles, relative to where the layer rests (it lands on its own position and scale). Entrances: fadeIn, fadeUp, popIn, slideIn, maskReveal (wiped on behind a soft edge), riseFromLine (rises from behind its own baseline \u2014 the title reveal), blurIn (2D only), zoomIn, dropIn (falls, squashes, springs back), growIn (lines and bars), spinIn. Exits (end on the clip's last frame, or `delay` before it): fadeOut, slideOut (pulls back first, then away), popOut, maskHide, blurOut. Between them: hold (a slow drift after landing, so nothing freezes). Through the whole clip: drift (slow push-in for grounds), float (gentle bob). Overshoots are real damped springs. Don't use on text clips: text animates with set_text_animation. An entrance replaces the keys in its own window only, so an entrance and an exit stack. Prefer animate_scene for a whole scene.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: str("The layer to animate."),
+        recipe: {
+          type: "string",
+          enum: ["fadeIn", "fadeUp", "popIn", "slideIn", "maskReveal", "riseFromLine", "blurIn", "zoomIn", "dropIn", "growIn", "spinIn", "fadeOut", "slideOut", "popOut", "maskHide", "blurOut", "hold", "drift", "float"],
+          description: "The move."
+        },
+        style: { type: "string", enum: ["smooth", "snappy", "bouncy"], description: "The feel: smooth (no overshoot, 0.6s), snappy (hard ease-out, small overshoot, 0.4s), bouncy (10% overshoot, 0.55s). Default smooth. Use one feel for a whole video." },
+        delay: num("Entrances: seconds into the clip before the move starts. Exits: seconds before the clip ends that the layer is gone, so a group leaves in turn. Default 0."),
+        from: num("hold: clip-relative second the drift starts (where the entrance lands)."),
+        to: num("hold: clip-relative second it ends (where the exit starts). Default the clip end."),
+        depth: num("hold: how much it drifts \u2014 1 for the hero, 0.4\u20130.6 for what sits behind it."),
+        motionBlur: bool("Smear fast travel with a camera-shutter motion blur (2D layers). Draws once where nothing moves."),
+        arc: num("slideIn, slideOut, dropIn: travel on a curve \u2014 how far the path bows toward the middle of the frame, as a fraction of the travel. 0.3 is gentle. For pictures; keep type and bars straight."),
+        anticipate: bool("fadeOut: a small lift the other way before it fades, for big layers."),
+        length: num("Seconds the move takes. Default by style."),
+        direction: { type: "string", enum: ["left", "right", "up", "down"], description: "Which way the layer travels (slideIn, slideOut, maskReveal, maskHide), or the axis growIn grows on." },
+        distance: num("Travel as a fraction of the frame height. Default by style (0.04\u20130.08).")
+      },
+      required: ["clipId", "recipe"]
+    },
+    method: "animateClip"
+  },
+  {
+    name: "animate_scene",
+    description: "Animate a whole scene the way a motion designer would, in one call. Each layer gets a role from what it draws \u2014 ground (covers the frame: a slow drift), hero (the one thing the scene is about: enters first and biggest), support (staggered outward from the hero), text, detail (small marks, popping in last), follower (parented to a picture: arrives a beat after it) \u2014 and a move and start time from its role, its size, the scene's length and the feel, so the scene speaks one motion language. Text always gets a text animation (letters or words), never a block move; pictures get keyframed recipes. Moves travel the way the scene's joins push (flow). With music on the timeline the lead lands on a beat (onBeat). Pictures travel on arcs, type and bars straight. Between the entrance and the exit every picture keeps a slow drift, deeper for the hero (hold). Layers leave last in, first out, the way the next scene comes in; big layers gather before a fade-out. Moves that would cross another layer are swapped for ones that stay in place (note). Layers that already move are left alone unless replace is true. A scene runs between two cuts; at picks it (default the playhead), all does every scene. Returns what each layer got. Follow with lint_motion to join the cuts.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        at: num("A time inside the scene to animate. Default: the playhead."),
+        all: bool("Animate every scene in the sequence."),
+        style: { type: "string", enum: ["smooth", "snappy", "bouncy"], description: "The feel, for every layer. Default smooth." },
+        replace: bool("Re-animate layers that already move, replacing their entrance (and exit if they leave early)."),
+        flow: { type: "string", enum: ["left", "right", "up", "down"], description: "The way moves travel. Default: the way the scene's join camera moves, else up." },
+        pace: num("Spacing of the cascade: 0.6 tight, 1 normal (default), 1.6 loose."),
+        hold: bool("Keep a slow drift on every picture between its entrance and its exit. Default true."),
+        beats: bool("With music on the timeline (beat markers, or audio clips), move the cascade so the lead lands on the nearest beat. Default true."),
+        dryRun: bool("Return the plan without changing anything.")
+      }
+    },
+    method: "animateScene"
+  },
+  {
+    name: "describe_motion",
+    description: "The motion design rules to animate by \u2014 easing curves, durations, stagger, overshoot, hierarchy, holds and reading time, which join to use between scenes \u2014 the same numbers lint_motion checks. Read it before animating a sequence.",
+    inputSchema: { type: "object", properties: {} },
+    method: "describeMotion"
+  },
+  {
+    name: "lint_motion",
+    description: "Check the open sequence's animation the way a motion designer would: still cuts (the picture jumps instead of moving through the change), linear moves (no easing), several layers making the same entrance on one frame (no stagger), moves too fast to follow, and text cut away before it can be read. Each finding has a message and, when the fix is mechanical, `fix`: [method, params] calls to run in order, one call each (run_tools), then lint again. Applying every fix is the one-click polish.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        from: num("Only findings from this time, seconds."),
+        to: num("Only findings up to this time, seconds.")
+      }
+    },
+    method: "lintMotion"
+  },
+  {
+    name: "list_cuts",
+    description: "Every cut in the open sequence \u2014 a time where layers end and others start together \u2014 with what leaves, what arrives, and whether the picture moves through it (a camera move, or layers moving on both sides) or it jumps (a hard cut, a still frame before an entrance, an exit before a still cut). `stillCuts` lists the ones that jump. Read it before joining scenes, and again after.",
+    inputSchema: { type: "object", properties: {} },
+    method: "listCuts"
+  },
   {
     name: "create_3d_object",
     description: "Make a word, a logo or an SVG solid: extruded to a depth with rounded edges and lit like a 3D model, as its own clip with nothing around it (no backdrop), so it floats over whatever is beneath. Give text (drawn in font/weight/color) or mediaFileId of a transparent PNG or an SVG in the bin (a photo needs remove_background first). spins turns it whole times over the clip; rotateX/Y/Z pose it. It is a showcase clip: describe_effect showcase lists its looks (chrome, glass\u2026), lighting and side colour, set with set_clip_effect.",
@@ -20100,9 +20262,11 @@ var BASE_TOOLS = [
             "orbitStartAngle",
             "pathTrimStart",
             "pathTrimEnd",
-            "pathTrimOffset"
+            "pathTrimOffset",
+            "textPathOffset",
+            "textPathWave"
           ],
-          description: "Property to animate. posX/posY and opacity are 0..1 fractions, rotation is degrees, scaleX/scaleY are multipliers (1 = unchanged), pathTrimEnd 0\u21921 draws a pen stroke on."
+          description: "Property to animate. posX/posY and opacity are 0..1 fractions, rotation is degrees, scaleX/scaleY are multipliers (1 = unchanged), pathTrimEnd 0\u21921 draws a pen stroke on, textPathOffset slides text along its path (0..1) and textPathWave is the height of the wave bending it (px @1080p)."
         },
         keyframes: {
           type: "array",
@@ -20124,7 +20288,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",
@@ -20229,6 +20393,7 @@ var BASE_TOOLS = [
         unit: { type: "string", enum: ["letter", "word", "line"], description: "What the animation steps through." },
         durationIn: num("Seconds for one unit's entrance to complete."),
         stagger: num("Seconds between consecutive units starting. 0 moves them together."),
+        delay: num("Seconds into the clip before the first unit starts. Default 0."),
         distance: num("Slide or offset distance in pixels @1080p, for the slide/spring/unfold presets."),
         highlightColor: str('Highlight colour for the karaoke-style presets and the bar of blockReveal, e.g. "#ff2d55".'),
         order: { type: "string", enum: ["forward", "reverse", "center", "edges", "random"], description: "Which unit goes first. Defaults to reading order." },
@@ -20272,7 +20437,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 +20448,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.6",
   "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",