Formatry

Read one visual generation by id and follow nextAction. Only succeeded plus a ready artifact manifest is deliverable.

formatry_get_generation_job

Complete the exact prepared upload after the bundled helper confirms byte upload. Use the original uploadId, assetId, byteLength and SHA-256; retain the ready asset id. Reuse the same idempotency key only for an unchanged retry.

formatry_complete_asset_upload

Read short-lived download metadata only; the signed URL stays redacted and no file is delivered. Read the manifest, then use formatry_prepare_artifact_download with the bundled helper, or formatry_download_artifact_file in a compatible resource-aware host, to obtain actual bytes.

formatry_create_artifact_download_url

Create one standalone protected PNG preview directly; no balance, quota or asset-list preflight is required. Use a documented sizeId, or matching sizeId and customSize.id with width/height. Reuse an idempotencyKey only for unchanged input; honor returned quota/reset errors.

formatry_create_preview

Save one named workspace size pack with exact format names, dimensions and enabled states. Does not apply the pack to the creative or select it as default. Persist only create_preset_pack operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_create_studio_preset_pack

Delete one custom size pack using its current expectedName and expectedUpdatedAt. Read the library first. Does not delete creatives that previously used the pack. Persist only delete_preset_pack operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_delete_studio_preset_pack

Return one ready manifest file as an authenticated MCP resource. Choose artifactId and fileId from formatry_get_artifact_manifest.

formatry_download_artifact_file

Update the shared theme colors of a saved creative. Persist only set_theme operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_set_studio_theme

Update one size-specific visual or Animation override of a saved creative. Persist only set_size_override operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_set_studio_size_override

Update supported composition, background, surface and product styling on a saved creative. Persist only set_style operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_set_studio_style

Update headline, subtitle, descriptor or call-to-action text on a saved Images or Animation creative. Persist only set_copy operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_set_studio_copy

Update the shared font selections and weights of a saved creative. Persist only set_typography operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_set_studio_typography

Confirm a fresh account-balance Images or Animation quote after the user approves its output set and exact creditsRequired. Pass that cost as approvedUnits. Requires native OAuth. Uses the same ordinary credit and subscription balance as Studio; Animation has no separate wallet. Reuse the original quote and idempotency key for an unchanged retry. Insufficient balance creates no job or debit. Never buys credits, creates subscriptions or initiates checkout. Old included-only quotes require a fresh quote and new cost approval.

formatry_confirm_credit_export

Confirm one exact Images or released Animation quote already covered by the connected account's included subscription allowance or unlimited entitlement. Obtain authorization for the output set and its quoted units; pass the exact creditsRequired as approvedUnits. Requires native OAuth. May consume subscription quota, but cannot debit purchased-credit balances, buy credits, create a subscription or initiate checkout. Reuse the original quote id and idempotency key for unchanged retries. Insufficient included allowance fails without creating a job or debit.

formatry_confirm_included_export

Confirm a server-issued free raster quote after the user approves its output set. Consumes the real free-image allowance and starts the existing generation job. Paid or non-raster quotes must be rejected by the server. Retry only the same quote and idempotency key, then wait for the job and download its ready artifact files.

formatry_confirm_studio_export_quote

Read the authenticated workspace Brand Kit and sourceFingerprint required by apply_brand_kit without changing it.

formatry_get_studio_brand_kit

Read one exact persisted Studio creative revision, including its document and asset bindings, before composing a mutation.

formatry_get_studio_creative

Read a ready Formatry artifact manifest before requesting download metadata.

formatry_get_artifact_manifest

Read the effective Studio preset library and sourceFingerprint values required by apply_preset without changing it.

formatry_list_studio_presets

List compact creative summaries for one Studio project. This deliberately omits full creative documents and asset bindings; read the exact creative before proposing a command.

formatry_list_studio_project_creatives

List active Studio projects for the authenticated workspace. Use archived only when the user asks to inspect archived work.

formatry_list_studio_projects

