Rainbrand

Delete one or more existing image assets that the user can access, including Brand Library images. Use image IDs, not selected-model generation-job IDs. The images stop appearing in image list, search, and read results. Re-deleting an already-deleted image is a no-op. Only call this when the user has explicitly asked to delete specific images. For bulk cleanup, first list the candidates with list_images and confirm the exact set with the user. deleted_count may be lower than the number of IDs passed: images the user cannot delete, or that were already deleted, are skipped rather than erroring. Args: - image_ids (string[]): Image IDs to delete (1–50), from list_images or generation outputs' media IDs. Do not pass the job IDs returned by generate_image. Returns: { "deleted_count": number, "message_for_assistant"?: string }

delete_images

Permanently delete audio files by media ID. Only call after the user explicitly asks; this cannot be undone. IDs that are not audio files are skipped.

delete_audio

Permanently delete videos by media ID. Only call after the user explicitly asks; this cannot be undone. IDs that are not videos are skipped.

delete_videos

End a brand edit without changing the active brand. Discarded edits cannot publish a candidate. Cancellation is requested for ongoing preparation, but work already in progress may finish.

discard_brand_edit

Submit a speech generation request through Rainbrand’s public API. Use a supported audio model returned by list_models and follow its published input schema from get_model. Use relevant brand context to write the text to speak. Inspect the result with get_generation.

generate_audio

Submit an image generation request through Rainbrand’s public API. Use a supported image model returned by list_models and follow its published input schema from get_model. Create or use a task-specific Brief for the brand identified by brand_session_id, wait for completion, and inspect it. For supported models, pass brief_id alongside the model input; Rainbrand supplies guidance and references while the prompt remains authoritative for content and exact copy. Without brief_id, include relevant brand guidance and references in the model input. Retrieve and inspect outputs with get_generation, then request a Review when useful.

generate_image

Submit a video generation request through Rainbrand’s public API. Use a supported video model returned by list_models and follow its published input schema from get_model. Retrieve and inspect outputs with get_generation.

generate_video

Get a brand's status, profile, guidance, and files. Read any file with view_files. Set wait to true to wait for current brand initialization. A version_id read returns that exact immutable version immediately, even if it is currently the latest. If the result is still analyzing, repeat the same read with wait: true. Use profile.logo_catalog to select among supported logos for the selected version. Follow exact caller selection and relevant Brand Skill guidance before contrasts_best_on visibility hints; use the primary logo as a general fallback. Null means no catalog was published, while an empty items array records no supported logos. Pass the same version_id when refreshing temporary asset URLs to retain the selected version.

get_brand

Read a brand edit's progress, requested input, or prepared candidate. Set wait to true to wait while its status is preparing; if the result is still preparing, repeat the same read with wait: true. On supported MCP clients, this call may accept native input and resume preparation when the question and response can be represented completely. Otherwise use continue_brand_edit. Resuming does not change the active brand.

get_brand_edit

Read an image from the Brand Library by ID.

get_image

Read one audio file by media ID, including its stable link.

get_audio

Get a brief's status and, once completed, its guidance and assets. Set wait to true to wait until it completes or fails, up to the timeout. If the result is still pending or processing, repeat the same call with wait: true. After the JSON, each image asset has a resource link to the same URL, followed by the image when it fits the size limit. Only the brief's creator can read it.

get_brief

Read a generation's status, outputs, or failure details. Completed results include all output files in provider order.

get_generation

Return the published input schema for a supported model in Rainbrand’s public API. Follow its field names, limits, and accepted reference formats when constructing generation input.

get_model

Get a review's status and, once completed, a verdict, note, and evidence pictures for each requested check. Set wait to true to wait until it completes or fails, up to the timeout. If the result is still pending or processing, repeat the same call with wait: true. After the JSON, each evidence picture has a resource link to the same URL, followed by the picture when it fits the size limit. Only the review's creator can read it.

get_review

Resolve an upload reference from the file picker’s Continue message to the verified files and their workspace. Use the returned upload_id values with tools that accept them in that workspace; use each file's temporary url where a generation model input expects a file URL. The reference itself is not an upload_id. Resolving files does not create or change a brand or add assets to a Brand Library.

get_file_picker_handoff

Read one video file by media ID, including its stable link.

get_video

List saved versions of a brand, including which version is latest.

list_brand_versions

List brands you can access, including their Brand session IDs, names, statuses, and workspaces.

list_brands

List Brand Library images with pagination and filters, or read known image_ids together. For images that are pending or generating: image_url is absent.

list_images

List the files in a Brand Library, most recently added first. Each item has a media ID, a stable link, and a description when one exists.

list_library

List workspaces the caller can access. The personal workspace (is_personal: true) is listed first. Pass a workspace_id from this list to target a specific workspace. check_credits requires one; create tools such as onboard_brand may default to the personal workspace when their own docs say workspace_id is optional. Args: (none) Returns: { "workspaces": [ { "workspace_id": string | null, "workspace_name": string, "is_personal": boolean, "pricing_version": number } ] } The caller's personal workspace (auto-created at signup) is listed first and tagged "is_personal": true.

