MCP App Store
by KeenEthics
ShotClick icon

ShotClick MCP Server for Claude and ChatGPT

By ShotClick

Overview

ShotClick is a professional screenplay editor: industry-standard formatting, locked scene numbers with A/B suffixes, colored revision passes, real-time collaboration and Final Draft (.fdx) export. This connector lets Claude work inside your actual script instead of in a chat window. Claude can list your projects and read a whole screenplay or a single scene as typed blocks (scene heading, action, character, parenthetical, dialogue), together with the subject, treatment, outline, title page, characters, research notes and comments. It writes back properly formatted scenes, inserts a scene between two existing ones, rewrites a scene in place or just one line of it (comments pinned to that line and its revision marks stay attached), sets scene loglines, drafts the subject or treatment, appends outline beats and saves research notes. It can save alternate versions of a dialogue line next to the one in use, so you pick the one you like in the editor, and it can leave a comment on a line instead of changing the text. It can also open a "what if" branch from any scene, so an alternate version of the story, such as an ending B, is written in parallel without touching the original. Safe by design: the connector enforces the app's own permissions on the server (Owner and Editor can write, a Viewer stays read-only), no tool deletes anything, overwriting a non-empty subject or treatment requires an explicit overwrite flag, and every tool is annotated as read-only or write. The connector works with text only: it generates no images, video or audio, and no tool spends ShotClick credits or touches billing. The writing is done by Claude; ShotClick keeps it a screenplay. Free with any ShotClick account: every new account gets 14 days with no limits, then the connector stays free on one project of up to 10 scenes, with 10 writes a month (reading works on all projects). The Studio plan removes the limits.

How to connect

  1. Claude: Open the ShotClick listing in the Claude connectors directory and choose Connect. Claude listing ShotClick exposes 24 tools here.
  2. ChatGPT: Open the ShotClick listing in the ChatGPT app directory and choose Connect. ChatGPT listing ShotClick exposes 24 tools here.

Tools

add_comment

ChatGPT
Leaves a comment on the project, like a script note: a general one, one pinned to a specific line (pass sceneNumber and blockIndex from get_scene), or a reply in an existing thread (replyTo = a comment id from list_comments). The screenplay text is not changed. The comment appears in the app's Comments panel under the connected account's name, marked "(AI)". Works with any role, Viewer included.

add_dialogue_alternatives

ChatGPT
Saves one or more ALTERNATE VERSIONS of a dialogue line, next to the version in use (in the app: the "Alt" button on a dialogue line). Additive: the line in the screenplay does not change and no existing alternative is removed; the writer picks a version in the app, or you can switch it with choose_dialogue_alternative. Find the line with get_scene (each block has an index). Requires the Owner or Editor role.

add_outline_beat

ChatGPT
Appends a beat to the outline (additive: it never touches existing beats). From the outline the user can then generate the scenes in the app. Requires the Owner or Editor role.

add_research_note

ChatGPT
Saves a research note in the project (it lands in the app's Research Inbox).

add_scene

ChatGPT
Appends a scene to the end of the project. heading = scene heading (e.g. "INT. HOUSE — DAY"), body = text in screenplay format. Requires the Owner or Editor role.

add_studio_shots

ChatGPT
Creates one or more shots in the project's AI Studio (appended to the existing ones, in the given order). Each shot can come from a screenplay scene (sceneNumber: title and source text are taken from the scene) or be free-standing (explicit title/sourceText); imagePrompt and videoPrompt are optional and can be written later with set_shot_prompts. ADDITIVE: it never touches existing shots. Requires the Owner or Editor role.

choose_dialogue_alternative

ChatGPT
Puts one of the saved alternate versions of a dialogue line in use: the chosen version becomes the line in the screenplay and the previous line takes its place among the alternatives (a swap, nothing is lost). get_scene shows each dialogue line with its alternatives. Requires the Owner or Editor role.

create_branch

ChatGPT
Creates a "what if" branch from a scene: an alternate version of the story (e.g. an ending B) that runs in parallel without touching the original. The scene it creates starts the branch; add_scene calls right after continue it. heading and body (optional) fill the first scene of the branch. The user compares branches in the app with the timeline selector and the Canvas board. Requires the Owner or Editor role.

create_project

ChatGPT
Creates a new empty project (screenplay) for the user.

get_credits

ChatGPT
AI credit balance of the connected account (MCP tools never spend credits).

get_documents

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

get_project

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

get_scene

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

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

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

insert_scene

ChatGPT
Inserts a new scene right AFTER an existing one, in the middle of the story (add_scene only appends at the end). heading = scene heading (e.g. "INT. HOUSE — DAY"), body = text in screenplay format. The scenes that follow shift by one; when the project's numbering is locked for production, the new scene gets a letter number (e.g. 12A) and the others keep theirs. Requires the Owner or Editor role.

list_characters

ChatGPT
Lists the project's characters, derived from the character blocks: name, number of lines and scenes they appear in. Sorted by line count.

list_comments

ChatGPT
Reads the project's comments and pins: text, author name (never the email), anchor block and reply thread. Max 200.

list_projects

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

list_research_notes

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

rename_project

ChatGPT
Changes the title of a project (the screenplay's title, also shown on the title page). Requires the Owner or Editor role.

search_project

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

set_loglines

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

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

ChatGPT
Fills in the screenplay's title page: author, "based on" credit, contact details and date (the title itself is the project title: see rename_project). Only the fields passed are changed; pass "" to clear one. The cover image is not affected. get_documents returns the current title page. Requires the Owner or Editor role.

update_block

ChatGPT
Rewrites ONE line (block) of a scene and leaves the rest of the scene untouched: the line keeps its identity, so comments pinned to it, revision marks and alternate versions stay attached. Prefer it to update_scene for small edits. On a dialogue line, keepPreviousAsAlternative=true saves the old text among the alternate versions instead of discarding it. Find the line with get_scene (each block has an index). Requires the Owner or Editor role.

update_document

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

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

upsert_studio_cast

ChatGPT
Creates or fills cards in the AI Studio Cast & Location tab. Each entry: with assetId (from get_studio_cast) it UPDATES the name/description of the existing card (omitted fields stay unchanged); without assetId it CREATES a new card (kind + name required: "character", "location", or a free REFERENCE — "prop" for products and objects, "style" for visual styles, "other"). The description doubles as the prompt the app uses to generate the reference image — write it visual and concrete (characters: age, face, build, clothes; locations: setting, period, light, materials; products: shape, materials, packaging, background). It never touches images or other cards. Requires the Owner or Editor role.

view_cast_image

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

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

ChatGPT
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]).

add_comment

Claude

add_dialogue_alternatives

Claude

add_outline_beat

Claude

add_research_note

Claude

add_scene

Claude

choose_dialogue_alternative

Claude

create_branch

Claude

create_project

Claude

get_credits

Claude

get_documents

Claude

get_project

Claude

get_scene

Claude

insert_scene

Claude

list_characters

Claude

list_comments

Claude

list_projects

Claude

list_research_notes

Claude

rename_project

Claude

search_project

Claude

set_loglines

Claude

set_title_page

Claude

update_block

Claude

update_document

Claude

update_scene

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/shotclick"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/shotclick)