creavit-studio-mcp 1.3.8 → 1.3.9

package/README.md

@@ -7,6 +7,11 @@ and **see the canvas** to verify the result.
 
 macOS only (Creavit Studio is a macOS app). Requires Node 18+.
 
+> This MCP server is client-agnostic — any MCP client can drive the app.
+> That is separate from the **in-app Agent panel**, which shells out to a CLI
+> installed on your Mac and detects only Claude Code and Codex
+> (see `electron/aiAgent/agentCatalog.cjs`).
+
 ## Install
 
 ### Claude Code
@@ -50,9 +55,9 @@ npx creavit-studio-mcp --doctor
 ```
 
 ```
-creavit-studio v1.2.0
+creavit-studio v1.3.9
 
-✓ 50 MCP tools defined
+✓ 104 MCP tools defined
 ✓ Offline project reading available (.crvt files readable without the app)
 ✓ Connected to the app (v3.0.5, pid 61068)
   Open windows: 2
@@ -106,7 +111,8 @@ files directly and work with the app closed.
 `creavit_editor_set_settings`, `creavit_editor_list_zooms`,
 `creavit_editor_add_zoom`, `creavit_editor_update_zoom`,
 `creavit_editor_remove_zoom`, `creavit_editor_segments`,
-`creavit_editor_set_segments`, `creavit_editor_seek`,
+`creavit_editor_set_segments`, `creavit_editor_timeline`,
+`creavit_editor_canvas_elements`, `creavit_editor_seek`,
 `creavit_editor_playback`, `creavit_editor_screenshot`,
 `creavit_editor_export`, `creavit_editor_history`
 
@@ -162,6 +168,24 @@ Timeline & assets: `creavit_motion_segments`, `creavit_motion_library`,
 **Recording** — `creavit_devices_list`, `creavit_recording_status`,
 `creavit_recording_start`, `creavit_recording_stop`
 
+`creavit_recording_start` treats `cameraEnabled`, `micEnabled`, and
+`systemAudioEnabled` as authoritative. Passing `false` updates both capture and
+the recorder UI; disabling the camera also stops and hides its live window.
+
+### Every timeline track and canvas element
+
+`creavit_editor_segments` remains the compact clip/cut API. For the complete
+editor use `creavit_editor_timeline action=list`: it discovers clips, steps,
+zooms, layouts, perspectives, titles, sounds, shortcuts, masks, motion scenes,
+code snippets, media/GIFs, subtitles, and manual-cursor segments. Pass
+`detail=full` to read complete objects, then use get/add/update/remove/replace on
+one returned track type.
+
+`creavit_editor_canvas_elements action=list` returns every transformable item on
+the main canvas. Each item advertises its exact `supports` array and coordinate
+units. Updating the advertised fields can move, resize/scale, rotate, change
+opacity, or hide an element without guessing its internal state shape.
+
 **Browser walkthrough** — `creavit_browser_open`, `creavit_browser_inspect`,
 `creavit_browser_focus`, `creavit_browser_interact`, `creavit_browser_scroll`,
 `creavit_browser_close`, `creavit_record_url_walkthrough`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "creavit-studio-mcp",
-	"version": "1.3.8",
+	"version": "1.3.9",
 	"description": "MCP server that lets AI coding agents (Claude Code, Codex, Cursor) drive the Creavit Studio screen recording app",
 	"keywords": [
 		"mcp",

package/src/tools/editorTools.mjs

@@ -126,6 +126,32 @@ export function editorTools() {
 			inputSchema: schema(),
 		}),
 
+		bridgeTool({
+			name: "creavit_editor_perspective_poses",
+			command: "editor.listPerspectivePoses",
+			description:
+				"Lists the balanced perspective poses (flat, desk, hero, peek-up, lean/iso/float left-right) with their angles. Read this before setting a pose so you pick a real one.",
+			inputSchema: schema(),
+		}),
+
+		bridgeTool({
+			name: "creavit_editor_perspective_pose",
+			command: "editor.setPerspectivePose",
+			description:
+				"Gives a perspective range a balanced camera angle and computes its pivot from a focus point — prefer this over writing raw tiltX/tiltY/skew, which is how lopsided angles happen. `pose` picks the look, `strength` (0..2) makes it subtle or dramatic, `focus` is the canvas point the tilt pivots around as {x,y} in 0..1 (e.g. the UI element the viewer should look at). Add `endPose`/`focusEnd` to animate from one angle/pivot to another across the range. Call creavit_project_save afterwards.",
+			inputSchema: schema({
+				id: S.string("Perspective range id"),
+				index: S.number("Range index when id is unknown (default 0)"),
+				pose: S.string("flat | desk | hero | peek-up | lean-left | lean-right | iso-left | iso-right | float-left | float-right"),
+				endPose: S.string("Pose the range animates towards"),
+				strength: S.number("0..2, default 1"),
+				focus: S.object("Pivot point {x,y} normalized 0..1"),
+				focusEnd: S.object("Pivot point the origin travels to"),
+				scale: S.number("Plane scale at the start"),
+				scaleEnd: S.number("Plane scale at the end"),
+			}),
+		}),
+
 		bridgeTool({
 			name: "creavit_editor_reframe",
 			command: "editor.reframe",
@@ -304,6 +330,48 @@ export function editorTools() {
 			),
 		}),
 