list_workspaces

List audio files across your brands, newest first: generated outputs and files added to a Brand Library. Each has a media ID and a stable link.

list_audio

List your past generations, newest first, with each output's media ID and link. Outputs deleted since stay listed with available false. Use get_generation for a generation that is still running.

list_generations

List supported generation models in Rainbrand’s public API. Filter by output type or search query.

list_models

List videos across your brands, newest first: generated outputs and files added to a Brand Library. Each has a media ID and a stable link.

list_videos

Create or onboard a brand from user-selected website, Instagram, or file sources. This starts asynchronous Brand Skill creation in the selected workspace and stores supplied files in private brand storage. If a website or Instagram source matches an existing brand, the tool returns that match instead unless the user explicitly allows a duplicate.

onboard_brand

Reserve temporary uploads for the Rainbrand image-picker widget.

create_image_picker_uploads

Reserve temporary upload URLs for files selected in the upload picker. Use the picker’s workspace and each file’s exact byte length. Upload the raw bytes before verifying completion.

create_file_picker_uploads

Verify the selected uploads and save them under a short upload reference for the picker’s explicit Continue action. The agent resolves that reference with get_file_picker_handoff to retrieve the exact upload IDs and workspace. Publishing the reference does not create or change a brand or add assets to a Brand Library.

publish_file_picker_handoff

Read paginated changed Markdown from a prepared brand edit candidate. Each present side identifies its immutable base or candidate Skill and includes the SHA-256 of the complete file. Follow pagination to read the full content. Available only after a candidate exists.

get_brand_edit_file

Take a file out of a Brand Library without deleting it. Future Briefs, Brand Edits, and Brand Skill versions stop using it; published Brand Skills keep working. Only call when the user asks.

remove_from_library

Search public Rainbrand documentation for API integration and MCP usage. Returns matching content, page URLs, and metadata. Follow message_for_assistant to fetch relevant full pages as Markdown.

search_docs

Find Brand Library images by visual meaning. Search for the pictured subject. In select mode, wait for the user's choice or skip; use display mode only when the choice is delegated. Empty results mean no relevant matches were found.

search_user_images

Report observations that could help improve Rainbrand: bugs or errors, surprises, limitations, workflow friction, misleading documentation, missing capabilities, or disappointing or degraded results. You do not need to establish the root cause when the observation concerns Rainbrand. Report each distinct issue once. Do not report failures wholly unrelated to Rainbrand. Leave out credentials, personal or customer data, transcripts, source files, private prompts, and unrelated task context. Reports are internal product feedback and do not open a support conversation. Continue the original task whether submission succeeds or fails.

submit_feedback

Stage a single-use custom font for a brand edit. Returns font_asset_id, family, format, weight, variable, and expires_at. The asset expires after 24 hours, and the consuming edit must finish preparing before expires_at. The asset is deleted when the candidate is stored, preparation fails, or the work becomes stale. Upload it again for a later edit. Pass either a public TTF, OTF, WOFF, or WOFF2 URL, or a completed temporary upload. For a local file, first call `create_upload_urls`, PUT the raw bytes as directed, and pass the resulting `upload_id` here. Staging does not change the active brand. To use the uploaded font, pass its font_asset_id and exact returned family in an exact profile typography change with create_brand_edit. Family matching is case-sensitive after trimming. Pass exactly one of `font_url` or `upload_id`. Args: - `brand_session_id` (string): Brand session ID from `list_brands`. - `font_url` (string, optional): Public font URL, max 5MB. - `upload_id` (string, optional): Completed temporary upload ID.

upload_brand_font

Save one image in a Brand Library from either a public URL or a completed temporary upload. The server validates the image, then reuses an exact match in the brand or stores a new one. If your client can read the local file and make HTTP requests, first call `create_upload_urls`, PUT the raw bytes as directed, and pass the resulting `upload_id` here. In an MCP Apps client, call `open_upload_ui` with only `brand_session_id` instead; its widget completes the Library upload and returns final image IDs in widget context. Read that context before using the images. Pass exactly one of `image_url` or `upload_id`. Args: - `image_url` (string, optional): Public PNG, JPEG, WebP, or AVIF URL. - `upload_id` (string, optional): Completed temporary upload ID. - `brand_session_id` (string): Brand session ID that owns the Library image. Returns the final image ID for generation references, edit references, edit subjects, or a Brand Skill primary-logo update. Supported formats: PNG, JPEG, WebP, AVIF. Max file size: 10MB.

upload_image

Open 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. The widget completes the Library upload; 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. Public logo replacement is not supported for older Visual DNA brands.

open_upload_ui

Verify that the selected workspace’s temporary uploads are complete and unexpired before returning them to the agent. Verification does not create or change a brand or add files to a Brand Library.

verify_file_picker_uploads

View brand text, images, and font files. Viewing a font file also returns its font specimen, when one exists.

view_files