Tools

get_modeler_operation

Check an owned Modeler request's progress, delivered model, and Credit settlement. A delivered GLB can be retrieved before billing finishes. Status reads do not include download URLs.

open_mint

Open the Mint plugin's interactive Home when the user asks to open Mint or browse their library. Chat launches prefer inline display, with an Expand action for the full view. Browse owned Projects, packs, models, worlds, and media, or switch to Explore for featured public models, worlds, packs, materials, and starter Projects; add items to chat explicitly from their detail views.

open_world

Open an owned ready world in Mint's interactive Gaussian splat viewer inside Codex. Streams the world's RAD asset without starting generation or spending credits.

open_model_file

Display a host-provided GLB or Gaussian splat file (PLY, SPZ, SPLAT, KSPLAT, SOG, RAD) in Mint using the host resource bridge. The remote server does not read the local filesystem. Splat files must be self-contained.

open_explore_asset

Preview a publicly visible Mint model, world, material, or asset pack using the main app public content permissions. Pack member previews validate public pack membership.

browse_explore

Browse the same curated public feeds as Mint Explore: 3D models, worlds, asset packs, materials, and starter Projects. Browsing does not attach context or change the account.

who_am_i

Tells your agent who's signed in, what they're allowed to do, and how many credits they have.

get_credits_balance

Shows available monthly and Usage Credits plus any balance reserved to finish a workflow.

get_mint_context

Gives your agent a quick overview of your account — credits and recent work.

list_projects

Lists your Mint Projects with archive state, chat counts, recent activity, and active status.

list_my_assets

Lists your worlds, models, asset packs, materials, Images, and audio with Mint handoff links — all in one place.

get_asset

Gets status and the Mint handoff link for one of your worlds, models, asset packs, materials, Images, or audio files.

wait_for_status

Briefly waits for a generation to reach a stage, then returns current status, safe moderation categories when available, and retry guidance. timeout_ms is capped at 60000.

wait_for_many

Briefly waits for up to 25 existing assets together while keeping each asset's outcome independent.

list_asset_artifacts

Lists downloadable artifact choices without exposing direct file URLs.

get_model_animation

Gets normalized status for an animation batch or clip without exposing raw animation files.

wait_for_model_animation

Briefly waits for an animation batch or clip to finish, then returns retry guidance. timeout_ms is capped at 60000.

list_model_animation_artifacts

Lists rigged-character and animation-clip artifacts without exposing direct file URLs.

list_model_animation_sets

Discovers versioned curated animation bundles before starting animation.

list_model_animation_options

Browses the checked-in Meshy animation catalog without starting an animation run.

copy_explore_project

Copy a featured starter Project into the connected account after the user chooses Use project. Retain request_id when retrying a start; use operation_id to check status or retry a failed copy. No generation is started.

create_project

Creates a Project without changing the active Project in the web app.

rename_project

Renames an owned Project.

archive_project

Archives an owned Project when it has no active generation or transfer.

restore_project

Restores an archived Project without changing the active web Project.

start_modeler_generation

Create a static GLB with Modeler. Choose a quality tier and Credit ceiling, and keep the request ID for safe retries. Low reserves 2,000 Credits and charges actual usage up to that amount. Modeler uses your connected account without a Mint chat or Project ID.

revise_modeler_model

Create a new version of an owned successful Modeler model. Keep the original and continue its session. Revisions reserve their chosen tier's price and require a new request ID.

cancel_modeler_operation

Stop an owned Modeler request. Usage already incurred can still be charged, and billing may settle after cancellation. Repeating the cancellation is safe.

open_model

Open an owned final 3D model in the interactive Mint viewer inside Codex. After model generation reaches final, call this tool with the model ID so the user can inspect it. It does not start generation or spend credits.

open_asset

Open an owned video, audio asset, image, or material inside Mint Home. Material Pack members retain their pack access checks. Previewing does not start generation or spend credits; Add to chat is a separate action.

get_asset_artifact_manifest

Returns a ready-to-copy manifest with durable URLs, suggested paths, and loader hints for all downloadable asset artifacts.

get_asset_artifact_manifests

Returns independent code-project manifests for up to 25 existing assets without discarding partial success.

get_asset_artifact

Returns a Mint app link and durable download URL for a chosen artifact.

upload_reference_image

Uploads a reference image you can pass into a model or world generation.

start_world_generation

Starts generating a 3D world from a prompt, with optional reference images.

start_model_generation

Starts generating a 3D model from a prompt, with an optional reference image.

retry_generation

Retries a failed 3D model or world in its existing Mint chat and returns a new successor asset handle.

start_asset_pack_generation

Starts generating a coherent pack of related 3D assets from an explicit item plan.

start_material_generation

Starts standalone PBR material generation or material map extraction.

start_material_pack_generation

Starts generating a group of related PBR Materials from an explicit item plan.

start_image_generation

Start standalone Image generation from a lightweight text prompt, creating a new Mint chat unless chat_id is supplied. project_id is required when chat_id is absent; when both are supplied they must match. This is a final-only exploration capability with no preview approval gate, prompt-guidance workflow, provider/model picker, or required reference image. Show chatUrl as the Open in Mint link and keep assetId for get_asset, wait_for_status, start_image_edit, and artifact follow-up. For code-project imports, follow nextSteps through wait_for_status and get_asset_artifact_manifest. Do not expose raw asset ids unless the user asks. If status is billing_required, generationStarted is false: use billing.userMessage as the core user response, explain the account entitlement or credit shortfall without promoting subscriptions, upgrades, or credit purchases, and present billing.chatUrl as a blocked request that can resume after billing is resolved. Do not call it a failed generation.

start_image_edit

Edit one owned, successfully generated standalone Image using image_id and a plain-language edit_instruction. The original remains unchanged; Mint creates a new immutable Image derivative in the source Image's existing chat. Use the returned assetId for status and artifact follow-up, and sourceAssetId to retain lineage. This is final-only with no preview approval gate or provider/model picker. If status is billing_required, generationStarted is false: use billing.userMessage as the core user response, explain the account entitlement or credit shortfall without promoting subscriptions, upgrades, or credit purchases, and present billing.chatUrl as a blocked request that can resume after billing is resolved. Do not call it a failed generation.

start_audio_generation

Starts final-only playable audio generation for sound effects, UI sounds, ambience, or music.

start_video_generation

Generate a playable clip from a prompt or owned media references.

revise_preview

Tells Mint to revise the current preview based on your feedback. By default, the revised preview continues toward final generation.

revise_asset_pack_preview

Revises all or selected preview items inside an asset pack. By default, revised item previews continue toward final generation.

approve_final_generation

Continues a review-mode preview into final generation.

approve_asset_pack_generation

Continues selected review-mode asset-pack preview items into final 3D model generation.

regenerate_asset_pack_failed_items

Retries failed final items inside a partially completed asset pack.

optimize_generated_model

Starts derivative optimization for a finished generated model or asset-pack items.

retopologize_generated_model

Starts smart topology for one or more finished generated models.

animate_generated_model

Starts rigging and animation for a humanoid-riggable generated model or asset-pack item.

get_model_animation_artifact_manifest

Returns a ready-to-copy manifest with durable URLs, suggested paths, and loader hints for animation artifacts.

get_model_animation_artifact

Returns a Mint app link and durable download URL for a chosen animation artifact.