Tools

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.

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.

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, link billing.accountUrl for the required action, 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, link billing.accountUrl for the required action, 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.