Transitions through MCP
MCP integrations can apply a complete definition through ograf_update_template_set with
operation:{type:"set_transition_logic",definition} and the latest set revision. Template and
component references are validated before one undoable edit. An older unapplied draft must be
applied or discarded first. Use definition:null to remove it; removal or replacement with a
different definition ID requires confirm:true. A loaded live playout session keeps its existing
snapshot until explicitly reloaded.
Live playout through MCP
MCP integrations use ograf_get_playout to read the session and ograf_control_playout to
send load, prepare, take, update, out, clear or unload. Commands require the playout
revision and a unique request ID. Admission is immediate; inspect command status/readiness before
assuming completion. Reusing an identical request ID does not execute another take. Playout
revisions are separate from authoring and template-set revisions.
load snapshots the applied definition and current template edits, initially Off. Prepare stages
resources and data; Take uses the selected state or prepared snapshot; Update changes on-air data.
An Update with mode:"in-place" patches the current graphic without starting a lane transition.
Omit mode, or use mode:"transition", to retain the authored update transition. An optional
stateId guards against updating a different state. This works for the separate live session and
target:"preview"; the preview target accepts Update only, after taking graphics through Studio.
Out follows the authored route, while Clear removes output immediately. Editing or switching the
authoring template does not replace this session. Load again to apply changes, or Unload to stop it.
The session remains alive while Studio is open and is separate from the selected-template preview.