JsonCut

Append a complete HTML fragment inside one parent layer. Read the current project version first; on conflict reread before retrying. Changes existing saved account data; may replace or remove existing content.

jsoncut_append_child_html

Append a complete HTML fragment to the project root. Read the current project version first; on conflict reread before retrying. Changes existing saved account data; may replace or remove existing content.

jsoncut_append_root_html

Apply one discovered motion preset to an existing layer, replacing its motion settings. Read the current project version first; on conflict reread before retrying. Use the returned version for the next mutation. Persists changes in the connected account. Retrying a successful mutation can duplicate or repeat the change.

jsoncut_apply_motion

Set editable text animation on one existing text layer. Omit exitEffect to preserve its exit animation; an entrance does not imply an exit. Read the current project version first; on conflict reread before retrying. Use the returned version for the next mutation. Persists changes in the connected account. Retrying a successful mutation can duplicate or repeat the change.

jsoncut_apply_text_motion

Apply bounded editable layers, optional scenes, SVG, custom blocks or keyframes. Prefer add_text/add_shape/add_media for designed compositions; use SVG as an intentional hybrid/atomic layer when appropriate. Text inside compact controls must share their bounds and be centered. Compatibility batch of the same explicitly registered operations: jsoncut_insert_library_item, jsoncut_add_scene, jsoncut_add_text, jsoncut_add_caption_track, jsoncut_add_shape, jsoncut_add_component, jsoncut_add_canvas, jsoncut_update_clip, jsoncut_update_canvas, jsoncut_apply_motion, jsoncut_apply_text_motion, jsoncut_group, jsoncut_add_media, jsoncut_add_svg, jsoncut_add_custom, jsoncut_patch_clip, jsoncut_patch_svg, jsoncut_patch_custom, jsoncut_ungroup, jsoncut_delete_clip. Prefer the individual tool for one change. The complete typed action union is declared in this tool schema; no additional operation is discovered or enabled at runtime. Changes existing saved account data; may replace or remove existing content.

jsoncut_author_project

Edit one long-video scene by its canonical outline id with <=24 typed actions. Times are scene-relative. Send only one mutation call per response, then use its returned version. Compatibility batch of the same explicitly registered operations: jsoncut_insert_library_item, jsoncut_add_text, jsoncut_add_shape, jsoncut_group, jsoncut_add_media, jsoncut_add_svg, jsoncut_add_custom, jsoncut_patch_clip, jsoncut_patch_svg, jsoncut_patch_custom, jsoncut_ungroup, jsoncut_delete_clip. Prefer the individual tool for one change. The complete typed action union is declared in this tool schema; no additional operation is discovered or enabled at runtime. Changes existing layers; uses account-scoped reads and version checks.

jsoncut_author_scene

Measure an owned audio/video source and bind its real energy to a visual layer. Source limit 300s/250MB. Studio can edit/remove this binding; trim, offset, rate and loops follow the audio layer. Channel energy is pre-mix, not invented waveform data; onset markers are not a guaranteed musical beat grid. Scale/opacity amount must be -1..1, y -1000..1000. Rebind after replacing source media. Explicitly patch audioReactive=null to remove. Replaces motion settings on an existing layer.

jsoncut_bind_audio_motion

Queue up to 500 independently validated rows against one template version. Queues multiple renders using existing allowance; optional webhook delivery cannot be recalled. Retrying can duplicate the batch.

jsoncut_bulk_render_template

Cancel a running template batch.

jsoncut_cancel_bulk_render

Cancel a queued or running render.

jsoncut_cancel_render

Optionally persist a version-bound quality review; works without cut.md and never gates rendering. full_playback_confirmed is an explicit caller attestation: leave false for grids, onion skin, metadata or sampled frames. Only attest after actual complete playback in a capable client or explicit human confirmation, never on render success. Evidence accepts exact-frame renders/crops; reference comparisons require a cut.md-linked image. Persists a quality review and may queue evidence renders; this is not a read-only check.

jsoncut_check_project

Establish a short-lived editor session for the connected account. UI-only; does not edit, render or share content.

jsoncut_connect_studio

Prepare private playback of one owned export. UI-only; no public link, render or project changes.

jsoncut_connect_preview

