Uwear

Archive a workflow and disable it. Reversible with update_production_workflow.

Queue the conversation for asynchronous ArtDirection authoring using Uwear's prompt system. Use save=true when the user wants to create, build, or save a reusable ArtDirection. Use save=false when the user explicitly wants an unsaved draft or brainstorming pass. This returns a job ID; call get_art_direction_authoring_job until status is done or failed.

Build a highly detailed prompt for generating a unique reusable avatar/model. Use this when the user wants help describing a person before image generation. If the user's prompt is already intentional and specific, Uwear can skip this and pass the user's wording directly to generate_avatar.

Call this to approve and idempotently execute a visible persisted Uwear brief. In MCP, a one-word 'Confirm' or phrases like 'looks good', 'run it', 'start', or 'generate' mean execute=true unless the user explicitly says to approve without starting. Use the visible/latest BriefProposal brief_id. Repeated calls return or resume the same durable execution.

Create a company ArtDirection markdown document. Use author_art_direction first when the user provides rough creative text or reference images. Use this direct writer only for already-structured markdown that follows the Variation Controls parser contract.

Create a hosted Stripe Checkout URL for buying Uwear generation credits. Use only when the user explicitly asks to buy, add, top up, or purchase credits, or when they ask how to continue after insufficient credits. Do not call during photoshoot planning unless the user requested checkout. The tool only creates a payment link; the user must open and complete payment in Stripe.

Create a reusable location/scene reference from an image URL. If no description is supplied, the backend analyzes the image. Use the returned location_id in propose_brief/update_brief.

Create an outfit from existing garment IDs. Pairs saved garments together into a saved outfit without uploading new images.

Create a workflow. It has no graph until a version is created, and it runs nothing until a version is published.

Open a new draft version holding the graph. Drafts are editable and never execute. See uwear://contracts/production-workflow for typed node configs and worked examples.

Create a new tag for organizing assets (garments, models, outfits, files, results, locations). Requires an active company workspace.

Permanently delete a library template. Owner-only templates must be deleted through their owning resource.

Bundle generation results into a ZIP and return a time-limited download URL. Use when the user wants to download or export their generated images/videos.

Duplicate a system or company ArtDirection into an editable company copy.

Estimate credit cost for an operation.

Second step only for local garment images already prepared with prepare_local_garment_upload and uploaded to every returned target. Classify each upload_handle as a full/detail front/back/side asset. Do not use this for ChatGPT attachments or arbitrary public URLs.

Generate canonical reusable avatar/model design-sheet candidates from the provided person description. The result uses the same character-sheet template and creator path as the Uwear app. Use when the user has no saved avatars and explicitly asks Uwear to create a reusable model/avatar, especially for consistency across a shoot. Do not block a normal photoshoot on this; avatar/model is optional. If the user wants help inventing or enriching the person's description, call build_avatar_prompt first; if the user's prompt is already intentional and specific, pass it directly here. Pass model when the user requests a specific image model; otherwise the backend uses the cheapest active image generation model available to the account. After results complete, call save_generated_avatar on the chosen result to save it to the avatar library.

Get a selectable ArtDirection by ID.

Read an asynchronous ArtDirection authoring job. Poll the job ID returned by author_art_direction until status is done or failed. A done job includes the authored markdown and, when save=true, the saved art_direction_id.

Load an existing persisted brief unchanged by a real positive brief_id. Only use when the user supplied that brief_id or after propose_brief/update_brief returned it and the user wants to re-open the same brief. Never use brief_id=0, a placeholder, or a guessed ID. Never use this to start a new photoshoot. When the user asks to modify, rewrite, add steps to, or show an adjusted brief, call update_brief with the complete updated brief instead of looping on get_brief.

Get a specific garment by ID.

Look up generation results by exact IDs, filters, or hybrid image/name/SKU search. Returns labeled native ImageContent previews; use them directly and never Markdown-embed result URLs. They are display previews, not originals: url/download_url are originals, preview_url is the fallback link, and poster_url/thumbnail_url is a video poster. Every result includes generation_result_id and the response includes generation_result_ids; use those exact integers for queue_generation_result_qa/read_generation_result_qa or as durable generation_result command.source values in canonical edit, upscale, and video commands. Confirmation-gated clients use propose_brief(commands=[...], execute_immediately=true) when the user asked to run now, update_brief for a complete command replacement, or confirm_brief(execute=true) for a visible brief. Pass generation_result_id to fetch one result or generation_id to list a job's results. Returns raw payload when available so prior prompts can be recovered. Use start_date/end_date for requests like 'last week'.

