mcp.film / Story & Pre-Production / studio-state

studio-state

Communityby Community (DKF2 Studios)freeverified Sep 20, 2026

Keeps AI-film characters, locations, shots, and lock status grounded in project files.

What it does

A stateless MCP server for long-running AI film and episodic projects: it reads a file-based show folder and tells an agent where the production stands. Its tools orient the session, report per-shot status, and write only a small sidecar when a shot is fired, locked, or needs rework.

Connect

Claude Code

claude mcp add studio-state -e STUDIO_ROOT=/abs/path/your_show -- python3 /abs/path/studio-state-public/server.py

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "studio-state": {
      "command": "python3",
      "args": [
        "/abs/path/studio-state-public/server.py"
      ],
      "env": {
        "STUDIO_ROOT": "YOUR_KEY_HERE"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "studio-state": {
      "command": "python3",
      "args": [
        "/abs/path/studio-state-public/server.py"
      ],
      "env": {
        "STUDIO_ROOT": "YOUR_KEY_HERE"
      }
    }
  }
}

Auth: local-app · env STUDIO_ROOT — Requires a local project folder containing _pipeline/STATE.json and episodes/

Sample tools

orientget_shot_statusupdate_shot

Field notes

MIT, still live but frozen: re-checked 20 Sep 2026 and the last push is unchanged at 16 Jun 2026 — three months without a commit — with still 0 stars, so treat it as one studio's shim published rather than a maintained project. The repo is not archived and INSTALL.md is still in place, so nothing has broken; nothing has moved either. Prerequisites the README front-loads: Python 3.9+ and `pip install "mcp[cli]"`, plus a project root containing _pipeline/STATE.json and episodes/ — run tests/test_acceptance.py against the bundled demo project first (expect 4/4). It is a state shim, not a generator, and the paid Studio Method pack is upsold in the README. The useful bit is safe by design — only `update_shot` writes, and only to a per-scene `shot_status.json` sidecar.

Also in Story & Pre-Production

Movie Scene Map (formerly FilmMap)Movie Scene Map Official

Where films and series were actually shot: 31,000+ locations in 177 countries, from Wikidata.

filming-locations · location-scoutingremote · free

Miro MCPMiro Official

Official Miro MCP — build and read storyboards, frames, and planning boards via AI.

storyboarding · board-creationremote · freemium

FrameThrowerFrameThrower AI, Inc. Official

Cinematography reference: search film stills from 5,489 films by lighting, lens, shot size, colour and mood.

reference-search · craft-filteringremote · freemium

PenShot (story-shot-agent)neopen

Breaks screenplays into shot lists and generates Sora/Veo/Runway-ready video prompts.

screenplay-parsing · shot-breakdownfree

Used in

Character-Consistent Series · Build a character-consistent series

Pairs well with

Adobe for CreativityAdobe Official

Adobe's official hosted MCP — 50+ tools across Photoshop, Lightroom, Firefly, Premiere, Express and Stock.

image-editing · image-enhancementremote · freemium

Adobe Run-Workflow MCPAdobe Official

Adobe's second hosted MCP — compose and run Firefly Creative Production batch pipelines.

batch-processing · workflow-automationremote · paid

Airtable MCP ServerAirtable Official

Official hosted Airtable MCP: query, create, and update production-tracking bases.

base-search · schema-inspectionremote · freemium