Every Blings tool, in one place.

blings_add_experiment_variants Write Write gateway

Adds typed alternatives to an existing content experiment.

Use it to: Introduce additional copy, media, theme, or supported interaction options.

Toolset and constraints

• Toolset: Optimization and experiments (optimization).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Variant values must match the target type and configured goal.

blings_add_layer Write Write gateway

Adds a supported static text, shape, media, button, or MP5 layer.

Use it to: Place a new authored element into a selected draft scene composition.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Media and imported MP5 sources must already be authorized.

blings_add_library_scenes Write Direct tool + write gateway

Imports selected scenes from an assigned library into a project draft.

Use it to: Reuse approved scenes while preserving assets, fonts, and bindings.

Toolset and constraints

• Toolset: Scene libraries (scene-libraries).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Does not alter the source library or its account assignment.

blings_analyze_media_budget Read Read gateway

Estimate media bytes for a scene path; this does not measure browser preloading.

Use it to: Use the advertised input schema for this read operation.

Toolset and constraints

• Toolset: Asset delivery and playback preparation (delivery).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Requires read permission plus authorization for the selected Blings resources.

blings_apply_connector_batch Write Write gateway

Stages up to 100 connector upserts, removals, or retargets across scenes and saves the draft once.

Use it to: Apply a reviewed connector plan in one draft save.

Toolset and constraints

• Toolset: Connectors (connectors).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Supply inline edits or an uploaded connector-plan JSON file. Duplicate IDs need explicit occurrences; only schema-field retain resolutions are supported.

blings_apply_motion_batch Write Direct tool + write gateway

Stages, validates, and saves a batch of direct and managed native edits with an optional structural summary.

Use it to: Animate several targets while preserving click actions and other bindings.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Requires the current draft revision; changes to connector targets or controlled properties conflict.

blings_attach_asset_to_scene Write Write gateway

Attaches a verified delivered asset as an editable native draft layer.

Use it to: Place an image, video, or audio result into a scene.

Toolset and constraints

• Toolset: Asset delivery and playback preparation (delivery).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Requires the delivery ID, exact placement, and expected scene hash.

blings_audio_analyze Write Write gateway

Submits an asynchronous audio analysis job.

Use it to: Inspect measured properties or content of an audio asset.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Analysis does not count as a listening acceptance review.

blings_audio_assets Read Read gateway

Lists reusable audio assets in an authorized account.

Use it to: Find a voice, music, effect, mix, or imported recording.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Results are paginated and can be filtered by kind.

blings_audio_cancel Write Write gateway

Requests cancellation of an audio job.

Use it to: Stop queued audio work that is no longer needed.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Running provider work may still incur charges.

blings_audio_capabilities Read Read gateway

Lists available audio operations, voices, tiers, and remaining allocation.

Use it to: Choose a configured voice or music path before submitting work.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Provider availability depends on the account and runtime configuration.

blings_audio_download Read Read gateway

Returns a short-lived download reference for an audio asset.

Use it to: Listen to an authorized audio result.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• The remote tool does not read or write local files.

blings_audio_estimate Read Read gateway

Estimates audio allocation units before a request spends them.

Use it to: Check the cost of a proposed generation, mix, import, or analysis.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Allocation units are separate from provider credits and money.

blings_audio_extract Write Write gateway

Submits an asynchronous audio extraction job.

Use it to: Extract audio from a supported source asset.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Use the returned job and inspect its result asset before reuse.

blings_audio_generate Write Direct tool + write gateway

Submits an asynchronous voice, music, or sound effect generation job.

Use it to: Create a new audio asset from an explicit prompt or script.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Reuse requestId to prevent duplicate spend; inspect the job and listen before accepting the result.

blings_audio_import Write Write gateway

Imports a completed staged audio upload as an account asset.

Use it to: Bring a licensed recording into the audio catalog.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Declare provenance and usage rights; complete the upload before import.

blings_audio_inspect Read Read gateway

Inspects an audio asset and its measured properties and provenance.

Use it to: Check duration, content hash, and origin before placement.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Inspection alone does not mark the audio accepted.

blings_audio_job Read Read gateway

Reads an audio job by job ID or its original request ID.

Use it to: Check completion without resubmitting a generation or mix.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• An unknown upstream outcome should be reconciled with the original request ID.

blings_audio_mix Write Direct tool + write gateway

Submits an asynchronous mix of existing audio assets.

Use it to: Combine voice, music, and effects into a reviewed mix.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Reuse requestId and inspect the completed job before using its asset.

blings_audio_process Write Write gateway

Submits an asynchronous audio processing job.

Use it to: Apply a supported processing operation to an existing asset.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• The operation returns a job; poll with the original request ID.

blings_audio_review Write Write gateway

Records a content-hash-bound listening review for an audio asset.

Use it to: Accept or reject the exact version that was heard.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Machine analysis alone cannot mark audio accepted.

blings_audio_transcribe Write Write gateway

Submits an asynchronous transcription job for audio.

Use it to: Get timed speech text from a supported recording.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Availability depends on configured transcription providers and account allocation.

