formatry_add_creative
ChatGPTCreate an additional named blank raster creative inside an existing active project, without Studio. Use one stable idempotency key per requested creative. Retain returned ids and read its current revision before typed edits. An unchanged replay returns the current revision without resetting later edits; a renamed or archived target conflicts safely. This does not clone a source, render, export or spend credits.
formatry_apply_studio_brand_kit
ChatGPTApply the workspace Brand Kit using the exact id and sourceFingerprint returned by formatry_get_studio_brand_kit. Persist only apply_brand_kit operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.
formatry_apply_studio_command
ChatGPTPersist one atomic Studio command against an exact creative revision. Executable operations: set_copy, set_canvas, bind_asset, set_delivery_spec, set_lifecycle, set_theme, set_style, set_typography, set_size_override, apply_preset, apply_brand_kit. Preset and Brand Kit operations require the exact sourceFingerprint returned by their read tools. This replaces persisted creative state; retry only with the unchanged idempotency key and command.
formatry_apply_studio_preset
ChatGPTApply a preset to the selected workspace using the exact preset id and sourceFingerprint returned by formatry_list_studio_presets. Persist only apply_preset operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.
formatry_bind_studio_asset
ChatGPTBind an existing workspace asset to a creative slot, or clear that slot. Persist only bind_asset operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.
formatry_cancel_generation_job
ChatGPTCancel one queued generation job. Running jobs cannot be canceled; follow the returned next action instead.
formatry_check_balance
ChatGPTRead the authenticated Formatry workspace balance, quota, billing status, and credit unit.
formatry_complete_asset_upload
ChatGPTComplete 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_confirm_credit_export
ChatGPTConfirm 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_included_export
ChatGPTConfirm 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_studio_export_quote
ChatGPTConfirm 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_connection_status
ChatGPTCheck whether this hosted MCP session has usable Formatry credentials and return setup guidance without exposing secrets.
formatry_create_artifact_download_url
ChatGPTRead 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_preview
ChatGPTCreate 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_studio_animation_preview
ChatGPTCreate 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_creative_preview
ChatGPTCreate 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_export_quote
ChatGPTQuote 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_preset_pack
ChatGPTSave 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_delete_studio_preset_pack
ChatGPTDelete 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_download_artifact_file
ChatGPTReturn one ready manifest file as an authenticated MCP resource. Choose artifactId and fileId from formatry_get_artifact_manifest.
formatry_get_artifact_manifest
ChatGPTRead a ready Formatry artifact manifest before requesting download metadata.
formatry_get_generation_job
ChatGPTRead one visual generation by id and follow nextAction. Only succeeded plus a ready artifact manifest is deliverable.
formatry_get_preview_quota
ChatGPTRead preview allowance for quota questions, batch planning or rate-limit recovery. A single preview needs no separate quota check. Honor returned reset times.
formatry_get_studio_brand_kit
ChatGPTRead the authenticated workspace Brand Kit and sourceFingerprint required by apply_brand_kit without changing it.
formatry_get_studio_creative
ChatGPTRead one exact persisted Studio creative revision, including its document and asset bindings, before composing a mutation.
formatry_list_assets
ChatGPTList workspace assets available for an explicit Studio bind_asset command.
formatry_list_studio_presets
ChatGPTRead the effective Studio preset library and sourceFingerprint values required by apply_preset without changing it.
formatry_list_studio_project_creatives
ChatGPTList 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_projects
ChatGPTList active Studio projects for the authenticated workspace. Use archived only when the user asks to inspect archived work.
formatry_list_usage
ChatGPTList recent public credit ledger events for the authenticated Formatry workspace.
formatry_move_studio_history
ChatGPTMove 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_open_studio
ChatGPTOpen 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_patch_studio_brand_kit
ChatGPTUpdate 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_prepare_artifact_download
ChatGPTPrepare 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_asset_upload
ChatGPTPrepare 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_rename_studio_entity
ChatGPTRename 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_set_studio_canvas
ChatGPTSelect 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_copy
ChatGPTUpdate 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_current_preset_pack
ChatGPTSelect 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_delivery_spec
ChatGPTSet 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_lifecycle
ChatGPTArchive or restore a saved creative. Persist only set_lifecycle operations against the exact expectedRevision. Command target ids must match; retry only with the unchanged commandId, idempotencyKey and command.
formatry_set_studio_size_override
ChatGPTUpdate 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_style
ChatGPTUpdate 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_theme
ChatGPTUpdate 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_typography
ChatGPTUpdate 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_workspace_mode
ChatGPTSelect 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_start_creative
ChatGPTCreate 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_update_studio_preset_pack
ChatGPTUpdate 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_upload_asset_file
ChatGPTUpload 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_upsert_studio_brand_kit
ChatGPTCreate 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_wait_for_generation_job
ChatGPTPoll one visual generation until it succeeds, fails, is canceled, or reaches the attempt limit. Follow nextAction after every result.
