MCP tools for previz: scene spec and attach playblast #185

New issue

Closed

opened 2026-10-11 06:41:40 +00:00 by crowmaki · 0 comments

crowmaki commented

2026-10-11 06:41:40 +00:00

Owner

Parent

#139

Blocked by: #157

Problem

#157 says the "Shot scene spec" and "attach playblast" MCP tools are a follow-up once #139 lands. The production plan (scratch/scratch-plan.md, Previz section) expects an agent to read a Shot's scene spec through the app's MCP server, and to build and animate the scene through a Blender MCP. #139 put "driving Blender through a Blender MCP or an agent" out of scope. #139 is now done, and the MCP server plan has nothing for previz.

What to build

MCP tools over the existing ProjectSession previz commands:

Mark and unmark a Shot complex.
Read a Shot's previz status and its versions.
Read a Shot's scene spec, with the reference file paths (prepare_blender_scene).
Attach a playblast to a Shot from a file path (the same ingest command as "Import playblast…").
Optionally, "Open in Blender" and "Rebuild Blender scene".

Acceptance criteria

Each tool goes through the same ProjectSession command as the UI, so its edits are undoable with their usual labels
Tests in the style of #157's MCP tests cover reading the scene spec and attaching a playblast

## Parent #139 Blocked by: #157 ## Problem #157 says the "Shot scene spec" and "attach playblast" MCP tools are a follow-up once #139 lands. The production plan (`scratch/scratch-plan.md`, Previz section) expects an agent to read a Shot's scene spec through the app's MCP server, and to build and animate the scene through a Blender MCP. #139 put "driving Blender through a Blender MCP or an agent" out of scope. #139 is now done, and the MCP server plan has nothing for previz. ## What to build MCP tools over the existing `ProjectSession` previz commands: - Mark and unmark a Shot complex. - Read a Shot's previz status and its versions. - Read a Shot's scene spec, with the reference file paths (`prepare_blender_scene`). - Attach a playblast to a Shot from a file path (the same ingest command as "Import playblast…"). - Optionally, "Open in Blender" and "Rebuild Blender scene". ## Acceptance criteria - [ ] Each tool goes through the same `ProjectSession` command as the UI, so its edits are undoable with their usual labels - [ ] Tests in the style of #157's MCP tests cover reading the scene spec and attaching a playblast

crowmaki added the

enhancement

needs-triage

labels

2026-10-11 06:41:45 +00:00

crowmaki referenced this issue

2026-10-11 06:41:51 +00:00

Complex Shots: Blender previz playblast as a video reference #139

crowmaki referenced this issue from a commit

2026-10-14 07:37:15 +00:00

MCP: Previz (#185)

crowmaki referenced this issue from a pull request that will close it,