MCP / Resources
Resources
Resource families are read-only, URI-addressable snapshots returned as resource_links from tool calls. Use them for large payloads (canon summaries, screenplay snapshots, wizard results) instead of inlining the whole object in a tool response.
| Family | Title | Type | Description |
|---|---|---|---|
account_status | Account Status | Caller-scoped BeatBandit account state including credits plus current default LLM and video model preferences. | |
analysis_wizard_result | Analysis Wizard Result | Read-only finalized Analysis Wizard scores, comments, and rewrite guidance. | |
asset_content | Asset Content | Binary content for one generated BeatBandit asset, delivered through BeatBandit instead of expiring storage URLs. | |
change_wizard_result | Change Story Result | Read-only finalized Change Story proposed changes and summary. | |
creative_canvas_result | Creative Canvas Result | Read-only finalized Creative Canvas directions. | |
diff_proposal | Diff Proposal | Full MCP diff proposal envelope for one saved rewrite or persona proposal. | |
episode_screenplay_result | Episode Screenplay Result | Read-only episodic screenplay generation result for one parent job. | |
export_artifact | Export Artifact | Read-only export artifact metadata or links. | |
media_catalog | Media Catalog | Paginated catalog of generated media assets for one project. | |
mentor_decisions | Story Mentor Decisions | Latest durable Story Mentor decision snapshot for one project. | |
novel_audits | Novel Audit Runs | Read-only history and findings for Novel continuity audit runs. | |
novel_blueprint | Novel Blueprint | Read-only authored Novel development, including unfinished Foundation and Direction; source diagnosis and adaptation units exist only for adaptations. | |
novel_candidate | Novel Manuscript Candidate | Read-only complete current and proposed Chapter documents for one Writer review checkpoint. | |
novel_canon | Novel Canon Ledger | Read-only canonical continuity ledger for a Novel project. | |
novel_changes | Novel Review Changes | Read-only Chapters flagged by upstream changes and open shared manuscript proposal summaries. | |
novel_chapter | Novel Chapter | Read-only complete prose and canonical editable Lexical body, including private author notes and formatting, compact Chapter plan and linked source units. Excludes generation-debug payloads. | |
novel_manuscript | Novel Manuscript | Read-only canonical manuscript assembly in Chapter order. | |
novel_source | Novel Adaptation Source | Read-only normalized source package used by a Novel adaptation project. | |
novel_source_unit | Novel Adaptation Source Unit | Read-only canonical source text and metadata for one source unit linked from a Novel Chapter. | |
novel_voice | Novel Writing Voice | Read-only complete Voice Guidelines, Writing Samples, and revision state for a Novel project. | |
novel_voice_proposal | Novel Voice Options Proposal | Read-only complete Voice Options proposal and proof excerpts for an explicitly selected completed job. | |
polish_wizard_result | Polish Screenplay Result | Read-only finalized Polish Screenplay suggestions and conflicts. | |
project_canon_summary | Project Canon Summary | Compact read-only summary of a BeatBandit project canon. | |
project_chat_history | Project Chat History | Paginated freeform project chat history for one project stage. | |
project_diff_proposals | Diff Proposal Inbox | Recent unapplied MCP diff proposals for one project, including rewrite and persona proposals that can still be applied. | |
project_preferences | Project Preferences | Effective chat-facing project preferences, including provider/model defaults and the default stage snapshot. | |
project_updates | Project Updates | Current rewrite and structural-sync update queue for one project. | |
room_review_result | Room Review Result | Read-only finalized Room Review summary and notes. | |
screenplay_document | Screenplay Document Snapshot | Read-only snapshot of the structured screenplay document. Use the screenplay_sequence resource for a sequence-scoped read. | |
screenplay_scene | Screenplay Scene Snapshot | Read-only snapshot of one screenplay scene. | |
screenplay_sequence | Screenplay Sequence Snapshot | Read-only movie sequence slice using the same scene membership as screenplay_read. sequence_number must be an integer from 1 to 8; episodic documents require episode reads. | |
screenplay_writing_voice | Screenplay Writing Voice | Complete revisioned project Writing Voice artifact, including explicitly requested samples. | |
screenplay_writing_voice_proposal | Screenplay Writing Voice Proposal | Completed editable Screenplay Writing Voice analysis proposal and its base expected revision. | |
sequence_wizard_result | Sequence Wizard Result | Read-only finalized Sequence Wizard update summary. | |
shot_element_library | Shot Element Library | Paginated recurring shot-element library for one project. | |
shot_list_scope | Shot List Scope | Read-only snapshot of a shot-list scope. | |
story_mentor_session | Story Mentor Session | Story Mentor transcript, decision state, and active turn snapshot for one session. | |
template_manifest | Template Manifest | Read-only BeatBandit template manifest. | |
treatment_wizard_result | Treatment Wizard Result | Read-only finalized Treatment Wizard sections and update summary. | |
visual_style_effective | Effective Visual Style | Read-only effective visual style resolution for a project, scene, or shot scope. | |
weave_result | Weave Result | Read-only finalized Weave result with saved episodes and warnings. |