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.

Documentation