Create one central production ledger for projects, style variation, asset uniqueness and approvals. Persists a new record in the connected account. Retrying can create a duplicate.

jsoncut_create_batch

Create one durable HTML-first image or video project. Set source.editabilityTarget to layered, hybrid or atomic when Studio editing granularity matters. Empty variables/customBlocks may be omitted. Persists a new record in the connected account. Retrying can create a duplicate.

jsoncut_create_project

Create a 60-900s one-use URL. Requires a client that can read and HTTP-PUT the real file bytes; OAuth alone does not grant that capability. PUT application/octet-stream with exact Content-Length. If the response is lost, get_upload_status before retrying. If client egress is blocked, use get_upload_handoff, never a proxy workaround. Persists an upload, upload session or font registration. Retrying can create a duplicate.

jsoncut_create_upload_ticket

Remove one existing layer or group from the saved project. Removing a group may remove its children. Read the current project version first; on conflict reread before retrying. Use the returned version for the next mutation. Optional scene_id restricts this same operation to that scene: timing is scene-relative, targets must belong to it, and its boundary cannot be removed. Persists changes in the connected account. Retrying a successful mutation can duplicate or repeat the change.

jsoncut_delete_clip

Delete an owned upload that is no longer referenced.

jsoncut_delete_media

Move an owned project to the recoverable Studio trash.

jsoncut_delete_project

Open the existing JsonCut Studio editor beside the chat. Pass an owned project_id to edit the original layered project. With no ID, show a project picker. Does not render, share or change a project. The editor uses the connected OAuth account; no second login is needed when the host supports embedded cookies.

jsoncut_open_studio

Read concise project-structure rules before authoring or restructuring.

jsoncut_get_authoring_guide

Read batch checklist, ordered projects, latest reviews, asset provenance and uniqueness conflicts.

jsoncut_get_batch

Read batch progress and per-row outcomes.

jsoncut_get_bulk_render

Read one reusable component and its typed slots.

jsoncut_get_component

Create a temporary download/playback link for an owned completed export when the user requests delivery or sharing. Anyone with the link can access only this export without Studio login. Defaults to 1 hour, never beyond artifact expiry. This creates a revocable share, not a local file; do not create links during status polling or private review. Return the URL and expiry to the user; host download tools may still have network restrictions. Creates a bearer-access share outside the private account boundary. Do this only for requested delivery; never for polling. Retrying creates another link.

jsoncut_get_download_link

Read one exact editable V2 layer. Request markup only when a source-level replacement is necessary.

jsoncut_get_layer

Read one native Library item including typed inputs and its declarative HTML example.

jsoncut_get_library_item

Get one upload including its stable jsoncut-media reference.

jsoncut_get_media

Discover exact Studio primitives. Controls are editable grouped-layer recipes, not hidden presets. Search icons by at least two characters; returned SVG comes from the Studio Lucide library and must not be redrawn.

jsoncut_get_primitive_catalog

Read a project including its current source and optimistic version.

jsoncut_get_project

Read one compact project payload with active cut.md guidance and available media, components, templates, brand kits and fonts. Prefer this over several catalogue calls before authoring.

jsoncut_get_project_context

Read the latest immutable cut.md version and resolved-reference state.

jsoncut_get_project_cut

Read a compact paged root timeline and canonical scene ids without returning the large HTML source. Use these ids for later scene calls; optional for long projects.

jsoncut_get_project_outline

Read a bounded layer window from a long V2 project. Filters are server-side and full HTML/CSS is not returned.

jsoncut_get_project_scope

Read status; optionally wait and return the actual PNG/JPEG/WebP review image. For final file delivery use get_download_link; artifactUrl requires authentication outside MCP.

jsoncut_get_render

Get persisted findings, evidence, staleness and approval state for one review or the latest review.

jsoncut_get_review

Read one scene and a compact paged list of descendants. relativeStart matches author_scene; canonical start remains visible for orientation.

jsoncut_get_scene

Read a published template's metadata and source.

jsoncut_get_template

Get required typed inputs and examples before filling a template.

jsoncut_get_template_inputs

Get the authenticated Studio project for a human-assisted upload when the client cannot transfer bytes. A link is not upload completion: list project media afterwards.

jsoncut_get_upload_handoff