Check generation job status. Completed results may include labeled native ImageContent previews; use them directly and never Markdown-embed result URLs. They are display previews, not originals: url/download_url are originals, preview_url is the fallback link, and poster_url/thumbnail_url is a video poster. Returns status, raw payload, settings, avatar_id, model_id, model_slug, use_case, credits_charged, estimated_processing_seconds, and status_guidance. Status can remain Created while queued/preparing; avoid tight polling loops. UI 'Gemini Pro' maps to model_slug nano-banana-pro or nano_banana_pro_clothing.

Get all item IDs tagged with a specific tag, grouped by type. Use after list_tags for no-UI MCP requests like 'use my clothes tagged summer26'; then pass the resulting clothing_item IDs as garment_ids to propose_brief instead of opening request_user_context.

Get a reusable location/scene reference by ID.

Read one workflow with its version summaries and which version is live.

Read the company kill switch — whether automation is stopped, and why.

Read one run in full: stable accepted results, per-node status, media, errors, retries, and the credits it moved.

Read one version's full graph. See uwear://contracts/production-workflow for typed node configs and worked examples.

Load one canonical company template by ID. Pass expected_template_kind when the caller requires a generation_preset or batch_workflow.

Get user's current credit balance.

List selectable ArtDirections as compact summaries: visible system ArtDirections plus company ArtDirections. Use query to match exact names and natural-language creative requests. Use this as the catalog step before choosing an art_direction_id for a brief; if there is no clear match, fall back to the user's phrase as prompt/creative_context. Use get_art_direction for the full markdown document before reusing one in a brief.

List the user's avatars: the reusable people who wear the garments, called 'models' or 'mannequins' in fashion terms (not the AI engines — for those, use list_models). Supports structured filters or query for hybrid name/metadata/image-attribute search. Set include_image_url=true when the avatar image itself is needed.

List user's garments with structured filters or query for hybrid name/SKU/metadata/image-attribute search.

List reusable location/scene reference images by structured filters or query: IDs, tags, date range, and sort. Use when the user wants to pick a saved background/location reference for a generation.

List available AI generation models (image, video, edit, upscale engines) by type, with credit costs. These are the AI models that render photoshoots — not the human models/avatars; for those, use list_avatars.

List user's outfits (saved garment combinations). Filter by garment IDs, active status, date range, or query against contained garments.

List run history, newest first, filterable by workflow and status.

List a workflow's versions and their state.

List this company's workflows.

List available tags for the user's company. Use this to resolve user-provided tag names like 'summer26' before selecting garments, outfits, models, files, generations, or locations. For no-UI MCP flows, find the tag ID here, then call get_items_by_tag or the relevant list_* tool with tag_ids.

List canonical company templates, optionally filtered by kind, scope, or command use case. Templates persist canonical commands but do not execute generations. System templates named `Demo — …` are worked examples of the canonical command language; read one with `get_template` before authoring a first brief or workflow.

App-only: append items to the session-scoped Uwear Shoot Board.

App-only: clear all session context items, or only one context type.

App-only: create a hosted Stripe Checkout URL for buying Uwear credits from the MCP workspace credit control. Hidden from the host LLM so photoshoot planning does not drift into billing unless the user presses the plus button.

App-only: export the user-confirmed montage clips as a stitched video. Spends credits, so it is hidden from host LLMs; the MCP iframe calls this after the user presses Export on the MontageProposal card. Returns the generation_id to poll via get_generation_status.

App-only: queue an image-to-video generation for a montage clip. Spends credits, so it is hidden from host LLMs; the montage editor calls this when the user presses Generate on a draft clip. Returns the generation_id to poll via get_generation_status.

App-only: hydrate the session-scoped Uwear Shoot Board.

App-only: list uploaded files for the Uwear MCP workspace files tab.

App-only: replace the session-scoped Uwear Shoot Board items.