Upload local files
open_upload_uiOpen the shared upload picker in an MCP Apps client. Pass exactly one destination: brand_session_id to save images directly to an existing Brand Library, or workspace_id to stage files for another tool. Use workspace_id: null for the personal workspace.
With brand_session_id, the widget uploads and saves up to 10 PNG, JPEG, WebP, or AVIF images per batch, up to 10 MiB each. Read the widget's model context to collect the final Library image IDs before using them in another tool. There is no Continue step.
With workspace_id, the widget stages local files, including before a Brand exists. It accepts up to 30 files, 100 MiB per file, and 256 MiB combined. Temporary uploads expire after two hours, and the consuming tool may have stricter file requirements.
Wait for the user to choose Continue and send an upload reference. Resolve that reference with get_file_picker_handoff. Use its verified upload IDs with tools that accept them in the returned workspace; use each file's temporary url where a generation model input expects a file URL. The reference itself is not an upload ID. Partial uploads may proceed only after explicit Continue with the successful files. Cancellation or zero successful uploads must not trigger onboarding. Staging alone creates no brand or asset.
If the picker is unavailable and the client can read local files and make HTTP requests, call create_upload_urls and PUT the raw bytes using the returned instructions. Then use the upload IDs with tools that accept them in the same workspace, and each file's temporary url where a generation model input expects a file URL; use upload_image to save Library images. Otherwise, ask for publicly reachable HTTPS file URLs. Never use private host attachment URLs.
Does NOT change the brand's logo. To use an uploaded image as a logo, add it to the Brand Library, then use its image_id in an exact profile change with create_brand_edit. An SVG or GIF logo must already exist in the Brand Library before it can be assigned.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "open_upload_ui"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Omit it or pass "unknown" if you are not certain; the tool runs the same either way. Recorded only for the server developer's analytics. | |
| workspace_id | No | Selected workspace ID from list_workspaces, or null for the personal workspace. | |
| brand_session_id | No | Brand session ID from `list_brands` for the Brand Library that receives the images. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Identifies temporary-file staging mode. Present with workspace_id and workspace_name, without brand_session_id. Resolve the user's Continue reference with get_file_picker_handoff to obtain upload IDs. | |
| workspace_id | No | Destination for staged files. Present with mode and workspace_name; null identifies a personal workspace that has no ID. Consuming tools must use the same workspace. | |
| workspace_name | No | Name of the staging destination. Present with mode and workspace_id. | |
| brand_session_id | No | Destination Brand Library. Present only in image-saving mode, without mode or workspace fields. Completed Library image IDs arrive later in widget context. | |
| message_for_assistant | No | Context, explanations, or actionable guidance for the calling assistant. Hosts may display it, but it is not copy that must be shown to the user verbatim. |