Name: Uwear
Author: uwear

Use this when the user wants a photoshoot and you have no board_id yet. Creates a new, empty Uwear Shoot Board and returns its board_id, which every other Shoot Board tool takes. This client shows no widget: build the shoot with tools (search_uwear_library, modify_shoot_board, propose_brief) and tell the user what is on the board. prompt: one line describing the shoot; expected_types: what it need

Parameter	Type	Required	Notes
prompt	string	yes	Instruction shown to the user, e.g. 'Select the clothing items you want to use and add them to the Shoot Board'
expected_types	array	yes	Accepted item types (match panel tabs): 'clothing', 'models', 'outfits', 'generations', 'files'. Legacy 'file' is accepted as an alias for 'files'.
min_items	integer	no	Minimum number of items the user must provide
board_id	string	no	The open Shoot Board's board_id, from Open Shoot Board or your context.

Use this before modify_shoot_board, propose_brief or update_brief: the user changes the board in the widget at any time. Returns the board's items (Clothing, Models, Outfits, Locations, art directions, files, results) with ids and names, its revision, its linked brief_id, and brief_inputs: the guide, asset facts, automations, cameras, AI models and limits a brief is written from. Changes nothing.

Parameter	Type	Required	Notes
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Use this when the user names Clothing, Models, Locations, art directions, files or past results in chat and you need their ids. Takes a short keyword query (2-5 words, or an exact name, SKU or id) and returns typed ids, names and thumbnails. It finds items; it does not recommend them. Changes nothing.

Parameter	Type	Required	Notes
query	string	yes	Short keyword query: 2 to 5 words, one concept per call, or an exact name/SKU/ID. Every word must match for lexical results, so long sentences can return no lexical matches. Describing a garment finds
item_types	array	no	Optional item types to search. Omit to search clothing, avatars/models, locations, art directions, uploaded files, and generation results.
limit	integer	no	Maximum number of hybrid matches to return
exclude_clothing_item_ids	array	no	Exclude these garment IDs after ranking and before the result limit; other item types are unaffected.
refresh_index	boolean	no	Deprecated compatibility input. No index refresh is performed, even when true. Search uses the maintained index and current lexical metadata. Leave false.

Use this when the user asks in chat to change what is on the open Shoot Board. add puts items on it; set replaces the whole item list (to remove items, send the ones to keep); clear empties one type, or without type starts a new shoot on the same board (its brief is unlinked; photos stay in the library); add_as_view makes from_garment_id's photo the back, side or detail view of garment_id and take

Parameter	Type	Required	Notes
expected_revision	integer	yes	Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it
action	string	yes	add: put items on the board; set: replace all items; clear: remove one type, or without type everything and the board's brief (a new shoot on this board); add_as_view: from_garment_id's photo becomes
items	array	no	add / set: the items. An automations item (id: a workflow_id from brief_inputs.automations) pins the Automation every look of the brief runs through; a board pins one, a new one replaces it. A board h
type	string	no	clear: only this type; omit for a new shoot (the whole board and its brief)
garment_id	integer	no	add_as_view: the board garment that gains the photo as a view
from_garment_id	integer	no	add_as_view: the board garment whose photo it is; it leaves the board
view	string	no	add_as_view: back, side, or detail (a close-up)
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Moves a Shoot Board that is open in a widget to a view (board, brief, automation, results, brief_history). This client shows no widget, so it changes nothing the user sees: read the board, brief or results with read_shoot_board, get_brief or get_generation_results and tell the user.

