# studio-state

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

- **Category:** Story & Pre-Production
- **Vendor:** Community (DKF2 Studios) (community)
- **Pricing:** free
- **Verified:** 2026-08-15

## 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`
- Local: `python3 /abs/path/studio-state-public/server.py`

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

## Capabilities

`production-state` · `shot-tracking` · [continuity](https://mcp.film/capabilities/continuity.md) · `session-orientation` · [render-status](https://mcp.film/capabilities/render-status.md)

## Sample tools

`orient` · `get_shot_status` · `update_shot`

## Field notes

MIT, still live but static: last commit 16 Jun 2026 and still 0 stars, so treat it as one studio's shim published rather than a maintained project. 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.

## Verification

- Status: Freshly checked (13 days old)
- Added: 2026-06-28
- Last verified: 2026-08-15
- Machine JSON: https://mcp.film/api/mcps/studio-state.json

## Links

- Site: https://dkf2studios.gumroad.com/l/flplx?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=studio-state%3Asite
- Docs: https://github.com/dkf2studios/studio-state-public/blob/main/INSTALL.md?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=studio-state%3Adocs
- Repo: https://github.com/dkf2studios/studio-state-public

---

Structured data: https://mcp.film/api/mcps/studio-state.json · Directory: https://mcp.film