Skip to content
SupportOpen app

Script and reference documents

Use these tools to read and change the words and pictures that sit beside your scenes.

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 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)

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

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

Replace a document’s blocks.

  • Surfaces: ChatGPT app v2, Manan
  • Parameters: document_id (required), project_id (required), base_version, blocks, title

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

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)

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.

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

Rewrite the script. The blocks you send replace the whole document.

  • Surfaces: Generic MCP
  • Parameters: blocks (required), project_id (required), base_version

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 the project’s reference documents.

  • Surfaces: Generic MCP
  • Parameters: project_id (required)

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 a reference document.

  • Surfaces: Generic MCP
  • Parameters: blocks (required), project_id (required), title (required)

Rewrite a reference document. The blocks you send replace its whole body.

  • Surfaces: Generic MCP
  • Parameters: bit_id (required), project_id (required), blocks, title

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 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

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

Return a scene’s still as a picture the client can see.

  • Surfaces: Generic MCP
  • Parameters: project_id (required), scene_id (required)

Return a stored picture as a picture the client can see.

  • Surfaces: Generic MCP, Manan
  • Parameters: image_url (required)