Tools
Mint MCP exposes three production scopes.
mint:readIdentity, credits, projects, assets.mint:generate:startStart generation, revisions, and derivative actions.mint:generate:approveApprove final generation and fetch durable artifact URLs.
Read
mint:readwho_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, projects, and recent work.
list_studio_projects
Lists your Studio projects so your agent can pick one to add to.
list_my_assets
Lists your worlds, models, asset packs, materials, audio, and Studio projects 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, audio files, or Studio projects.
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.
Generate
mint:generate:start / mint:generate:approveget_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. 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.
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.
Looking for the product workflow behind these tools? Explore Mint's 3D creation Features and Use Cases.