Mint MCP Server
Hosted MCP server that generates 3D models, worlds and materials.
เซิร์ฟเวอร์ MCP แบบโฮสต์
npx add-mcp 'https://mcp.mint.gg/mcp'ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ
เอกสาร
Mint MCP Server for 3D Models, Worlds and Asset Packs
Hosted MCP server at mcp.mint.gg/mcp with OAuth sign-in. Let Claude, Codex or Cursor create 3D models, worlds, asset packs, materials, images, audio and video.
Mint's hosted MCP server lets Claude, Codex, Cursor and other remote MCP clients generate 3D models, explorable worlds, asset packs, PBR materials, images, audio and video in your Mint account, then download the finished files into your project.
Connection
- Streamable HTTP endpoint:
https://mcp.mint.gg/mcp - Authentication: OAuth through the connected MCP client
- Default generation mode: automatic through final generation
What the Mint MCP server can do
Generate 3D models, worlds and media
Start a static GLB with Modeler (beta), a 3D model, an explorable Gaussian splat world, an asset pack from an item plan, a PBR material or material pack, an image or image edit, a sound effect or music track, or a video. Text prompts, uploaded reference images and public image URLs can drive generation.
Tools: start_modeler_generation, start_model_generation, start_world_generation, start_asset_pack_generation, start_material_generation, start_material_pack_generation, start_image_generation, start_image_edit, start_audio_generation, start_video_generation, upload_reference_image
Review, revise and retry
Generation runs through to the final result by default. Ask for review mode to revise or approve previews first, revise a finished Modeler model into a new version, regenerate failed asset-pack items, retry a failed model or world, or cancel a Modeler run.
Tools: revise_preview, revise_asset_pack_preview, approve_final_generation, approve_asset_pack_generation, regenerate_asset_pack_failed_items, retry_generation, revise_modeler_model, cancel_modeler_operation
Optimize, retopologize and animate models
Turn a finished model into a lighter GLB, apply cleaner quad topology, or rig and animate humanoid models with clips from Mint's curated animation sets or a searchable animation catalog.
Tools: optimize_generated_model, retopologize_generated_model, animate_generated_model, list_model_animation_sets, list_model_animation_options, get_model_animation, wait_for_model_animation
Track progress and download files
Wait on one or many generations, read status and previews, then fetch a manifest of durable download URLs with suggested file paths and loader hints for your code project.
Tools: wait_for_status, wait_for_many, get_asset, list_my_assets, get_modeler_operation, list_asset_artifacts, get_asset_artifact_manifest, get_asset_artifact_manifests, get_asset_artifact, list_model_animation_artifacts, get_model_animation_artifact_manifest, get_model_animation_artifact
Projects and account
Check your identity, granted scopes and Credit balance, and create, rename, archive or restore the Projects that hold your work.
Tools: who_am_i, get_credits_balance, get_mint_context, list_projects, create_project, rename_project, archive_project, restore_project
View results inside your client
In clients that support MCP Apps, open Mint Home, browse Explore, copy a starter Project, and inspect models, worlds, images, audio, video, materials and GLB or splat files in interactive viewers.
Tools: open_mint, browse_explore, open_explore_asset, copy_explore_project, open_model, open_world, open_asset, open_model_file
FAQ
How do I connect the Mint MCP server to Claude, Codex or Cursor?
Add https://mcp.mint.gg/mcp as a remote HTTP MCP server. In Codex, run: codex mcp add mint --url https://mcp.mint.gg/mcp. In Claude Code, run: claude mcp add --transport http mint https://mcp.mint.gg/mcp. In Claude Desktop, add it as a remote connector under Settings, Connectors. In Cursor, add it to your MCP settings. Then sign in to Mint when the client opens the OAuth prompt.
Do I need an API key?
No. The Mint MCP server uses OAuth: your client opens a Mint sign-in page and you approve the scopes it may use (mint:projects:write, mint:read, mint:generate:start, mint:generate:approve). Clients can connect and list the tools before you sign in.
What does it cost?
Connecting, signing in, listing tools and viewing assets do not spend Credits. Generation tools use Mint Credits from your account: Mint checks your subscription and Credit balance when a generation tool runs and returns the reason to your agent if it cannot start. Modeler requires beta approval and charges actual usage up to the quality-tier price you authorize.
What do the tools return?
Start tools return the generation status, a link to open it in Mint, and next steps for your agent. Once an asset is final, the artifact tools return durable download URLs with suggested file paths and loader hints, so the agent can save files such as GLB models into your project. Modeler delivers a static GLB with embedded textures.
Can I check previews before final generation?
Yes. Generation runs to the final result by default. Ask your agent for review mode to inspect previews of worlds, models and asset packs, revise them with feedback, and approve the ones to finalize. Modeler, image, audio and video runs go straight to the final result.