MCP / Tools / Screenplay / screenplay_edit_apply

screenplay_edit_apply

writebetaauth: screenplay:writeapproval: requiredstatus: v1

Use to apply user-approved passage edits returned by screenplay_edit_propose, retaining their base_rev, targets and preimages. This changes current screenplay text. Save exact block changes with screenplay_snapshot_apply; apply a complete supplied-text draft with screenplay_draft_apply. Wait for active screenplay generation to finish before editing the same project.

When to use

Use when the caller already has accepted screenplay edits and a known base revision.

When not to use

Do not use to ask the AI for edit suggestions.
Do not use while an active `screenplay_writer` parent job is still generating prose for the same project.

Examples

“Apply these accepted edits to project 42.”

Anti-examples

Propose improvements for this passage.

Backend capabilities

screenplay.apply_surgical_edits

Input schema

screenplay_edit_apply input

{
  "$ref": "./screenplay.apply_surgical_edits.input.json"
}

Output schema

screenplay_edit_apply output

{
  "$ref": "./screenplay.apply_surgical_edits.output.json"
}