ShotClick

Lists the user's ShotClick projects (owned and shared), with id and title.

list_projects

Reads the project's research notes (Inbox and notes attached to scenes), with source and date. Most recent first, max 200.

list_research_notes

Reads the project's AI Studio shots (screenplay → image → video pipeline): id, title, source scene, source text and prompts. Empty prompts still have to be written (set_shot_prompts); to create new shots use add_studio_shots.

get_studio_shots

Reads the cards in the AI Studio Cast & Location tab: characters, locations and free REFERENCES (products, objects, styles — kind prop/style/other) with id, name, description and whether they already have an image. Cards with an image are reusable references on shots; to SEE them use view_cast_image. To create or fill them use upsert_studio_cast; the image itself is generated from the app (it spends credits).

get_studio_cast

Reads ONE scene by number (12A works too), with typed blocks (scene-heading, action, character, parenthetical, dialogue). More precise and lighter than get_project when you need to rewrite.

get_scene

Reads a project: title and full scenes (number, heading, text, logline). Scenes with an empty logline don't have one yet.

get_project

Reads the project's other documents: subject, treatment and outline (the beats, with the isConverted flag for those already turned into a scene).

get_documents

Rewrites the content of an existing scene, found by number. Keeps its id, number and position. Requires the Owner or Editor role.

update_scene

Searches text across the project's scenes (case-insensitive). Returns scene, block type and an excerpt for each match (max 40).

search_project

Sets the loglines (1-2 sentence summaries) of one or more scenes in a single call, found by number. Scenes without a logline show an empty logline field in get_project. An empty logline ("") clears the existing one. Requires the Owner or Editor role.

set_loglines

Writes the prompts (image and/or video) of one or more AI Studio shots in a single call, found by id (from get_studio_shots). Omitted fields stay unchanged; an empty string clears them. Requires the Owner or Editor role.

set_shot_prompts

Shows the generated image of a Cast & Location card in AI Studio (character, location or free reference: product, object, style), resized. assetId comes from get_studio_cast. Use it to actually see faces, environments and references before writing prompts that mention them.

view_cast_image

Shows the generated image (keyframe) of an AI Studio shot, resized: use it to see what the shot actually contains before writing or refining the video prompt with set_shot_prompts, so the motion you describe matches the image. take: 1-based index among the shot's takes (from get_studio_shots), omitted = active take. Videos cannot be displayed this way.

view_shot_image

SHOWS the generated video of an AI Studio shot: extracts REAL FRAMES from the file at the requested seconds (default: 5 frames spread over the whole duration) and returns them as images, along with a public downloadable URL and the duration. Use it to actually see what happens in the video (cuts, motion, how well it matches the prompt). take: 1-based index among the video takes (from get_studio_shots), omitted = active. seconds: up to 8 explicit timestamps in seconds (e.g. [5, 8, 12]).

view_shot_video

Writes the project's subject or treatment. SAFETY: if the document is not empty it refuses, unless overwrite=true is passed explicitly — so a client can't wipe out work by mistake. Requires the Owner or Editor role.

update_document