Script and reference documents
Use these tools to read and change the words and pictures that sit beside your scenes.
Reference documents
Section titled “Reference documents”A reference document holds a title, markdown notes and a small image bank. reference_document_ids on generate_image, refine_image and animate_scene names the documents a generation must match. A scene prompt that writes a document’s exact title also attaches that document.
A reference for one subject (a character, an object, a place or a style) is a sheet document. create_document takes sheet with the subject’s kind and name. The document’s ## Consistency and ## Avoid sections say what must hold and what to avoid. Every picture later added to the document joins the sheet as a named view.
A document attaches to a generation as its sheets, one picture each and three at most. A document without a sheet attaches its pictures as one grid picture. Its text goes whole when short and as a brief when long.
list_documents
Section titled “list_documents”List a project’s reference documents, each with the folder it sits in, plus the project’s folders.
- Surfaces: ChatGPT app v2, Manan
- Parameters:
project_id(required)
get_document
Section titled “get_document”One document’s content and image bank.
In Manan it reads every document kind. On a whiteboard, view: "snapshot" returns pictures of the board as it looks in Screel.
- Surfaces: ChatGPT app v2, Manan
- Parameters:
document_id(required),project_id(required),block_ids,fields,max_blocks,scene_ids,start_block,view
create_document
Section titled “create_document”Start a reference document with a title and markdown blocks, or a sheet document with sheet.
In Manan, kind makes a storyboard, a whiteboard or an empty workflow instead. ops put the first items on a new whiteboard.
- Surfaces: ChatGPT app v2, Manan
- Parameters:
blocks(required),project_id(required),title(required),sheet
edit_document
Section titled “edit_document”Replace a document’s blocks.
- Surfaces: ChatGPT app v2, Manan
- Parameters:
document_id(required),project_id(required),base_version,blocks,title
set_document_image
Section titled “set_document_image”Add or replace a picture in a text document’s bank: a chat file attachment or the URL of a picture Screel already stores. It refuses a whiteboard, storyboard or breakdown.
- Surfaces: ChatGPT app v2, Manan
- Parameters:
document_id(required),project_id(required),image,image_id,image_url,name
get_playbook
Section titled “get_playbook”One of Screel’s playbooks for reference work, as text: consistent-characters, props-and-objects, references-from-uploads, scene-continuity or style-and-world; also workflows in Manan. All but workflows also ship as skills with ChatGPT app v2. It spends no credits.
- Surfaces: ChatGPT app v2, Manan
- Parameters:
topic(required)
open_project
Section titled “open_project”A link that opens the project in the Screel web app. Use it for work with no tool here, such as fine-tuning scene timing, sharing or previewing voices. It changes nothing and spends no credits. In Manan, it works in a conversation with no project open.
- Surfaces: ChatGPT app v2, Manan
- Parameters:
project_id(required),document_id,scene_id,scene_position,view
Script and reference documents on Generic MCP
Section titled “Script and reference documents on Generic MCP”These tools read and change the project’s script and reference documents. The reference document tools work on text documents only and refuse a whiteboard, storyboard, breakdown or workflow. None of them spends credits.
get_script
Section titled “get_script”Read the project’s script: each block with its text and its scene link.
- Surfaces: Generic MCP
- Parameters:
project_id(required),max_blocks,start_block
edit_script
Section titled “edit_script”Rewrite the script. The blocks you send replace the whole document.
- Surfaces: Generic MCP
- Parameters:
blocks(required),project_id(required),base_version
suggest_script_edits
Section titled “suggest_script_edits”Park a proposed script as a suggestion. Nothing changes until you accept it.
- Surfaces: Generic MCP
- Parameters:
blocks(required),project_id(required),title(required),base_version
list_context_bits
Section titled “list_context_bits”List the project’s reference documents.
- Surfaces: Generic MCP
- Parameters:
project_id(required)
get_context_bit
Section titled “get_context_bit”Read one reference document: its text and its image bank.
- Surfaces: Generic MCP
- Parameters:
bit_id(required),project_id(required),max_blocks,start_block
create_context_bit
Section titled “create_context_bit”Create a reference document.
- Surfaces: Generic MCP
- Parameters:
blocks(required),project_id(required),title(required)
update_context_bit
Section titled “update_context_bit”Rewrite a reference document. The blocks you send replace its whole body.
- Surfaces: Generic MCP
- Parameters:
bit_id(required),project_id(required),blocks,title
suggest_context_bit_edits
Section titled “suggest_context_bit_edits”Park a proposed rewrite of a reference document as a suggestion.
- Surfaces: Generic MCP
- Parameters:
bit_id(required),blocks(required),project_id(required),title(required),proposed_title
add_context_bit_image
Section titled “add_context_bit_image”Add a picture to a reference document’s image bank from a public https url.
- Surfaces: Generic MCP
- Parameters:
bit_id(required),image_url(required),project_id(required),name
update_context_bit_image
Section titled “update_context_bit_image”Replace a picture in a reference document’s image bank from a public https url.
- Surfaces: Generic MCP
- Parameters:
bit_id(required),image_id(required),image_url(required),project_id(required),name
view_scene_image
Section titled “view_scene_image”Return a scene’s still as a picture the client can see.
- Surfaces: Generic MCP
- Parameters:
project_id(required),scene_id(required)
view_image
Section titled “view_image”Return a stored picture as a picture the client can see.
- Surfaces: Generic MCP, Manan
- Parameters:
image_url(required)
