@writepanda/mcp 1.24.0 → 1.25.0

package/bin/server.mjs

@@ -369,10 +369,32 @@ const TOOLS = [
 	{
 		name: "project_list",
 		description:
-			"List every project on disk (id, name, path, modifiedAt, clipCount, revision). Returns the project UUID — pass it as `id` to most other tools.",
-		inputSchema: { type: "object", properties: {} },
+			"List projects in the active workspace (id, name, path, modifiedAt, clipCount, revision, workspaceId). Pass `allWorkspaces: true` to see across every workspace on the machine. Each row carries its workspaceId; the top-level response also returns currentWorkspaceId so you can detect cross-workspace mismatches.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				allWorkspaces: {
+					type: "boolean",
+					description:
+						"When true, list across every workspace (each row tagged with workspaceId). Default false — current workspace only.",
+				},
+			},
+		},
 		command: "project.list",
 	},
+	{
+		name: "project_locate",
+		description:
+			"Look up a project's owning workspace WITHOUT reading the project body. Returns { id, filePath, workspaceId, workspaceName, isInActiveWorkspace }. **Cheap pre-flight you SHOULD call when given a project id with no other context** — before any edit, export, or publish. If isInActiveWorkspace is false, surface the mismatch to the user before proceeding (the YouTube account + Replicate key are workspace-scoped, so publishing to YouTube on the wrong workspace publishes to the wrong client's channel).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Project UUID." },
+			},
+			required: ["id"],
+		},
+		command: "project.locate",
+	},
 	{
 		name: "project_current",
 		description:
@@ -396,7 +418,7 @@ const TOOLS = [
 	{
 		name: "project_read",
 		description:
-			"Read a project's full JSON. Returns { path, project, clipStates }. `clipStates` is a per-clip summary: { clipId, mediaPath, durationMs, transcribed, wordCount, audioCleaned, cleanedAudioPath? } — use it to decide whether to call transcript_transcribe or audio_clean before editing. Pass `project.revision` back as `expectedRevision` on subsequent writes for conflict-safe edits. **Performance tip:** pass `includeTranscript: false` after your first read to drop the per-clip transcript words from the response — they're typically 600+ KB on a 5-minute recording and most agent flows don't need them after pacing is done. clipStates always tells you the transcribed/wordCount status either way.",
+			"Read a project's full JSON. Returns { path, project, clipStates, workspaceId, workspaceName, isInActiveWorkspace }. `clipStates` is a per-clip summary: { clipId, mediaPath, durationMs, transcribed, wordCount, audioCleaned, cleanedAudioPath? } — use it to decide whether to call transcript_transcribe or audio_clean before editing. **Workspace fields:** every read includes the project's owning workspace; if `isInActiveWorkspace` is false, the YouTube account and Replicate key in scope are NOT the ones that own this project — surface the mismatch to the user before any export or publish. Pass `project.revision` back as `expectedRevision` on subsequent writes for conflict-safe edits. **Performance tip:** pass `includeTranscript: false` after your first read to drop the per-clip transcript words from the response — they're typically 600+ KB on a 5-minute recording and most agent flows don't need them after pacing is done. clipStates always tells you the transcribed/wordCount status either way.",
 		inputSchema: {
 			type: "object",
 			properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@writepanda/mcp",
-	"version": "1.24.0",
+	"version": "1.25.0",
 	"description": "Model Context Protocol server for PandaStudio. Exposes the desktop video editor's automation surface to Cursor, Continue, Cline, Claude Desktop, and any MCP-compliant client.",
 	"keywords": [
 		"pandastudio",