Parameter	Type	Required	Notes
view	string	yes	board: the board's photos (Clothing, Models, Locations, references, the pinned Automation); brief: the brief's looks beside its automation (once it ran, each look with its photos and videos); automati
look_key	string	no	brief / results: the look to bring forward (a key of the brief's looks)
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Use this when the user attaches images in this chat and wants them in Uwear, on the Shoot Board or in a shoot: clothing, a Model, a Location or a reference. Put each attachment in its own field, image_file_1, image_file_2, ... in attachment order, as the chat provides it: ChatGPT passes the file itself, also when you see only a file name or path. Chat attachments only: a web address is refused (as

Parameter	Type	Required	Notes
image_file_1	object	yes	An image attached in this chat, passed as the chat provides it.
image_file_2	object	no	An image attached in this chat, passed as the chat provides it.
image_file_3	object	no	An image attached in this chat, passed as the chat provides it.
image_file_4	object	no	An image attached in this chat, passed as the chat provides it.
image_file_5	object	no	An image attached in this chat, passed as the chat provides it.
image_file_6	object	no	An image attached in this chat, passed as the chat provides it.
image_file_7	object	no	An image attached in this chat, passed as the chat provides it.
image_file_8	object	no	An image attached in this chat, passed as the chat provides it.
image_file_9	object	no	An image attached in this chat, passed as the chat provides it.
image_file_10	object	no	An image attached in this chat, passed as the chat provides it.
upload_handles	object	no	Only the upload_handle values a previous call of this tool returned in upload_needed, after running their commands: {image_file_N: upload_handle}. Never the attachments themselves: those go in image_f
kinds	object	no	What each photo is, when you can tell (garment: clothing; avatar: a person to use as a Model; location: a place; reference: a pose, mood or styling photo), or the user's answer for one that came back
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Use this when the user asks to create, write or save an art direction, or the board's New art direction asks for one: write it from their words, the chat and the board, and save it in the same turn. Saves it to the library and makes it the board's one art direction, replacing the previous one (which stays in the library). Fill every section with concrete, photographable choices. It applies to ever

Parameter	Type	Required	Notes
name	string	yes	Its title, 2-6 words, the one you used in chat (never Untitled or Art direction).
overview	string	yes	What the photos should feel like overall, in 1-2 sentences.
mood	string	yes	The feeling and the pose language: energy, expression, how the model moves.
light	string	yes	Direction, softness, colour temperature and shadows (e.g. low warm sun from the left, long soft shadows).
setting	string	yes	Where it is shot: studio backdrop or place, surfaces, props.
palette	string	yes	The colours of set, light and styling (e.g. terracotta, sand, washed olive).
camera	string	yes	Framing, angle, lens feel and distance (e.g. eye-level 50mm, full body with headroom).
styling	string	yes	How the clothes are worn, hair, makeup, accessories, footwear.
must_keep	array	no	Rules every photo keeps, one per line (the user's own must-haves).
avoid	array	no	What never appears, one per line.
variations	array	no	Only when the user wants variety across photos: each a name (Pose, Backdrop) and 2-6 complete alternatives Uwear rotates through.
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Use this when the user describes a shoot. Saves a brief, the looks to shoot and the automation they run through, and links it to the board in place of the current one. Nothing runs or is charged: show the user the looks and the credit quote (get_brief), and generate with confirm_brief only after they agree. Read the board first with read_shoot_board and follow brief_inputs.guide. If the result lis

Parameter	Type	Required	Notes
looks	array	yes	The looks to shoot, each one outfit worn in the shoot, with ids from read_shoot_board.
recipe_workflow_id	string	no	An automation from read_shoot_board's brief_inputs.automations that every look runs through as is (only when it matches what the user asked for). Not with recipe. Omitted while the board pins one (bri
recipe		no	The shots and steps the user described (views, crops, edits, upscale, video): Uwear builds them as a new automation. Not with recipe_workflow_id.
title	string	no	The shoot's name, only in the user's own words; otherwise leave it out.
direction		yes	Required: what every shot of every look follows, exactly what Generate runs: prompt, art_direction_id (a saved art direction), or both. Write one direction for every look from what the user wants (set
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Use this when the user asks in chat to change the board's brief: its looks, Models, outfits, Locations, references, name, shots and steps, AI model or art direction. Send the complete replacement look list with the brief_id it replaces, keeping each unchanged look's key. Shots or steps: recipe with the complete new shot list (recipe_look_keys for some looks only) or recipe_workflow_id. AI model on

Parameter	Type	Required	Notes
brief_id	integer	yes	The brief being revised: the board's brief_id from read_shoot_board.
looks	array	yes	The complete new look list (not a diff); an unchanged look keeps its key.
title	string	no	A new name for the shoot, only the user's own words (omit: kept).
recipe_workflow_id	string	no	An automation from read_shoot_board's brief_inputs.automations for the looks below. Not with recipe.
recipe		no	The complete new shots and steps, built as a new automation for the looks below (e.g. the old shots plus a side view). Not with recipe_workflow_id.
recipe_look_keys	array	no	The looks (keys you send) that move to recipe / recipe_workflow_id; omit for every look.
direction		no	A new Direction for the whole shoot, replacing the brief's (omit: kept): prompt, art_direction_id (a saved art direction), or both. Write one direction for every look from what the user wants (setting
image_model	string	no	A listed image model's slug the user asked for ("use GPT Image"): the shoot's AI model, every shot and edit of every look runs on it; the automation is unchanged. Not with recipe (name it in recipe.im
video_model	string	no	A listed video model's slug the user asked for: the shoot's videos run on it. Not with recipe (name it in recipe.video_model).
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

List user's garments with structured filters or query for hybrid name/SKU/metadata/image-attribute search. body_zone expands to categories and is ORed with category when both are given. With a category or body_zone filter and include_uncategorized=false, uncategorized_count reports garments hidden by the category filter within the same scope. If matches are short and uncategorized_count > 0, call

Parameter	Type	Required	Notes
query	string	no	Hybrid search across garment names, SKUs, metadata, and visual attributes.
clothing_item_ids	array	no	Filter to specific garment IDs
tag_ids	array	no	Filter to garments with any of these tags
category	array	no	Filter to garments in any of these canonical categories; OR with body_zone when both are given.
body_zone	array	no	Filter to categories in any of these body zones; OR with category when both are given.
include_uncategorized	boolean	no	Also include garments with no category when category and/or body_zone filters are used. If the first result has uncategorized_count > 0 and too few matches, call again with true and inspect those garm
exclude_clothing_item_ids	array	no	Exclude these garment IDs, for example the attached garment.
start_date	string	no	Filter: created on or after this date (ISO format, e.g. '2025-06-01')
end_date	string	no	Filter: created on or before this date (ISO format)
sort	string	no	Sort order: 'field:direction', e.g. 'created_at:desc', 'clothing_item_name:asc'. Default: created_at:desc
page	integer	no	Page number for pagination
limit	integer	no	Number of items per page
include_image_url	boolean	no	Set true when the garment image itself is needed for visual display or reuse.

Upload Clothing from public HTTP(S) image URLs. Queues a recoverable batch upload and returns an operation immediately; retry with the exact same arguments to read its state (a retry creates no second upload). Photos are stored as uploaded, without background removal; processing_mode is ignored. Prefer assets with {asset_kind: full|detail, asset_view: front|back|side, asset_url}; exactly one full

Parameter	Type	Required	Notes
garments	array	no	Garments to upload from public HTTP(S) URLs. No chat file objects and no base64.
image_url	string	no	Single public HTTP(S) front image URL
back_image_url	string	no	Single optional public HTTP(S) back image URL
side_image_url	string	no	Single optional public HTTP(S) side image URL
detail_image_urls	array	no	Single optional public HTTP(S) detail image URLs
assets	array	no	Single garment full asset set. Use asset_kind/asset_view. Exactly one full front is required; full views are unique and detail views can repeat.
name	string	no	Single garment name
description	string	no	Single item-level garment description hint
gender	string	no	Single garment gender: male, female, unisex
file_name	string	no	Single original file name
mime_type	string	no	Single MIME/content type, e.g. image/png
processing_mode	string	no	Optional image processing. 'background_removal' removes the background (the platform upload default); 'none' stores the image as-is. Omit to use background removal.
board_id	string	no	The open Shoot Board's board_id, from Open Shoot Board or your context.

List the user's Models: the reusable people who wear the Clothing (not the AI models; for those, use mcp_list_model_catalog). Supports structured filters or query for hybrid name/metadata/image-attribute search. Set include_image_url=true when the Model's image itself is needed.

Parameter	Type	Required	Notes
query	string	no	Hybrid search across avatar/model names, metadata, and visual attributes.
avatar_ids	array	no	Filter to specific avatar IDs
tag_ids	array	no	Filter to avatars with any of these tags
start_date	string	no	Filter: created on or after this date (ISO format)
end_date	string	no	Filter: created on or before this date (ISO format)
sort	string	no	Sort order: 'field:direction', e.g. 'created_at:desc'. Default: created_at:desc
page	integer	no	Page number for pagination
limit	integer	no	Number of items per page
include_image_url	boolean	no	Set true when you need to inspect or reuse the avatar/model image URL.

Batch upload reusable Models from person photos the user attached in chat. Each photo becomes the upper_body_front identity anchor. Keep names and optional user-given age_range, build, and height_cm in avatars[], then pass top-level image_file_1, image_file_2, etc. in the same order. Traits are never guessed. No base64, no local paths. Do not use ordinary text-to-image results as an upload fallbac

Parameter	Type	Required	Notes
age_range	string	no	Optional concrete age or age range. Never inferred.
build	string	no	Optional concrete physical build. Never inferred.
height_cm	integer	no	Optional height in centimeters. Never inferred.
avatars	array	no	Avatar/model metadata in the same order as image_file_1, image_file_2, etc. No base64.
image_file_1	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_2	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_3	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_4	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_5	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_6	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_7	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_8	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_9	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_10	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_url	string	no	Single resolved download URL used by automatic opaque-file recovery.
name	string	no	Single recovered avatar/model name
description	object	no	Single recovered avatar metadata
file_name	string	no	Single recovered original file name
mime_type	string	no	Single recovered MIME/content type, e.g. image/png
board_id	string	no	The open Shoot Board's board_id, from Open Shoot Board or your context.

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

Parameter	Type	Required	Notes
query	string	no	Search outfit names and contained garments.
outfit_ids	array	no	Filter to specific outfit IDs
clothing_item_ids	array	no	Filter to outfits containing any of these garments
tag_ids	array	no	Filter to outfits with any of these tags
is_active	string	no	Filter by status: 'true', 'false', or 'both' (default: both)
source	string	no	Filter by outfit source.
start_date	string	no	Filter: created on or after this date (ISO format)
end_date	string	no	Filter: created on or before this date (ISO format)
sort	string	no	Sort: 'field:direction'. Use 'latest_generation_at:desc' to surface recently generated outfits. Default: created_at:desc
page	integer	no	Page number for pagination
limit	integer	no	Number of items per page

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.

Parameter	Type	Required	Notes
query	string	no	Hybrid search across location names, metadata, and visual attributes.
location_ids	array	no	Filter to specific location IDs
tag_ids	array	no	Filter to locations with any of these tags
start_date	string	no	Filter: created on or after this date (ISO format)
end_date	string	no	Filter: created on or before this date (ISO format)
sort	string	no	Sort order: 'field:direction', e.g. 'created_at:desc', 'location_name:asc'. Default: created_at:desc
page	integer	no	Page number for pagination
limit	integer	no	Number of items per page
include_image_url	boolean	no	Set true when the location/reference image URL is needed for inspection or reuse.

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.

Parameter	Type	Required	Notes
name	string	yes	Name for the reusable location/scene reference
image_url	string	yes	URL of the location/reference image
description	string	no	Optional location description. If omitted, the system analyzes the image.
thumbnail_url	string	no	Optional thumbnail URL
source_metadata	object	no	Optional provenance metadata for the source image
tag_ids	array	no	Optional tag IDs to assign after creating the location

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

Parameter	Type	Required	Notes
name	string	yes	Tag name (unique within the company)
color	string	no	Optional hex color, e.g. '#22C55E'

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 compact status, parent/child generation IDs, camera, avatar_id, model_id, model_slu

Parameter	Type	Required	Notes
include_snapshot	boolean	no	Include full generation settings, resource snapshots and raw prompt payloads. Large; use only for prompt recovery.
generation_id	integer	yes	The generation ID to check. Returns compact status, avatar_id, model_id, model_slug, and use_case. UI 'Gemini Pro' maps to model_slug nano-banana-pro or nano_banana_pro_clothing.

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

Parameter	Type	Required	Notes
include_snapshot	boolean	no	Include full generation settings, resource snapshots and raw prompt payloads. Large; use only for prompt recovery.
generation_result_id	integer	no	Look up a single result image by its generation_result_id (the exact integer ID required by QA/edit/upscale/video tools). Returns that one result directly.
generation_id	integer	no	Filter by parent generation ID (lists all result images from one generation job)
query	string	no	Hybrid search across generated image content, originating item names, and SKUs.
page	integer	no	Page number for pagination
limit	integer	no	Number of items per page
avatar_ids	array	no	Filter results to images generated with these avatars
location_ids	array	no	Filter results to images generated with these locations
outfit_ids	array	no	Filter results to images generated with these outfits
art_direction_ids	array	no	Filter results to images generated with these art directions
model_ids	array	no	Filter results to images generated with these AI models
clothing_item_ids	array	no	Filter results to images generated with these clothing items
tag_ids	array	no	Filter by tag IDs (results must have at least one)
kind	string	no	Filter by type: 'Image', 'Edit', 'Upscale', 'Video'
start_date	string	no	Filter results created on or after this ISO date/datetime, e.g. 2026-04-20.
end_date	string	no	Filter results created on or before this ISO date/datetime, e.g. 2026-04-27.
qa_statuses	array	no	Filter by QA statuses, e.g. pending, processing, completed, error.
decision	string	no	Filter by the unified result verdict.
decision_source	string	no	Filter by the verdict source.

Default tool for generation-result QA. Use this whenever the user asks to QA, quality check, validate, review, inspect for defects, approve/reject, or assess already-created generation results. Do not substitute view_image for QA unless the user explicitly asks for a manual visual critique instead of the official Uwear QA pipeline. First identify the numeric generation_result_ids, then call this t

Parameter	Type	Required	Notes
generation_result_ids	array	yes	Generation result IDs to QA. Queued or requeued QA costs 1 credit per result.
max_qa_retries	integer	no	Maximum QA-triggered retry generations to allow. Retry generations can cost additional generation credits.

Read official Uwear QA status, decision, and structured QA JSON for existing generation results. Call this after queue_generation_result_qa when the user asks to QA/check/validate/review generated outputs; summarize the structured decision and issues, not a manual view_image opinion.

Parameter	Type	Required	Notes
generation_result_ids	array	yes	Generation result IDs to read QA for

The result viewer's star. Marks one of the user's own generation results as a favorite (favorite true) or removes the mark (false); deletes nothing and spends no credits.

Parameter	Type	Required	Notes
generation_result_id	integer	yes	The generation result ID
is_favorite	boolean	yes	True to favorite, false to unfavorite

ONLY for video montage/stitching/export workflows. Use when the user explicitly asks to create a montage, stitch clips, make a reel, export a video sequence, make video clips from images, or combine images/videos into one final video. Never use this for a photoshoot, lookbook, product shoot, collection shoot, outfit shoot, garment shoot, or image-generation request; those must use request_user_con

Parameter	Type	Required	Notes
items	array	yes	Ordered list of montage items. Each is either an existing video or an image needing video generation. Min 1, max 10.
aspect_ratio	string	no	Output aspect ratio (e.g. '9:16', '16:9', '1:1')
base_resolution	integer	no	Output resolution height in pixels
board_id	string	no	The open Shoot Board's board_id, from Open Shoot Board or your context.

Patch the latest MontageProposal already shown in the UI. Use only for an existing video montage/reel/stitched sequence proposal; do not use this to modify a photoshoot brief. For photoshoot brief changes, call update_brief instead. Prefer operations, an ordered list of typed montage edits such as clear_trim, remove, set_duration, set_trim_range, set_speed, set_muted, set_prompt, `

Parameter	Type	Required	Notes
operations	array	no	Ordered montage patch operations. Preferred over the legacy flat fields below.
clip_number	integer	no	1-based clip number to update. Omit when apply_to_all=true.
clip_numbers	array	no	Optional list of 1-based clip numbers to update together.
apply_to_all	boolean	no	Apply changes to every clip in the current montage proposal.
remove	boolean	no	Remove the selected clip(s) from the proposal.
clear_trim	boolean	no	For video clips, remove trim bounds and restore the full clip length in the proposal.
target_duration	number	no	Desired final clip length in seconds.
start_time	number	no	Trim start time in seconds for legacy trim-range updates.
end_time	number	no	Trim end time in seconds for legacy trim-range updates.
speed	number	no	Playback speed multiplier.
muted	boolean	no	Mute or unmute the selected clip(s).
prompt	string	no	Update the motion prompt for image-to-video montage items.
video_model	string	no	Update the video model for image-to-video montage items.
generate_audio	boolean	no	Enable or disable generated audio for image-to-video montage items.
last_frame_url	string	no	Optional last-frame URL for image-to-video montage items.
aspect_ratio	string	no	Update the montage output aspect ratio.
base_resolution	integer	no	Update the montage output resolution height.
board_id	string	no	The open Shoot Board's board_id, from Open Shoot Board or your context.

Get user's current credit balance.

No parameter schema on file.

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.

No parameter schema on file.

Batch save reference images from chat attachments into the Files library. Keep file metadata in files[] and pass top-level image_file_1, image_file_2, etc. in the same order. No base64, no local paths. Use for mood boards, backgrounds, and other reference images that are not Clothing or Models.

Parameter	Type	Required	Notes
files	array	no	Reference file metadata in the same order as image_file_1, image_file_2, etc. No base64.
image_file_1	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_2	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_3	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_4	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_5	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_6	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_7	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_8	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_9	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_10	object	no	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_url	string	no	Single resolved download URL used by automatic opaque-file recovery.
file_name	string	no	Single recovered display name
mime_type	string	no	Single recovered MIME/content type, e.g. image/png
board_id	string	no	The open Shoot Board's board_id, from Open Shoot Board or your context.

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 be

Parameter	Type	Required	Notes
query	string	no	Hybrid search across saved ArtDirection names and creative content.
page	integer	no	Page number for pagination
limit	integer	no	Number of compact ArtDirection summaries per page

Get a selectable ArtDirection by ID.

Parameter	Type	Required	Notes
art_direction_id	integer	yes	The ArtDirection ID to retrieve

List canonical company templates, optionally filtered by kind, scope, command use case, or public t-xxxx share code. 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.

Parameter	Type	Required	Notes
template_kind		no	Filter generation presets or read-only historical batch_workflow records
catalog_scope		no	Filter by library or owner_only. Owner-only templates are hidden unless explicitly requested.
use_case	string	no	Filter by a use_case present in any stored command
share_code	string	no	Return the template assigned this public t-xxxx share code
page	integer	no	Page number for pagination
items_per_page	integer	no	Number of templates per page

Read the Uwear Shoot Board.

Parameter	Type	Required	Notes
board_version	integer	no	Pass 2 to receive board v2 state, including the board's output settings
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Replace the Uwear Shoot Board items.

Parameter	Type	Required	Notes
context_items	array	no	Shoot Board items that replace the current list when context_state is omitted
context_state	object	no	Complete Shoot Board state to sanitize and persist; takes precedence over context_items
expected_revision	integer	yes	Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it
board_version	integer	no	Pass 2 to receive board v2 state, including the board's output settings
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Append items to the Uwear Shoot Board.

Parameter	Type	Required	Notes
context_items	array	yes	Shoot Board items to append to the current list
expected_revision	integer	yes	Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it
board_version	integer	no	Pass 2 to receive board v2 state, including the board's output settings
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Clear all Shoot Board items, or only one context type.

Parameter	Type	Required	Notes
type	string	no	Context type to remove; omit to clear the entire Shoot Board
expected_revision	integer	yes	Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it
board_version	integer	no	Pass 2 to receive board v2 state, including the board's output settings
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

List uploaded (reference) files for the Uwear MCP workspace files tab and the Shoot Board's References tab.

Parameter	Type	Required	Notes
page	integer	no	Page number for uploaded file results
limit	integer	no	Maximum number of uploaded files per page
query	string	no	Optional search over file names and tags (the Shoot Board's References tab)
tag_ids	array	no	Optional: only files with any of these tags

Save an edited image (image_base64) as a new child result of parent_generation_result_id. Changes no existing result.

Parameter	Type	Required	Notes
parent_generation_result_id	integer	yes	Generation result ID of the original image
image_base64	string	yes	Retouched image encoded as base64 or an image data URL
file_name	string/null	no	Optional filename for the saved retouched image
mime_type	string/null	no	Optional image MIME type; inferred from a data URL or defaults to image/png
operations		no	Optional retouch operation metadata stored with the child result

Export montage clips as one stitched video. Spends credits: call it only after the user confirmed the clips and their order in chat. Returns the generation_id to poll with get_generation_status.

Parameter	Type	Required	Notes
clips	array	yes	Ordered generation-result clips to stitch into the montage
aspect_ratio	string	yes	Output video aspect ratio in W:H format
base_resolution	integer	yes	Output base resolution in pixels
fit_mode	string	yes	How each clip fits the output frame: contain or cover

Queue an image-to-video generation for one montage clip. Spends credits: call it only after the user agreed in chat. Returns the generation_id to poll with get_generation_status.

Parameter	Type	Required	Notes
model	string	yes	Video model slug or supported model name
prompt	string/null	no	Optional motion prompt for the video clip
duration	integer/null	no	Video duration in seconds; defaults to 5
resolution	string/null	no	Optional output resolution; defaults to 480p
generate_audio	boolean/null	no	Include audio in the delivered video. False delivers a silent file; fixed-audio providers are muted after generation at the same credits.
last_frame_url	string/null	no	Optional final-frame image URL for supported video models
generation_result_id	integer/null	no	Existing generation result ID to use as the source image; provide exactly one source
uploaded_file_id	integer/null	no	Uploaded file ID to use as the source image; provide exactly one source
image_url	string/null	no	HTTPS source image URL; provide exactly one source

Sort photos dropped on the Shoot Board into garment, avatar, location or reference (or unsure with two candidates) and report duplicates within the drop and in the library. Saves nothing. A photo the call had no time left for comes back with error deferred: send it again.

Parameter	Type	Required	Notes
files	array	yes	Dropped photos, in drop order; results use the same index
board_id	string	no	The open Shoot Board's board_id, from Open Shoot Board or your context.

Save sorted Shoot Board photos to the library as garments, avatars, locations or reference files, skip ones already saved, and add them to the Shoot Board at expected_revision; a board that changed is refused before anything is saved (revision_conflict with the current board).

Parameter	Type	Required	Notes
items	array	yes	Photos to save, each with its confirmed kind
expected_revision	integer	yes	Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Move a Shoot Board photo between the Clothing, Models and Locations piles. Saves the same image as the new kind and swaps it on the board; the old asset is deleted only if intake saved it in the last 24 hours and nothing uses it, otherwise it stays in the library. Asking for a move that already happened changes nothing and returns the board (status "unchanged").

Parameter	Type	Required	Notes
item	object	yes	The board item to move
to	string	yes	The pile to move it to
expected_revision	integer	yes	Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

A Clothing card dropped on another. The photo of from_garment_id becomes the back, side or detail view of garment_id, and from_garment_id leaves the board (deleted only when it is a fresh drop nothing else uses). Or a photo put in the brief's missing-photo slot: image_url instead of from_garment_id, nothing leaves the board. The board's draft brief is saved again when the view changes it. Returns

Parameter	Type	Required	Notes
garment_id	integer	yes	the board garment that gains the photo as a view
from_garment_id	integer	no	the board garment whose photo it is; it leaves the board
view	string	yes	back, side, or detail (a close-up)
image_url	string	no	instead of from_garment_id: the stored photo (host file download URL, or the image_url mcp_upload_intake_photo returned)
expected_revision	integer	yes	Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Store one photo dropped on the Shoot Board, sent inline as base64, for a host that cannot upload files itself. Returns a receipt (sha256, size, stored, image_url, image_url_expires_at); pass image_url to mcp_intake_files and mcp_commit_intake. Without data, stores nothing and returns the receipt of the photo already stored under sha256 (a fresh image_url), or stored: false.

Parameter	Type	Required	Notes
sha256	string	yes	Hex SHA-256 of the dropped file as the user picked it (the intake tools take the same value), even when data is a downscaled copy
content_type	string	no	Image MIME type of data (required with data)
data	string	no	The image bytes, standard base64, at most 4 MiB decoded (downscale larger photos). Omit it to ask for the receipt of a photo already stored

Edit the Shoot Board's brief by hand: add, remove or change looks, or run looks through another automation. Saves a new brief linked to the board and returns the board, the brief, its quote and the credit delta; dry_run only quotes.

Parameter	Type	Required	Notes
brief_id	integer	yes	The board's brief (board.brief_id).
expected_brief_revision	integer	yes	The board's brief_revision shown with the brief.
ops	array	yes	—
dry_run	boolean	no	Quote the edit and its credit delta; save nothing.
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Read one of the account's Shoot Board briefs by brief_id: its looks, automations, credit quote and status. Changes nothing.

Parameter	Type	Required	Notes
brief_id	integer	yes	—
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Generate a Shoot Board brief: publishes its automation drafts, then starts one workflow run per look, charged per run. Spends credits: call it only after the user has seen the brief's looks and credit quote (get_brief) and agreed in chat. Pass the board's brief_revision (read_shoot_board) as expected_brief_revision and a fresh idempotency_key; the same idempotency_key never publishes, runs or char

Parameter	Type	Required	Notes
brief_id	integer	yes	—
expected_brief_revision	integer	yes	The board's brief_revision shown with this brief.
idempotency_key	string	yes	Retry key for one Generate tap: never runs or charges twice.
expected_total_credits	integer	no	The quote's total_credits the user saw.
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Every look's run of a generating brief (brief_id), or runs by id (workflow_run_ids, each with the look its cards held): status, results by step, credits.

Parameter	Type	Required	Notes
brief_id	integer	no	—
workflow_run_ids	array	no	—
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

An automation's past runs, newest first: one row per Shoot Board Generate (its looks) or per run started on Uwear, with when, how it went, credits and covers.

Parameter	Type	Required	Notes
workflow_id	string	yes	—
page	integer	no	—
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

The account's Shoot Board briefs, newest first: every brief that ran (on any Shoot Board) and this board's draft, each with its status, looks, automations, credits and covers.

Parameter	Type	Required	Notes
page	integer	no	—
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

The company's shoot automations (and other automations to copy).

Parameter	Type	Required	Notes
include_automations	boolean	no	Also list automations (read/copy only).
query	string	no	Name search.
page	integer	no	—
items_per_page	integer	no	—
include_definitions	boolean	no	Also return each listed automation's live graph (the cards that draw its steps).
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Open the brief's automation in the builder: its draft, or once Generate published it its live version (saving an edit of it makes a new automation); another automation opens read-only.

Parameter	Type	Required	Notes
workflow_id	string	yes	—
version_id	string	no	The published version to show (an automation, or read_only); a brief recipe opened to edit always opens its draft.
read_only	boolean	no	Show a published version (version_id, else the live one) without opening a draft: a brief that ran shows what it ran, the board's pinned Automation its live version.
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Validate and price the automation being edited.

Parameter	Type	Required	Notes
workflow_id	string	yes	—
version_id	string	yes	—
graph	object	yes	The unsaved authoring graph (as the builder holds it).
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Save the automation's draft.

Parameter	Type	Required	Notes
workflow_id	string	yes	—
version_id	string	no	—
expected_definition_hash	string	no	—
contract_version	string	no	—
failure_policy	string	no	—
result_projection	array	no	—
nodes	array	yes	—
edges	array	yes	—
base_version_id	string	no	—
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

Copy an automation as a new automation for this shoot.

Parameter	Type	Required	Notes
source_workflow_id	string	yes	—
source_version_id	string	no	—
name	string	no	—
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

The automation builder reads library items (Clothing, Models, Locations, ...) of one kind by id to show them on its cards. Read-only.

Parameter	Type	Required	Notes
kind	string	yes	—
ids	array	yes	—
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

The automation builder's picker: one page of the user's library items of one kind, filtered by search text, tags or category. Read-only.

Parameter	Type	Required	Notes
kind	string	yes	—
query	string	no	—
page	integer	no	—
page_size	integer	no	—
tag_ids	array	no	—
categories	array	no	—
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

The account's tags, for the automation builder's tag filters. Read-only.

Parameter	Type	Required	Notes
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

The garment categories, for the automation builder's category filters. Read-only.

Parameter	Type	Required	Notes
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

The camera views (front, side, back, crops) a shot or camera edit can use, for the automation builder. Read-only.

Parameter	Type	Required	Notes
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

The automation format (step kinds and their settings) the automation builder edits against. Read-only.

Parameter	Type	Required	Notes
contract_version	string	no	—
board_id	string	yes	The open Shoot Board's board_id, from Open Shoot Board or your context.

One generation result as GET /generation-result/{id} returns it (tags, review verdict, QA, prompt, model), for the widget's result viewer.

Parameter	Type	Required	Notes
generation_result_id	integer	yes	—

One generation with its results as GET /generation/{id} returns it (prompt, model, settings, inputs), for the result viewer's Info panel.

Parameter	Type	Required	Notes
generation_id	integer	yes	—

The result viewer's review rail. Sets the user's verdict on their own results to approved or rejected, or clears it (decision null), replacing any verdict they had; deletes nothing and spends no credits.

Parameter	Type	Required	Notes
generation_result_ids	array	yes	—
decision	string/null	yes	—
note	string/null	no	—

Save a still frame of a video result as a new image result, as POST /generation-result/{id}/extract-frame. The result viewer's Save frame.

Parameter	Type	Required	Notes
generation_result_id	integer	yes	—
timestamp_seconds	number/null	no	Frame time in seconds; omit for the last frame.

Replace a result's tags with tag_ids (empty removes all), as PUT /generation-result/{id}/tags. The result viewer's tag tray. A tag that starts one of the user's automations starts it, as on the platform.

Parameter	Type	Required	Notes
generation_result_id	integer	yes	—
tag_ids	array	yes	—

Rename or recolor one of the company's tags, as PATCH /tag/{id}. The result viewer's tag tray.

Parameter	Type	Required	Notes
tag_id	integer	yes	—
name	string/null	no	—
color	string/null	no	—

Delete the user's results and their stored images, as the platform's Delete. Cannot be undone: call it only after the user confirmed in chat which results to delete.

Parameter	Type	Required	Notes
generation_result_ids	array	yes	—

The active AI models with their capabilities and pricing rules, as GET /models returns them, for the widget's model pickers.

No parameter schema on file.

Read the user's saved photoshoot defaults (aspect ratio, camera, resolution) with every allowed value. Backs the plugin settings page.

No parameter schema on file.

Save changed photoshoot defaults (aspect ratio, camera, resolution). Send only the settings that changed; returns every current value. Defaults never authorize a paid generation.

Parameter	Type	Required	Notes
set	object	yes	—

Where are you running it?

Tool surface

Release history

Uwear MCP

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

Release history

See also