blings_audio_upload Write Write gateway

Registers an audio upload and returns a short-lived signed transfer URL.

Use it to: Stage a WAV or MP3 file for audio import.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Send the exact bytes and headers, complete the transfer, then submit the import job.

blings_audio_upload_complete Write Write gateway

Verifies a registered audio upload against its size and checksum.

Use it to: Finish staging an audio file before import.

Toolset and constraints

• Toolset: Audio (audio).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Requires the upload ID from a successful transfer.

blings_begin_artifact_upload Write Write gateway

Begins a verified upload into the runtime account catalog.

Use it to: Stage a source file for audio, media, or composition work.

Toolset and constraints

• Toolset: Runtime assets and jobs (runtime-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Transfer the exact bytes to the returned upload capability before completing the upload.

blings_begin_asset_upload Write Write gateway

Prepares a direct upload for an image, audio, or video file up to 512 MiB.

Use it to: Upload a large project media file using a short-lived signed PUT URL.

Toolset and constraints

• Toolset: Project assets and fonts (project-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Supply exact byte size and SHA-256, send the raw file using the returned headers, then call blings_complete_asset_upload. JSON and fonts use blings_prepare_file_upload or blings_upload_asset instead. This does not change a scene.

blings_cancel_job Write Write gateway

Requests best-effort cancellation of an authorized runtime job.

Use it to: Stop queued work when the result is no longer needed.

Toolset and constraints

• Toolset: Runtime assets and jobs (runtime-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Work already accepted by a provider may still incur usage.

blings_compare_health Read Read gateway

Compare health reports from matching scenarios and environments.

Use it to: Use the advertised input schema for this read operation.

Toolset and constraints

• Toolset: Health and diagnostics (health).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Requires read permission plus authorization for the selected Blings resources.

blings_compile_composition Write Direct tool + write gateway

Compiles a prepared source bundle into editable MP5 in an isolated runtime job.

Use it to: Turn editable composition source into a validated MP5 result.

Toolset and constraints

• Toolset: Composition source, compilation and import (compositions).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Discover the qualified compiler profile through blings_runtime_capabilities; submit the sourceBundleId with a stable requestId.
• Poll the existing job. A succeeded job alone does not establish importability; check compileResult.importable and its source, comparison and native-render evidence.

blings_complete_artifact_upload Write Write gateway

Verifies a staged artifact and returns its stable runtime asset reference.

Use it to: Finish an upload before submitting an import or compile request.

Toolset and constraints

• Toolset: Runtime assets and jobs (runtime-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• A prepared upload alone does not create an asset.

blings_complete_asset_delivery Write Write gateway

Verifies the uploaded project resource under current authorization.

Use it to: Finish delivery and obtain the resource URL for placement.

Toolset and constraints

• Toolset: Asset delivery and playback preparation (delivery).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Wait for the transfer job before completing the delivery.

blings_complete_asset_upload Write Write gateway

Verifies a completed direct media upload and returns its project resource ID and URL.

Use it to: Finish a transfer started by blings_begin_asset_upload before using the media in a project.

Toolset and constraints

• Toolset: Project assets and fonts (project-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Requires the direct uploadId after the PUT succeeds. Returns optimization status; completing the upload does not change a scene.

blings_complete_composition_import Write Direct tool + write gateway

Completes a prepared composition import into the authorized draft scene.

Use it to: Commit a compiled scene after its transfers finish.

Toolset and constraints

• Toolset: Composition source, compilation and import (compositions).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Reuses the import identity and checks the target revision and hash before saving.
• For pending playback preparation or transfers, wait retryAfterMs and retry the same input and idempotencyKey. Reconcile IMPORT_OUTCOME_UNKNOWN using the original receipt and draft scene pointer.

blings_copy_layers Write Write gateway

Copies selected layers and supported dependencies between draft scenes.

Use it to: Duplicate a composed element while preserving its existing animation.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Cross-project media relocation requires supported backend preparation.

blings_copy_scene Write Write gateway

Copies an authorized scene within or between accessible projects.

Use it to: Duplicate a scene or bring it into another project draft.

Toolset and constraints

• Toolset: Project scenes (scenes).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Cross-project copies require independent source and destination access.

blings_create_experiment Write Write gateway

Creates a content experiment with a baseline and supported alternate values.

Use it to: Test copy, media, theme, or interaction variations against a configured goal.

Toolset and constraints

• Toolset: Optimization and experiments (optimization).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Requires a valid target, goal, and any required success action.

blings_create_project Write Direct tool + write gateway

Creates a new blank project in an authorized account.

Use it to: Start a clean project before adding scenes and content.

Toolset and constraints

• Toolset: Projects (projects).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Creates structure only; it does not generate a video.

blings_create_scene Write Direct tool + write gateway

Creates a blank draft scene with explicit size, frame rate, and duration.

Use it to: Add a clean scene before building its layers.

Toolset and constraints

• Toolset: Project scenes (scenes).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Creates no generated animation and requires draft write access.

blings_download_asset Read Read gateway

Creates an expiring download reference for an authorized runtime asset.

Use it to: Retrieve a verified result for review or local use.

Toolset and constraints

• Toolset: Runtime assets and jobs (runtime-assets).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• The returned capability expires and remains scoped to the account.

blings_duplicate_project Write Write gateway

Duplicates an accessible project with its supported content state.

Use it to: Create an editable copy of an existing project.

Toolset and constraints

• Toolset: Projects (projects).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• The copy follows existing Platform behavior and is not draft-only.

blings_get_asset_delivery Read Read gateway

Reads delivery state and its transfer job.

Use it to: Check whether a project resource is ready to use.

Toolset and constraints

• Toolset: Asset delivery and playback preparation (delivery).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• The status omits signed upload capabilities.

blings_get_data_schema Read Direct tool + read gateway

Reads recursive Dynamic Data and Live Control fields and references.

Use it to: Inspect paths, types, defaults, descriptions, and connector usage.

Toolset and constraints

• Toolset: Data and live controls (data).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Use full validation before removing referenced schema fields.

blings_get_delivery_config Read Read gateway

Reads verified delivery aliases, landing scenes, thumbnails, and required data fields.

Use it to: Find the correct live delivery URL and integration requirements.

Toolset and constraints

• Toolset: Review and publishing (review).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Link construction does not prove that playback was rendered.

blings_get_demo_url Read Read gateway

Builds a verified Blings demo link with supported playback options.

Use it to: Open a selected scene or lineup with sample data for manual review.

Toolset and constraints

• Toolset: Review and publishing (review).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• A generated URL does not prove rendering or immutable content.

blings_get_editing_context Read Direct tool + read gateway

Combines draft revision, selected layers, ownership, capabilities, and optional operation examples.

Use it to: Start a scene edit with one compact context call.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Paginated and hash-bound; large property values are omitted explicitly.

blings_get_flow Read Direct tool + read gateway

Reads the flow graph, conditions, branches, reachability, and optional layout.

Use it to: Understand how scenes and conditional routes form the viewer journey.

Toolset and constraints

• Toolset: Flow (flow).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Stored expressions are inspected as data and never evaluated.

blings_get_frame_screenshot Read Direct tool + read gateway

Renders one authorized native scene frame as a PNG image.

Use it to: Visually review an exact draft or published frame with optional sample data.

Toolset and constraints

• Toolset: Review and publishing (review).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Returns bounded image evidence tied to the current scene hash.

blings_get_health_report Read Read gateway

Read scan findings and coverage; continue incomplete scans with inspect_health.

Use it to: Use the advertised input schema for this read operation.

Toolset and constraints

• Toolset: Health and diagnostics (health).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Requires read permission plus authorization for the selected Blings resources.

blings_get_hooks_guide Read Read gateway

Provides reviewed Player and Platform custom-hook guidance, lifecycle details, writable contexts, save and publish behavior, pitfalls, and 26 templates.

Use it to: Read section guidance and template summaries, or request full JavaScript for an exact template ID.

Toolset and constraints

• Toolset: Context and guidance (context).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• This source snapshot does not establish which version is deployed to a project.
• Full template code requires both templateId and includeCode:true; unknown template IDs are rejected.
• Returns reference material only. It does not inspect, execute, save, or publish hooks.

blings_get_job Read Direct tool + read gateway

Reads an authorized runtime job by job ID or its original operation and request IDs.

Use it to: Follow a compile, media, audio, or delivery job to its verified result.

Toolset and constraints

• Toolset: Runtime assets and jobs (runtime-assets).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Reuse the original request ID to reconcile an uncertain submission.

blings_get_keyframes Read Read gateway

Reads an existing keyframe track in native frame units.

Use it to: Inspect times, values, interpolation, and holds before editing motion.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Requires an exact hash-bound layer and property reference.

blings_get_layer Read Read gateway

Inspects one layer, its editable fields, animation, and content ownership.

Use it to: Learn which properties can be changed without breaking bindings.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Stored expressions are reported but never executed.

blings_get_live_control Read Direct tool + read gateway

Reads the campaign-wide Live Control tree and its current values.

Use it to: Inspect control values and their connector references before an update.

Toolset and constraints

• Toolset: Data and live controls (data).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Invalid stored values remain visible with findings.

blings_get_optimization Read Read gateway

Reads the optimization goal, experiments, variants, CTAs, and publish state.

Use it to: Review the complete optimization setup before changing an experiment.

Toolset and constraints

• Toolset: Optimization and experiments (optimization).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• This is content optimization, not AI video generation.

blings_get_project Read Direct tool + read gateway

Reads project identity plus published or draft scene summaries.

Use it to: Open a known project directly by ID or search for it by name.

Toolset and constraints

• Toolset: Projects (projects).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Published is the default view; request draft explicitly when needed.

blings_get_project_diff Read Read gateway

Compares published and draft project content by domain.

Use it to: Review scene, connector, settings, flow, and experiment changes before publishing.

Toolset and constraints

• Toolset: Projects (projects).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Inspect every returned page for a complete scene comparison.

blings_get_project_settings Read Read gateway

Reads Player settings, overlays, font mappings, and presentation configuration.

Use it to: Inspect how a project is configured before proposing a settings change.

Toolset and constraints

• Toolset: Projects (projects).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Live Control values are exposed through a separate tool.

blings_get_scene Read Direct tool + read gateway

Reads a scene record and its decoded MP5 document details.

Use it to: Inspect dimensions, frame timing, compositions, media, fonts, and content hash.

Toolset and constraints

• Toolset: Project scenes (scenes).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Large document sections are paginated and bound to the inspected hash.

blings_get_scene_library Read Direct tool + read gateway

Reads metadata and a paginated scene inventory from an assigned library.

Use it to: Preview reusable scenes before selecting exact imports.

Toolset and constraints

• Toolset: Scene libraries (scene-libraries).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Library assignment is checked on every request.

blings_get_wireframe_workflow Read Read gateway

Explains how to create a plain, testable wireframe project or extend an existing one.

Use it to: Plan scenes, conditional flows, connectors, and A/B routing before visual design.

Toolset and constraints

• Toolset: Context and guidance (context).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Returns workflow guidance only; creating or editing a project requires separate write tools.

blings_group_layers Write Write gateway

Groups selected layers into a supported precomposition.

Use it to: Turn several related elements into one manageable composition.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Grouping proceeds only when appearance, timing, and references can be preserved.

blings_inspect_health Read Read gateway

Start a bounded, cancellable health scan; follow continuation to cover all selected content.

Use it to: Use the advertised input schema for this read operation.

Toolset and constraints

• Toolset: Health and diagnostics (health).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Requires read permission plus authorization for the selected Blings resources.

blings_inspect_motion Read Read gateway

Inspects native Player motion targets, geometry, paths, and supported operations.

Use it to: Resolve animation targets or request getOperationSchema for inputs and examples.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Detailed operation schemas are fetched on demand; preset and runtime-linked APIs are unavailable.

blings_intake_read_email Read Direct tool + read gateway

Renders a marketing email with its original pictures and returns what a film needs from it.

Use it to: Start email-to-video: the email's words, pictures, main button, painted colours, fonts, claims and offers.

Toolset and constraints

• Toolset: Intake (intake).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Takes exactly one source: a public HTTPS page or reallygoodemails.com link, a completed .eml or .html upload, or pasted HTML.
• The render, tiles, pictures, photo cuts, corpus and full record are stored as runtime assets; the answer carries their IDs and a preview image.
• Colours are painted pixel shares of the render; colours the CSS declares but never paints are listed to be ignored.
• Words painted into pictures are typed from the preview and sent back as imageText in a second call.
• Public HTTPS and public addresses only; open pixels and click trackers are never fetched; no cookies, scripts or clicks.

blings_intake_read_site Read Direct tool + read gateway

Reads a brand's website for logos, fonts, painted colours and real product photos.

Use it to: Get the brand's logo files, heading and body font candidates with unverified licensing, and its own product photos.

Toolset and constraints

• Toolset: Intake (intake).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Read the main button's domain for brand context; preserve the campaign's actual destination rather than substituting its homepage.
• Pages are read as the server sends them; for a walled site (bot wall, error page, challenge) Brandfetch, when configured, adds logos, colours and fonts.
• No product photo is informational; source one when the brief needs it.
• Public HTTPS and public addresses only; the site's own scripts never run; no cookies, clicks, forms or posts.

blings_list_accounts Read Direct tool + read gateway

Lists the Blings accounts available to the connected user.

Use it to: Find the account that owns the project you want to work on.

Toolset and constraints

• Toolset: Context and guidance (context).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Results are paginated; continue while a cursor is returned.

blings_list_assets Read Read gateway

Lists authorized media and referenced scene assets with usage details.

Use it to: Find the exact image, video, audio, or composition used by a project.

Toolset and constraints

• Toolset: Project assets and fonts (project-assets).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Availability and ownership are reported without changing content.

blings_list_catalogs Read Read gateway

Lists catalog collections, schemas, required fields, and supported operations.

Use it to: Discover reusable product, offer, or plan data configured for a project.

Toolset and constraints

• Toolset: Data and live controls (data).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Counts are exact only when the backend proves the inventory is complete.

blings_list_connectors Read Direct tool + read gateway

Lists typed bindings, targets, fallbacks, controls, interactions, and experiment links.

Use it to: Understand how project data controls scenes and viewer actions.

Toolset and constraints

• Toolset: Connectors (connectors).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Stored code is never executed or returned.

blings_list_fonts Read Read gateway

Lists available fonts, scene dependencies, faces, overrides, and mappings.

Use it to: Check whether the required family and weight are ready for a scene.

Toolset and constraints

• Toolset: Project assets and fonts (project-assets).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Reports font availability without changing text layout.

blings_list_layers Read Read gateway

Lists a scene hierarchy with layer kinds, timing, parents, and references.

Use it to: Map a scene before selecting exact layers to inspect or edit.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Layer references are bound to the inspected scene hash.

blings_list_projects Read Direct tool + read gateway

Lists active projects inside an accessible Blings account.

Use it to: Browse project IDs and names before choosing one to inspect.

Toolset and constraints

• Toolset: Projects (projects).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Requires an authorized account and returns paginated results.

blings_list_runtime_assets Read Read gateway

Lists verified assets stored in the runtime account catalog.

Use it to: Find an audio, image, video, or evidence asset for a later operation.

Toolset and constraints

• Toolset: Runtime assets and jobs (runtime-assets).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Results are account-authorized and paginated.

blings_list_scene_libraries Read Direct tool + read gateway

Lists scene libraries assigned to an account and available to a project.

Use it to: Discover approved source content for the selected account.

Toolset and constraints

• Toolset: Scene libraries (scene-libraries).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Library assignments are read-only and cannot be changed here.

blings_media_acquire Write Write gateway

Acquires a selected catalog item through a durable job.

Use it to: Bring a chosen image or video into the account catalog.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Use an exact signed selection and review its rights metadata.

blings_media_assets Read Read gateway

Lists image and video assets in an account.

Use it to: Find generated, edited, acquired, or imported media.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Results are account-scoped.

blings_media_avatar_generate Write Write gateway

Animates a portrait with measured narration through a durable video job.

Use it to: Create a talking avatar from a reviewed portrait and an audio asset.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Available only when the avatar generation driver and provider are configured.
• Use runtime imageAssetId and audioAssetId values; the portrait needs cleared rights and approved review, and narration needs the required listening review and commercial usage rights.
• Generate text narration through the audio tools first; this tool does not accept text narration directly.
• Generation does not attach the result to a scene; inspect the job and review the output before delivery.

blings_media_cancel Write Write gateway

Requests cancellation of a media job.

Use it to: Stop queued visual work.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Cancellation is best effort once provider work has started.

blings_media_capabilities Read Read gateway

Lists configured image and video provider capabilities.

Use it to: Find a supported generation or editing path.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Availability varies by connection and account.

blings_media_download Read Read gateway

Returns an expiring account-scoped media download URL.

Use it to: Review a generated or acquired image or video.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• The URL is short-lived and depends on transfer configuration.

blings_media_edit Write Write gateway

Edits an image using approved source references.

Use it to: Create a revised asset from an existing image.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• The result is a job and requires review before placement.

blings_media_estimate Read Read gateway

Estimates an explicit media provider request without spending.

Use it to: Check a proposed image or video request before submission.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• An estimate is not a generated asset.

blings_media_generate Write Direct tool + write gateway

Generates an image or video through a durable job.

Use it to: Create a new visual asset from a specific brief.

Toolset and constraints

• Toolset: Media (media).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Provide a stable request ID; generation does not attach the asset to a scene.

blings_media_import Write Write gateway

Imports a completed staged image or video with rights and provenance.

Use it to: Bring an existing visual file into the runtime catalog.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Complete the staged upload first and declare usage rights.

blings_media_inspect Read Read gateway

Inspects a media asset and its review metadata.

Use it to: Check asset identity, provenance, and status before delivery.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Account authorization is checked on each read.

blings_media_job Read Read gateway

Reads a durable media job without resubmitting it.

Use it to: Follow generation, editing, or acquisition to completion.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Poll the existing job instead of creating another request.

blings_media_mute_video Write Write gateway

Creates a silent MP4 derivative while preserving video frames and aligning the timeline to zero.

Use it to: Remove embedded audio before pairing a video with a separate narration track.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Available only when the video audio-processing driver is configured.
• Provide a runtime videoAssetId and a stable requestId; the source asset is preserved.
• The result contains no audio streams and is a new, unreviewed asset; inspect the job and review it before delivery.

blings_media_process_video Write Write gateway

Converts, trims, downsizes, pads, joins, or splits SDR MP4 and WebM video through a durable job.

Use it to: Prepare existing footage or join clips in sequence for use in a scene.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Available only when the video-processing driver is configured.
• Use runtime video asset IDs and the supported operation schema; upscaling is not supported.
• Joining is sequential rather than layered compositing; splitting returns ordered output assets.
• Creates new, unreviewed derivatives; inspect the job and review the output before delivery.

blings_media_review Write Write gateway

Records an explicit review of an exact media asset.

Use it to: Accept or reject the image or video version you inspected.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Review is bound to the asset hash and current revision.

blings_media_search Read Direct tool + read gateway

Searches catalog previews without acquiring an asset.

Use it to: Find suitable stock imagery or footage.

Toolset and constraints

• Toolset: Media (media).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Preview results are not yet licensed account assets.

blings_media_transform_image Write Write gateway

Crops, downsizes, rotates, flips, pads, or converts a static image through a durable job.

Use it to: Prepare an existing image for the size and format needed by a scene.

Toolset and constraints

• Toolset: Media (media).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Available only when the image-transform driver is configured.
• Provide a runtime imageAssetId and a supported transform request; upscaling is not supported.
• Creates a new, unreviewed derivative without replacing the source; review the output before delivery.

blings_move_layers Write Write gateway

Reorders layers or moves them into a selected composition.

Use it to: Change stacking or composition ownership while preserving coordinates.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Moves that require prohibited animation reconstruction are rejected.

blings_optimize_project_media Write Write gateway

Inspect used draft media or prepare compact replacements on the backend. Returns measured savings, exact usage paths and retained originals. Apply is unavailable until a verified atomic draft commit adapter is enabled; preparation never changes scenes or published content.

Use it to: Use the advertised input schema for this write operation.

Toolset and constraints

• Toolset: Asset delivery and playback preparation (delivery).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Requires read and write permission plus authorization for the selected Blings resources.

blings_prepare_asset_delivery Write Write gateway

Authorizes and queues delivery of a runtime asset to a project.

Use it to: Move a reviewed image, video, or audio asset toward a project.

Toolset and constraints

• Toolset: Asset delivery and playback preparation (delivery).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Use the original request ID to reconcile an uncertain transfer.

blings_prepare_composition_import Write Direct tool + write gateway

Prepares a verified composition import and its durable transfer jobs.

Use it to: Stage a compiled scene for a specific draft target.

Toolset and constraints

• Toolset: Composition source, compilation and import (compositions).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Available on qualified hosted and local connections; requires the current target revision and scene hash.
• Keep the returned import identity and wait for its existing transfer jobs before completing the import.

blings_prepare_file_upload Write Write gateway

Prepares a raw file transfer for scene JSON, images, audio, video, or fonts.

Use it to: Send local file bytes to the returned endpoint, then use the uploadId in an upload tool.

Toolset and constraints

• Toolset: Project assets and fonts (project-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Requires account and project access, file size, and SHA-256. Files are limited to 3 MiB; tickets and references expire within 10 minutes. A file-capable client with network access to the returned upload URL is required. Preparing a ticket alone does not upload the file.

blings_prepare_playback_asset Write Write gateway

Prepare a browser-ready playback asset; repeat the same call while pending.

Use it to: Use the advertised input schema for this write operation.

Toolset and constraints

• Toolset: Asset delivery and playback preparation (delivery).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Requires read and write permission plus authorization for the selected Blings resources.

blings_prepare_source_bundle Write Direct tool + write gateway

Stores authored HTML, CSS, JavaScript and asset references as a compiler source bundle.

Use it to: Prepare editable animation source and obtain its sourceBundleId before compiling.

Toolset and constraints

• Toolset: Composition source, compilation and import (compositions).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Prepares source without executing it; use staged artifact uploads for larger files.
• Read the composition guide and discover the compiler profile through blings_runtime_capabilities.

blings_preview_asset Read Read gateway

Preview verified image pixels or representative video frames inline.

Use it to: Use the advertised input schema for this read operation.

Toolset and constraints

• Toolset: Runtime assets and jobs (runtime-assets).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Requires read permission plus authorization for the selected Blings resources.

blings_profile_runtime Read Read gateway

Start a Player debug capture, or stop and finalize a capture session.

Use it to: start: accountId, projectId, mode and mode-specific fields. stop: accountId + sessionId. See full definition.

Toolset and constraints

• Toolset: Health and diagnostics (health).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Requires read permission plus authorization for the selected Blings resources.

blings_publish_project Write Direct tool + write gateway

Publishes selected validated draft domains to the live project.

Use it to: Make reviewed scene, data-field, or Live Control changes available to viewers.

Toolset and constraints

• Toolset: Review and publishing (review).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Publishing is explicit and can select dataSchema or liveControl without publishing other draft domains.

blings_read_composition_source_history Read Read gateway

Reads source provenance for an imported composition scene.

Use it to: Find the source bundle and compile evidence behind a scene.

Toolset and constraints

• Toolset: Composition source, compilation and import (compositions).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Available only while the authorized scene still carries a verified import pointer.

blings_read_evidence Read Direct tool + read gateway

Read a page of job evidence without downloading the asset.

Use it to: Use the advertised input schema for this read operation.

Toolset and constraints

• Toolset: Runtime assets and jobs (runtime-assets).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Requires read permission plus authorization for the selected Blings resources.

blings_recover_job Write Write gateway

Recover existing provider output without another generation; original unknown billing is settled only with provider evidence.

Use it to: Use the advertised input schema for this write operation.

Toolset and constraints

• Toolset: Runtime assets and jobs (runtime-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Requires read and write permission plus authorization for the selected Blings resources.

blings_register_font Write Write gateway

Uploads and registers an account font through the Platform conversion path.

Use it to: Add a new font face before assigning it to scene text.

Toolset and constraints

• Toolset: Project assets and fonts (project-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Supply uploadId or dataBase64. The decoded font is limited to 3 MiB and existing text is unchanged.

blings_remove_connector Write Write gateway

Removes a selected connector after resolving dependent content references.

Use it to: Detach an obsolete binding and reveal the underlying ordinary content.

Toolset and constraints

• Toolset: Connectors (connectors).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Experiment, schema, form, and CTA dependencies must be resolved.

blings_remove_experiment Write Write gateway

Removes an experiment and chooses the surviving ordinary content value.

Use it to: End a test while keeping the intended winning or baseline content.

Toolset and constraints

• Toolset: Optimization and experiments (optimization).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Unrelated experiments and content remain untouched.

blings_remove_experiment_variant Write Write gateway

Removes one variant and reconciles the remaining experiment.

Use it to: Retire a variation that should no longer receive traffic.

Toolset and constraints

• Toolset: Optimization and experiments (optimization).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Baseline behavior must be explicit if too few variants remain.

blings_remove_layers Write Write gateway

Deletes selected layers after checking structural and content dependencies.

Use it to: Remove obsolete visual elements from a draft scene safely.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Shared assets are never deleted as a hidden side effect.

blings_remove_scene Write Write gateway

Removes a draft scene after resolving supported dependencies.

Use it to: Delete an obsolete scene once affected flow and bindings are understood.

Toolset and constraints

• Toolset: Project scenes (scenes).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Shared source assets are retained and ambiguous dependencies are rejected.

blings_reorder_scenes Write Write gateway

Reorders the draft scene inventory while preserving the stored flow graph.

Use it to: Match the project scene list to the intended editorial order.

Toolset and constraints

• Toolset: Project scenes (scenes).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Inventory order is not a replacement for the playback flow map.

blings_replace_colors Write Write gateway

Replaces selected static color occurrences in a draft scene.

Use it to: Update approved fills, strokes, text, or gradient colors together.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Animated and connector-controlled colors remain protected.

blings_replace_font Write Write gateway

Replaces a selected layer, scene, or project font mapping.

Use it to: Move text to an approved font while preserving its content and styling.

Toolset and constraints

• Toolset: Project assets and fonts (project-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• May change layout and requires a valid registered face.

blings_replace_media Write Write gateway

Replaces media for one layer or explicitly selected shared usages.

Use it to: Swap an image, audio, or video source while preserving layer motion.

Toolset and constraints

• Toolset: Project assets and fonts (project-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• The default scope is the selected usage, not every shared reference.

blings_report_feedback Write Write gateway

Submits user feedback about Blings results with the authenticated connection identity.

Use it to: Report a result, failure, or revision request with the exact user comment and a separate optional interpretation.

Toolset and constraints

• Toolset: Context and guidance (context).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Sends user content to Blings. Requires write permission; submission uses a best-effort log sink and is not a durable delivery receipt. Assistant and model names are optional and must not be guessed.

blings_runtime_capabilities Read Direct tool + read gateway

Reports the connected runtime identity, versions, operations, providers, and account allocation mode.

Use it to: Check which optional tools and providers are available on this connection.

Toolset and constraints

• Toolset: Context and guidance (context).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Availability and authorization are evaluated for the selected account; a listed operation may still need configuration.

blings_set_main_ctas Write Write gateway

Selects exact eligible interactions as Main CTA success actions.

Use it to: Define which viewer actions count toward conversion scoring.

Toolset and constraints

• Toolset: Optimization and experiments (optimization).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Uses scene and connector identity and preserves other interactions.

blings_set_optimization_goal Write Write gateway

Chooses the project optimization goal explicitly.

Use it to: Set Conversion, Engagement, Watch Time, or Blings Factor before testing.

Toolset and constraints

• Toolset: Optimization and experiments (optimization).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• A goal is never inferred silently from project content.

blings_update_data_schema Write Direct tool + write gateway

Edits recursive Dynamic Data or Live Control fields and groups.

Use it to: Stage schema paths in the draft, or explicitly apply them to published configuration.

Toolset and constraints

• Toolset: Data and live controls (data).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Referenced changes require an explicit connector-handling decision.

blings_update_experiment_variant Write Write gateway

Changes one experiment variant while preserving its stable identity.

Use it to: Refine a variation without discarding its stored identity.

Toolset and constraints

• Toolset: Optimization and experiments (optimization).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Material edits can change the meaning of accumulated comparisons.

blings_update_flow Write Direct tool + write gateway

Applies validated graph operations to the inspected draft flow.

Use it to: Add, remove, or reconnect nodes and typed branch routes.

Toolset and constraints

• Toolset: Flow (flow).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Requires exact references and does not publish the project.

blings_update_keyframes Write Write gateway

Updates explicitly selected existing keyframes and supported easing values.

Use it to: Refine the timing or value of an existing animation track.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Does not create new tracks or automatically retime unrelated animation.

blings_update_layer_properties Write Write gateway

Changes supported static properties on selected draft-scene layers.

Use it to: Edit text, transforms, shapes, colors, or media presentation values.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Existing keyframes and data bindings are preserved.

blings_update_layer_timing Write Write gateway

Changes selected layer in and out points in native frame units.

Use it to: Shorten or extend when a layer is visible within its composition.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Preserves keyframes, layer start offset, and scene frame rate.

blings_update_live_control Write Direct tool + write gateway

Changes selected Live Control scalar values by recursive path.

Use it to: Stage campaign-wide controls in the draft or apply them immediately.

Toolset and constraints

• Toolset: Data and live controls (data).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Draft values become live only when published with the liveControl scope.

blings_update_project_metadata Write Write gateway

Changes a project title or description through existing Platform APIs.

Use it to: Rename a project after confirming the selected project ID.

Toolset and constraints

• Toolset: Projects (projects).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Requires write permission and can affect visible project metadata.

blings_update_project_settings Write Write gateway

Applies one supported Player, overlay, or font-override settings change.

Use it to: Adjust a specific presentation setting without combining unrelated saves.

Toolset and constraints

• Toolset: Projects (projects).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Each action follows its real published or draft persistence domain.

blings_update_scene_canvas Write Write gateway

Changes only the root width and height of a draft MP5 scene.

Use it to: Resize the scene canvas while preserving layers and animation data.

Toolset and constraints

• Toolset: Project scenes (scenes).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Does not scale layers or change frame rate and timing.

blings_update_scene_metadata Write Write gateway

Renames a draft scene or changes its description while reconciling references.

Use it to: Give a scene a clearer name without breaking supported flow links.

Toolset and constraints

• Toolset: Project scenes (scenes).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Opaque dependencies are rejected instead of being guessed.

blings_upload_asset Write Write gateway

Uploads images, audio, MP4, JSON, and TTF/OTF/WOFF/WOFF2 fonts into project storage.

Use it to: Host a JSON document, compressed MP5, font file, or media asset and receive its URL and resourceId.

Toolset and constraints

• Toolset: Project assets and fonts (project-assets).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Supply uploadId or dataBase64. The decoded file is limited to 3 MiB. Original bytes are stored and upload alone changes no scene; use blings_register_font for account-wide font registration and conversion.

blings_upload_scene_animation Write Write gateway

Creates or replaces a draft scene from Lottie or MP5 JSON, including compressed MP5, with optional media and font files.

Use it to: Import an authored animation and project-scoped media or font attachments into a draft scene.

Toolset and constraints

• Toolset: Project scenes (scenes).
• This operation is available through its read/write gateway. The gateway is blings_write_operation.
• Supply exactly one top-level field: animation, animationUploadId, or animationUrl (a public HTTPS scene document fetched by the server; 2 MiB download limit, no redirects). Omit animation when using either reference; never nest an upload ID or URL inside animation. animationUploadId must come from a successful raw file transfer, not just a prepared ticket. Map image, video, or audio files by assetId with uploadId or dataBase64; fonts need family, name, weight, and style. Supported embedded data URIs are hosted.
• Expanded animation is limited to 2 MiB; at most 20 hosted files and 3 MiB decoded are allowed. Inline bytes and the JSON-RPC envelope must fit the 4 MiB request cap; referenced bytes transfer separately.
• Existing remote HTTPS references remain. PNG/JPEG and TTF/OTF conversion failures retain the uploaded original with a warning; the final scene is Player-compressed before draft save. Large video upload sessions are outside this tool. Unsupported or incompatible bindings are rejected.

blings_upsert_connector Write Direct tool + write gateway

Adds or updates one validated typed content or interaction connector.

Use it to: Bind text, media, color, visibility, input, form, or supported actions.

Toolset and constraints

• Toolset: Connectors (connectors).
• This operation is available as a direct tool and through its gateway. The gateway is blings_write_operation.
• Arbitrary JavaScript and animation generation are not supported.

blings_validate_motion_batch Read Read gateway

Dry-runs up to 50 allowed native motion operations without saving.

Use it to: Check a batch of motion changes before applying them to a draft scene.

Toolset and constraints

• Toolset: Layers and motion (motion).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• Preset-derived and arbitrary runtime operations are rejected.

blings_validate_project Read Direct tool + read gateway

Checks project structure, assets, bindings, flow, fonts, and optimization setup.

Use it to: Find static issues before publishing or requesting a visual review.

Toolset and constraints

• Toolset: Review and publishing (review).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Validation does not modify content or execute project code.

blings_video_creation_guide Read Direct tool + read gateway

Provides canonical guides for editable video creation, motion, personalization, audio, media and delivery.

Use it to: Start with overview for a new video, or library to browse every skill and reference; follow the returned topic IDs one at a time.

Toolset and constraints

• Toolset: Context and guidance (context).
• This operation is available as a direct tool and through its gateway. The gateway is blings_read_operation.
• Topics come from the motion, audio and media owners, with canonical paths in every answer. File topics return their complete exact source.content.
• Creation guidance covers scene flow, personalization defaults and viewer actions before authoring.
• Tool availability depends on runtime discovery; hosted intake remains disabled pending browser isolation and admission qualification.
• Returns reference material only. It does not generate media, upload files, or change projects.

blings_whoami Read Read gateway

Shows the connected Blings user, granted permissions, live server release, and OAuth resource.

Use it to: Confirm identity and compare the connected release when tools appear missing or outdated.

Toolset and constraints

• Toolset: Context and guidance (context).
• This operation is available through its read/write gateway. The gateway is blings_read_operation.
• The release is a build identifier, separate from the MCP protocol version. Compare it with the releaseId at the server health endpoint; this does not force a client to refresh cached tools.