List recent public credit ledger events for the authenticated Formatry workspace.

formatry_list_usage

List workspace assets available for an explicit Studio bind_asset command.

formatry_list_assets

Open the interactive editor for an account-owned creative. First create or read the creative, then pass its projectId and creativeId. Manual and agent edits use the same saved revision; opening does not render or export.

formatry_open_studio

Prepare a bounded upload for a local Codex file without Studio. First run the bundled file helper's inspect command to obtain exact metadata and SHA-256. Pass no local path or URL. Use the returned short-lived transfer with the helper to upload bytes, then call formatry_complete_asset_upload. Never print or persist the transfer ticket.

formatry_prepare_asset_upload

Prepare a short-lived transfer for one ready artifact file selected from its manifest. Run the bundled download helper to save and verify the file in the current workspace. Returns no raw file bytes or account credentials. Never print or persist the transfer ticket. For files over 25 MiB select individual smaller outputs instead of a large archive.

formatry_prepare_artifact_download

Create a protected image preview from one exact saved Studio creative revision. It consumes preview allowance but sends no raw creative payload; retry only the unchanged expectedRevision and idempotencyKey.

formatry_create_studio_creative_preview

Create a protected moving WebP preview from the saved Animation settings at an exact creative revision. Uses the existing preview allowance; it does not export files or debit credits. Retry only an unchanged revision and idempotency key.

formatry_create_studio_animation_preview

Quote the active Images or released Animation output at an exact saved revision. Images may use the shared account free-image allowance. Non-free Images and Animation use the existing ordinary account balance through formatry_confirm_credit_export after exact cost approval. Animation supports WebP, GIF and MP4. This starts no job or purchase.

formatry_create_studio_export_quote

Rename the exact saved project or creative. Project rename requires its current expectedName; creative rename uses its exact saved revision. Changes no canvas content. Persist only rename operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_rename_studio_entity

Create or replace the complete workspace Brand Kit. Use expectedUpdatedAt null only for creation; replacement requires the current saved timestamp. Replacement clears omitted sections. Workspace-owned file references only; does not apply the kit to the creative. Persist only upsert_brand_kit operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_upsert_studio_brand_kit

Select Images or the released Animation workspace without discarding the other output's settings. Persist only set_workspace_mode operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_set_studio_workspace_mode

Select one enabled workspace size pack as the default using its exact packId and current expectedName. Does not apply its formats to the current creative. Persist only set_current_preset_pack operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_set_studio_current_preset_pack

Select the shared Images/Animation canvas sizes and active size on a saved creative. Persist only set_canvas operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_set_studio_canvas

Set Images format or Animation WebP/GIF/MP4 with entrance, movement, duration, intensity and loop settings. This does not render, export or debit credits. Persist only set_delivery_spec operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_set_studio_delivery_spec

Create a named campaign project and its first raster creative in the authenticated workspace, without opening Studio. Use when the user asks for new work rather than editing an existing creative. Creates saved design data only; does not render, export or spend credits. Retain returned ids. Retry an unchanged creation with the same idempotencyKey; after editing, resume using the returned ids instead of starting again.

formatry_start_creative

Move one step through recent parameter edit history at the exact saved creative revision. This does not reverse exports or generation. Persist only move_history operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_move_studio_history

Update only the supplied Brand Kit sections, preserving omitted fields. Read the current Brand Kit first and retain expectedUpdatedAt. Workspace-owned file references only; does not apply the kit to the creative. Persist only patch_brand_kit operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_patch_studio_brand_kit

Update one exact workspace size pack. Read the current library first and retain expectedName plus the custom pack updatedAt or system pack sourceFingerprint. A supplied sizes list replaces the saved custom formats. Persist only update_preset_pack operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.

formatry_update_studio_preset_pack

Upload one file authorized by a compatible OpenAI host as a Formatry asset. Requires a host-issued file object. Regular Codex MCP connections use assets uploaded in Studio instead of local attachments.

formatry_upload_asset_file