meshy-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@meshy-mcp Generate a 3D model of a vintage leather messenger bag"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
What is this?
meshy-mcp is a Model Context Protocol server that connects Claude to the Meshy AI 3D generation API.
Once connected to Claude Desktop (or any MCP client), you can say:
"Generate a 3D model of a vintage leather messenger bag" "Turn this product photo into a 3D model" "Apply a carbon fiber texture to this model" "Build me a 3D showroom environment for my clothing brand"
…and Claude will call Meshy, poll until the model is ready, and hand you back download links for GLB, FBX, OBJ, and USDZ files — all without leaving the conversation.
Related MCP server: Meshy MCP Server
Quick Start
1. Get a Meshy API key
Sign up at app.meshy.ai → Settings → API Keys → Generate Key.
2. Add to Claude Desktop
Open your config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"meshy-3d": {
"command": "npx",
"args": ["-y", "meshy-mcp"],
"env": {
"MESHY_API_KEY": "msy_your_key_here"
}
}
}
}Restart Claude Desktop. Done — Claude now has 3D generation tools.
See docs/setup.md for custom MCP clients, running from source, and troubleshooting.
Tools
Six tools are exposed to Claude:
Tool | What it does |
| Text → 3D model (GLB, FBX, OBJ, USDZ) |
| Upgrade preview to production quality with PBR textures |
| Image URL → 3D model |
| Apply AI-generated textures + PBR maps to any model |
| Poll status of any running task |
| List recently generated models |
Full parameter reference: docs/tools.md
Demo prompts
Paste any of these into Claude after connecting meshy-mcp:
Generate a 3D model of a puffer jacket with a reflective quilted surface, realistic style, quad topology.Turn this image into a 3D model and apply a woven denim texture: https://example.com/jacket.jpgGenerate a minimalist luxury showroom environment — white walls, concrete floor, warm spotlights — for a clothing brand website.Generate a low-poly voxel sneaker for a game. Target 5000 polygons.Create a 3D wristwatch model, then refine it to production quality with PBR textures.Use Cases
3D product visualization
Turn product descriptions or photos into 3D assets for e-commerce, AR try-on, and marketing. Works for fashion, furniture, electronics, and more.
3D website environments
Generate scene props and environments, export GLB files, and embed them with Three.js or Babylon.js. Build interactive 3D landing pages, virtual showrooms, and immersive brand experiences — all by describing them to Claude.
Print-on-demand & clothing brands
Generate photorealistic garment mockups, brand kit 3D assets, and complete lookbook scenes. Use alongside ThreadForge for the full clothing brand workflow.
Game & metaverse assets
Generate props, characters, and environment pieces with game-ready topology. Export FBX for Unreal Engine or Unity.
AR & spatial computing
USDZ output works with Apple AR Quick Look and visionOS. Generate and share AR-viewable 3D models directly from Claude.
How Meshy built a $20M+ business on this API
Meshy is not just a tool — it's one of the most well-engineered AI data flywheels in the 3D space. Understanding how they built it changes how you think about using and building on top of their API.
The short version:
The 4-variant limit per generation is not a cost-saving measure — it's a training data architecture decision
Every model you pick over the others is a free preference signal (RLHF without asking)
The free tier exists to collect data, not out of generosity
After millions of generations, Meshy holds a
(prompt → accepted output)dataset that no competitor can buyEvery developer who builds on the API (like this repo) extends their distribution for free
Read the full breakdown: docs/how-meshy-built-a-3d-ai-empire.md
Covers: the technical stack, the data flywheel, the Midjourney parallel, pricing power risk, self-hosting alternatives, and the exact blueprint for replicating this in any vertical.
Architecture
meshy-mcp/
├── src/
│ ├── index.ts # Entry point
│ ├── server.ts # MCP server + tool router
│ ├── meshy/
│ │ ├── client.ts # Meshy REST API client
│ │ ├── types.ts # Full TypeScript type definitions
│ │ └── poller.ts # Async task completion poller
│ ├── tools/
│ │ ├── text-to-3d.ts # generate_3d_model
│ │ ├── refine-3d.ts # refine_3d_model
│ │ ├── image-to-3d.ts # generate_3d_from_image
│ │ ├── texture.ts # add_texture
│ │ └── status.ts # check_task_status + list_3d_models
│ └── utils/
│ └── format.ts # Markdown output formatters
├── docs/ # Setup + tool reference
├── examples/ # Claude Desktop config + prompt walkthroughs
├── CLAUDE.md # AI agent context (for Claude Code)
└── .env.exampleProtocol: stdio MCP (compatible with Claude Desktop, Cursor, Zed, and any MCP client)
Language: TypeScript 5, ESM, Node.js 20+
Dependencies: @modelcontextprotocol/sdk, zod — nothing else
Environment Variables
Variable | Required | Default | Description |
| ✅ | — | From app.meshy.ai → Settings → API Keys |
| — |
| Override API base URL |
| — |
| Max wait per task |
| — |
| Polling frequency |
Contributing
Fork → create a branch →
npm run typecheckbefore committingNew tool? Follow the pattern in any existing file in
src/tools/Open a PR — see CLAUDE.md for the full contributor guide
Related
Meshy AI — the 3D generation API powering this server
Model Context Protocol — the open protocol for Claude tool use
ThreadForge — clothing brand mockup platform (pairs well with meshy-mcp)
Claude Desktop — the MCP client used in examples
How Meshy Built a $20M+ 3D AI Business — deep dive into the data flywheel, training strategy, and business model
License
Keywords: MCP server 3D generation · Claude 3D model tool · Meshy AI MCP · text to 3D Claude · image to 3D AI · 3D environment generator · Claude Desktop MCP · AI 3D design tool · model context protocol 3D · Meshy API integration · AI texture generation · GLB FBX generator · Three.js asset generation · 3D website environment AI · anthropic tool use 3D
Available Tools
6 toolsadd_textureB
Apply AI-generated textures to an existing 3D model using Meshy AI.
Takes a GLB or OBJ model URL and generates: • Base color map • Metallic map • Roughness map • Normal map (for surface detail without extra polygons)
Returns a fully textured GLB/FBX ready for Three.js, Babylon.js, Unity, Unreal Engine, or Blender.
Use cases: • Apply brand-specific textures to clothing 3D models • Add realistic material finishes (leather, fabric, metal, wood) • Generate texture variants for A/B testing product visuals • Style website 3D environments with custom looks
Inputs: model_url (required), object_prompt (required), style_prompt, negative_prompt, +5 more.
check_task_statusA
Check the status and progress of any Meshy generation task.
Returns current status (PENDING, IN_PROGRESS, SUCCEEDED, FAILED), progress percentage, and download links once complete.
Use this when you started a task with wait_for_completion: false, or to check on a previously started generation.
Inputs: task_id (required), task_type (required).
generate_3d_from_imageA
Turn any image into a 3D model using Meshy AI.
Best inputs: • Product photos (sneakers, bags, furniture, clothing items) • Objects on white or clean backgrounds • Front-facing or 3/4-view photos • Logos or illustrations to extrude into 3D
Returns GLB, FBX, OBJ, and USDZ download links with optional PBR textures.
Use cases: • Turn a clothing brand's product photo into a 3D asset • Generate 3D models from design mockups or sketches • Convert reference images into scene props
Inputs: image_url (required), enable_pbr, ai_model, topology, +3 more.
generate_3d_modelA
Generate a 3D model from a text description using Meshy AI.
Returns download links for GLB, FBX, OBJ, and USDZ formats, plus a thumbnail and turntable video preview.
Use cases: • Product 3D assets for e-commerce or AR • Game and scene props • Architectural models • Fashion and clothing items • Characters and creatures
After generating a preview, call refine_3d_model for production-quality output, or add_texture to apply custom textures.
Inputs: prompt (required), art_style, negative_prompt, ai_model, +4 more.
list_3d_modelsA
List your recently generated 3D models from Meshy.
Returns task IDs, prompts, statuses, and download links for your most recent text-to-3D generations.
Inputs: limit.
refine_3d_modelA
Refine a preview 3D model to production quality using Meshy AI.
Run this after generate_3d_model to get: • Higher polygon detail • PBR texture maps (base color, metallic, roughness, normal) • Production-ready GLB/FBX/OBJ files suitable for Unreal Engine, Unity, Blender, Three.js, or AR
Requires a completed preview task ID from generate_3d_model.
Inputs: preview_task_id (required), texture_richness, enable_pbr, wait_for_completion.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: generation from text vs image, refinement, texturing, status checking, and listing. No two tools overlap in functionality, reducing the risk of misselection.
All tool names follow a consistent verb_noun pattern with underscores (e.g., generate_3d_model, add_texture). The naming is predictable and uniform across the entire set.
With 6 tools, the surface is well-scoped for a 3D generation service, covering the core workflow (generate, refine, texture) plus necessary management tools (list, check status).
The tool set covers the primary generation and texturing workflow, but lacks a delete or update operation for models, and there's no upload tool for custom models (only URL-based). These are minor gaps that agents can work around.
Maintenance
Related MCP Connectors
Turn a photo, drawing or text description into a textured 3D model (GLB, FBX, OBJ, USDZ, STL).
Generate 3D models from images or text with AI, then retexture or convert them to STL, 3MF or OBJ.
Turn text or an image into an animation-ready 3D model (GLB): generate, rig, animate, retexture.
Generate 3D models, worlds, PBR materials, and coordinated asset packs from AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with the Tripo3D AI API to generate 3D models from text, images, or multiview inputs. It supports advanced features like model animation, stylization, and real-time task status tracking.7ISC
- AlicenseAqualityDmaintenanceEnables AI assistants to generate 3D models, textures, and images via the Meshy API using natural language, supporting text-to-3D, image-to-3D, remeshing, retexturing, rigging, and animation workflows.3631 npm1MIT
- AlicenseCqualityDmaintenanceWraps the Meshy AI API to enable generative 3D tools via Model Context Protocol, allowing creation of 3D models, textures, animations, and more from text or images.5157 npm43MIT
- AlicenseNot gradedqualityDmaintenanceEnables to generate 3D models from text and images, apply textures, and remesh models using the Meshy AI API.6MIT