wassermanproductions/blockout-mcp

MCP server for Blockout — drive the open-source previs app from any MCP agent (Hermes, Claude, Codex). Zero dependencies.

About blockout-mcp

MCP (Model Context Protocol) stdio bridge for Blockout — the open-source previs desktop app for AI filmmaking. With this server connected, an AI agent can stage grey-box worlds, drop in choreographed crowds, animate characters, frame and move the camera with classic cinematography presets, scrub the timeline, take viewport screenshots, and drive exports — everything a human does in the app.

1. The Blockout desktop app must be running with a project open. Get it from the Blockout repo (build from source or use a release DMG). 2. On launch, Blockout starts a localhost-only control server on a random port and writes a discovery file to ~/.config/blockout/control.json (random bearer token, mode 0600, removed on quit). This bridge reads that file automatically — there is nothing to configure and no credentials to enter.

Add to ~/.hermes/config.yaml (or install from the Hermes MCP catalog once listed):

getstate · listassets · addentity · moveentity · deleteentity · addactormark · addcameramark · clearcameramarks · setshot · newshot · applyframing · listcameramoves · applycameramove · settracksubject · listactionpresets · applyactionpreset · listsequencestyles · spawnsequence · setreference · snaptoground · settime · play · stop · screenshot · listpresets · savepreset · applypreset and more — call getstate first; every tool description carries the scene conventions (meters; +X right, −Z forward; heading 0 faces −Z).

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/wassermanproductions--blockout-mcp.html)

Related MCP servers