Tools

Create or update project-level metadata, settings, and defaults, returning compact stable project identity for follow-up MCP calls.

List accessible projects, read one project by stable id, or re-find a project by exact name.

List available BeatBandit templates and return a compact project creation next-action template.

Generate proposed values for a supported story entity field using BeatBandit's story context, craft rules, and writing-mode awareness.

List, get, or search story graph entities such as cards, scenes, episodes, arcs, and relationships.

Create, update, reorder, or delete story-graph entities using an entity_type discriminator.

Apply accepted, revision-aware screenplay edits.

Propose precise, revision-aware screenplay edits for a selected passage.

Import screenplay text or a Final Draft `.

Read compact screenplay document context, one movie sequence, one scene, or the explicit full document from BeatBandit's structured screenplay editor.

Generate scoped screenplay rewrite proposals and apply them later by proposal_id.

Apply structured screenplay block edits through the snapshot-save path.

Read, preview, or apply a Genre Movie project's structured genre contract.

WRITE actual screenplay prose from existing structured story material.

BUILD new structured story material that does not exist yet — beats, scenes, sequences, treatments, trailer cards, episodes, or weave plans.

REVIEW existing project material and produce editorial feedback — room review (writers'-room style holistic notes), analysis wizard (scored editorial pass with rewrite guidance and comps), or continuity audit / Sync Screenplay (generate, review, and explicitly apply screenplay rewrite suggestions for pending structural-sync update tasks).

CHANGE or POLISH structured story material that already exists in the project.

Generate 2-5 distinct premise TAKES from raw story material before any beats exist - Faithful, More Dramatic, Wildcard, Intimate, High Concept.

Run one-shot Agent Stage personas asynchronously to produce a saved, applyable diff proposal over existing project material.

Hold a Story Mentor conversation over one project using guided mentor turns or freeform project chat turns.

Upload a local, public-URL, or base64 image/audio into BeatBandit as a shot image, recurring shot-element reference, scene moodboard asset, project visual-style reference, or reusable voice reference.

Start exports and retrieve export artifacts.

Generate still-image assets, with distinct workflows for per-shot storyboard/frame images, reusable shot-element references, and scene-level moodboards; fal-backed requests return an async job to poll with `job_get`.

Generate music, speech, dialogue, sound effects, or shot-scoped scene audio.

Run BeatBandit's backend-owned shot-list generation workflow for a project, scene, or episode scope.

Read shot-list scope summaries, shots, recurring elements, and linked shot assets.

Create, update, delete, reorder, or reposition shots, recurring shot elements, scene moodboard selections, and selected shot-audio takes inside an existing shot-list scope using an entity_type discriminator.

Generate shot videos and start video timeline exports, with discoverable model constraints, reference roles, prompt/default resolution, and asset handoff metadata.

List, create, update, archive, and attach reusable voice reference samples for Seed Audio workflows.

Display one BeatBandit asset with inline image rendering or media-ready metadata.

Filter generated media assets, recurring shot elements, or scene moodboards for one BeatBandit project.

Read normalized async job state, progress, and related resource links.