+		bridgeTool({
+			name: "creavit_editor_timeline",
+			command: "editor.timelineSegments",
+			description:
+				"Unified access to EVERY editor timeline track, not just video clips: clips, steps, zooms, layouts, perspectives, titles, sound effects, shortcuts, sensitive masks, motion scenes, code snippets, media/GIFs, subtitles and manual-cursor segments. action='list' discovers track types/counts; use detail='full' to read complete objects. get/add/update/remove/replace target one `type`. Updates are deep-merged so nested transform/style objects are preserved. Call creavit_project_save afterwards.",
+			inputSchema: schema({
+				action: S.string("list, get, add, update, remove or replace (default list)", {
+					enum: ["list", "get", "add", "update", "remove", "replace"],
+				}),
+				types: S.array("Track types to include when listing", { type: "string" }),
+				type: S.string("Target track type for get/add/update/remove/replace"),
+				id: S.string("Segment id"),
+				index: S.number("Zero-based segment index when it has no id"),
+				segment: S.object("Complete segment object to add"),
+				patch: S.object("Fields to update; nested objects are deep-merged"),
+				segments: S.array("Complete replacement list", { type: "object" }),
+				detail: S.string("summary or full (list only)", {
+					enum: ["summary", "full"],
+				}),
+			}),
+		}),
+
+		bridgeTool({
+			name: "creavit_editor_canvas_elements",
+			command: "editor.canvasElements",
+			description:
+				"Lists or transforms every editable element on the MAIN editor canvas: screen, camera, captured windows, GIF/image/video overlays, code snippets, titles, motion scenes and sensitive masks. action='list' returns each element's id, transform, units and exact `supports` fields. action='update' can move (x/y), resize (width/height/size/scale), rotate and change opacity where that element advertises support. Motion Studio's internal layers remain available through creavit_motion_elements / creavit_motion_element_update.",
+			inputSchema: schema({
+				action: S.string("list, get or update (default list)", {
+					enum: ["list", "get", "update"],
+				}),
+				type: S.string(
+					"screen, camera, window, gif, media, codeSnippet, title, motion or sensitive",
+				),
+				id: S.string("Canvas element id"),
+				index: S.number("Index among elements of that type"),
+				patch: S.object(
+					"Transform fields advertised by the element's supports array, e.g. {x,y,width,height,scale,size,rotation,opacity,visible}",
+				),
+			}),
+		}),
+
 		bridgeTool({
 			name: "creavit_editor_seek",
 			command: "editor.seek",

package/src/tools/systemTools.mjs

@@ -74,7 +74,7 @@ export function systemTools() {
 			name: "creavit_recording_start",
 			command: "recording.start",
 			description:
-				"Starts a screen recording idempotently: retries while starting share the same native operation, and calling it while active does not restart. Get source IDs from creavit_devices_list first. For a multi-step website recording, use ONE creavit_record_url_walkthrough call instead of this manual tool.",
+				"Starts a screen recording idempotently: retries while starting share the same native operation, and calling it while active does not restart. cameraEnabled, micEnabled and systemAudioEnabled are authoritative booleans: false also updates the recorder UI/state and cameraEnabled:false stops/hides the live camera window before capture. Get source IDs from creavit_devices_list first. For a multi-step website recording, use ONE creavit_record_url_walkthrough call instead of this manual tool.",
 			inputSchema: schema({
 				options: S.object(
 					"Recording options: {sourceType:'display'|'window'|'area', sourceId, cameraEnabled, micEnabled, systemAudioEnabled, delayMs, area:{x,y,width,height}}. cameraEnabled:false also turns the camera off and hides its window, so it does not appear in a screen recording; cameraEnabled:true opens and starts it.",