Meshy
Meshy provides generative 3D, image, motion, animation, model-processing, and Creative Lab APIs.
Verdict
Common use cases
- Generate game props from concept art
- Prototype product packaging in 3D
- Rig and animate character models
- Split models into printable parts
- Convert assets to Unity or Unreal formats
Integration
- Vendor
- Meshy
- Category
- other
- Auth
- API_KEY
- Tools
- 27
- Composio slug
meshy
Tools
- Cancel Creative Lab Task
Cancel a Creative Lab task only while it is PENDING or IN_PROGRESS. Terminal task history is retained. Canceling a PENDING task refunds its credits; canceling an IN_PROGRESS task does not refund credits.
- Create Animation Task
Start a 3-credit task that applies either a selected library animation or a succeeded Text to Motion clip to a completed rigging task and return the animation task ID.
- Create Auto Split Task
Split a succeeded untextured Meshy 6 or Meshy 7 model into separately printable parts and return the task ID. An accepted task costs 10 credits; failed tasks are refunded, as is a task deleted while still pending.
- Create Collapsible Fidget Task
Start an entitled 6-credit task that generates a collapsible fidget directly from an image and return the task ID.
- Create Convert Task
Start a 1-credit task that converts a model into one or more requested formats; returns the task ID.
- Create Creative Lab Build
Start a 3D build from a succeeded matching Creative Lab prototype. Lamp builds cost 6 credits, keycap builds cost 50, and all other builds cost 30. The call returns a build task ID.
- Create Creative Lab Prototype
Start an entitled image-to-prototype task for a fixed Creative Lab product. Lamp prototypes cost 30 credits, keycap prototypes cost 12, and all other prototypes cost 6. The task ID can be passed to the matching build operation.
- Create Image to 3D Task
Start a 3D generation task from one to four views of one object or a prior task's input images. One image uses single-image generation and two to four use multi-image generation. Meshy-6/7 cost 20 credits without texture, 30 with texture, o
- Create Image to Image Task
Start a credit-consuming task that edits or restyles one to five reference images from a text instruction. The task costs 3 to 12 credits depending on the model and returns a task ID for status checks.
- Create Multi-Color Print Task
Start a 10-credit task that converts a GLB or FBX model from a prior Meshy task or direct URL into a limited-color 3MF for 3D printing, and return the task ID. When both sources are provided, input_task_id takes precedence.
- Create Print Analysis Task
Start a free task that analyzes a GLB, GLTF, OBJ, FBX, or STL model from a prior Meshy task or direct URL for printability defects and return the task ID. When both sources are provided, input_task_id takes precedence.
- Create Print Repair Task
Start a 10-credit task that repairs a GLB, GLTF, OBJ, FBX, or STL model from a prior Meshy task or direct URL for 3D printing and return the task ID. When both sources are provided, input_task_id takes precedence. The repaired asset retains
- Create Remesh Task
Start a 5-credit task that remeshes a model to the requested topology and polygon count, optionally resizes it, and exports the remeshed result in the requested formats. Use CREATE_CONVERT_TASK for format conversion without remeshing. Retur
- Create Resize Task
Start a 1-credit task that scales a model by height, longest side, or automatic sizing and return the task ID.
- Create Retexture Task
Start a credit-consuming task that applies one text, image, or multiview style source to an existing 3D model. The task costs 10 credits at 2k or 4k resolution and 15 credits at 8k, and returns a task ID for status checks.
- Create Rigging Task
Start a 5-credit task that rigs a GLB character with a biped or quadruped skeleton and return the task ID. Models above 300,000 faces must be remeshed first.
- Create Text to 3D Task
Start a new Text to 3D preview or fused geometry-and-texture task and return its task ID. Preview costs 20 credits for Meshy 6/7, 5 credits for Meshy T2 or other models, and Ultra adds 5 credits; fused generation costs 30 credits for Meshy
- Create Text to Image Task
Start a credit-consuming 2D image generation task from a text prompt. The task costs 3 to 9 credits depending on the model and returns a task ID for status checks.
- Create Text to Motion Task
Start an entitled motion-generation task from a text prompt and return its task ID. Prime mode costs 10 credits and the completed task produces FBX; swift mode costs 3 credits and the completed task produces BVH.
- Create UV Unwrap Task
Start a 5-credit task that generates UV coordinates for a GLB model and return the task ID. High-poly models may need to be remeshed first.
- Delete Taskdestructive
Permanently delete a GA or Text-to-Motion task and its retained outputs. Creative Lab tasks cannot be deleted with this action; use CANCEL_CREATIVE_LAB_TASK for an active Creative Lab task.
- Get Credit Balance
Return the connected Meshy account's available credit balance before starting paid generation tasks.
- Get Task
Retrieve current status, errors, and available outputs for one task from a selected Meshy task family. This read does not consume credits.
- List Animation Library
Search or filter Meshy's unpaginated animation catalog and return action IDs for use when creating animation tasks.
- List Tasks
Return one page of tasks for one selected Meshy task family, with an opaque cursor for safe continuation. This read does not consume credits.
- List Usage Records
Return one page of terminal API-task usage and consumed credits for the connected Meshy team. This endpoint is available only to Studio and Enterprise team API keys. Pass next_cursor alone to continue the same filtered export; split exports
- Refine Text to 3D Task
Apply texture to a succeeded Text to 3D preview and return the new refine task ID. Refinement costs 10 credits at 2k or 4k texture resolution and 15 credits at 8k.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the MCP Integrations panel. 2. Click 'Add Integration' and select Meshy from the list. 3. Open Meshy's dashboard in a new tab, sign in, and generate an API key under Account → API Keys. 4. Copy the key and paste it into Switchy's API Key field, then click 'Connect'. 5. Switchy will validate the key and confirm the connection. 6. Inside any Project, type '@Meshy' to see available tools in the autocomplete menu. 7. Test the connection by asking '@Meshy create a 3D model from this image' and attach a photo — you'll receive a task ID. 8. Wait 30-90 seconds, then ask '@Meshy check the status of task [ID]' to see if the model is ready. 9. Once succeeded, request the download URL and save the GLB or FBX file to your workspace.
What teammates see: by default, memories from Meshy are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Image to Game Asset
@Meshy create a 3D model from this image using Meshy-7 with PBR textures. Once done, convert it to FBX format.
Text to Textured Prop
@Meshy generate a medieval wooden barrel with iron bands and weathered texture. Use Meshy-7 and deliver as GLB.
Rig and Animate Character
@Meshy rig the model from task [ID], then apply a 'walking forward' animation from the library and export the result.
Prep Model for Printing
@Meshy auto-split the model from task [ID] into printable parts and provide download links for each STL file.
Batch Format Conversion
@Meshy convert task [ID] to FBX, OBJ, and USDZ formats and return all three download URLs.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Meshy generate a 3D model from this product photo using Meshy-7, then convert the result to GLTF and STL formats for our web viewer and 3D printing.
Started image-to-3D task (ID: img3d_abc123) using Meshy-7 single-image generation — estimated 20 credits. Once complete, I'll queue a conversion task for GLTF and STL exports (1 credit each). You'll receive download links for all three files when processing finishes, typically within 5–10 minutes depending on queue depth.
This example chains two API calls: image-to-3D generation (20 credits for Meshy-7) followed by format conversion (1 credit per format). Meshy requires an API key with sufficient credit balance. Tasks run asynchronously; the MCP polls status but cannot guarantee completion time during high-traffic periods.
@Meshy check the status of my last three 3D generation tasks and cancel any that are still pending to preserve credits for this new batch.
Retrieved your three most recent tasks: img3d_abc123 (SUCCEEDED, 2 min ago), img3d_def456 (IN_PROGRESS, 40% complete), img3d_ghi789 (PENDING). Canceled img3d_ghi789 and refunded its 20 credits. Task img3d_def456 is too far along to refund if canceled now, so I left it running.
Demonstrates read-heavy status checking plus conditional write action. Canceling PENDING tasks refunds credits; canceling IN_PROGRESS tasks does not. The MCP respects Meshy's credit economy but cannot predict when an in-progress task will finish — users should monitor costs if running many parallel generations.
@Meshy review all my completed Creative Lab lamp prototypes from the past week and recommend which one would work best as a minimalist desk lamp based on geometry complexity.
Found four succeeded lamp prototypes in your history. Prototype clp_xyz001 (created 3 days ago) has the simplest geometry: 8,200 triangles, single curved surface, no undercuts. Prototypes clp_xyz002 and clp_xyz003 exceed 15k triangles with intricate lattice patterns that may complicate printing. I'd recommend building clp_xyz001 — it costs 6 credits to generate the final lamp model and should print cleanly on most FDM printers.
This synthesis example pairs Meshy's task history API with the AI's reasoning to filter and rank results. Creative Lab workflows (lamps, keycaps, fidgets) require entitled access and consume fixed credit amounts per product type. The MCP cannot preview 3D geometry directly; recommendations rely on metadata like triangle count and task success status.
Use-case deep-dives
When Meshy beats manual 3D modeling for catalog expansion
A 6-person e-commerce team needs 40 new product renders for a seasonal catalog launch in three weeks. Their designer can model two assets per day in Blender; Meshy's image-to-3D pipeline turns product photos into textured models in under an hour. The team uploads reference shots, runs the 20-credit Meshy-7 task, then pipes outputs into their existing render farm. The break-even is around 15 models—below that, manual modeling is cheaper; above it, Meshy's batch throughput wins. The 27-tool API surface (convert, auto-split, animation) means you can script the entire pipeline without leaving Switchy. If your catalog refresh is under 10 SKUs or you need sub-millimeter CAD precision, stick with traditional modeling. For mid-volume product visualization where speed trumps perfect topology, Meshy cuts two weeks off the timeline.
How a 3-person game team uses Meshy for rapid iteration
An indie studio prototyping a puzzle game needs 30 prop variations to test level flow before committing to final art. Their solo 3D artist would spend six weeks modeling and rigging; Meshy's image-to-3D plus rigging-to-animation chain delivers playable placeholders in three days. The team sketches concepts in Figma, runs them through the multi-image generation tool (20 credits each), applies library animations (3 credits), and drops the FBX exports into Unity. The credit math matters: 30 models at 20 credits plus 10 animations is 690 credits, roughly $70—cheaper than a week of contractor time. The auto-split tool is overkill here unless they're 3D-printing physical prototypes. If your game needs hero assets with custom topology, Meshy won't replace your modeler. For throwaway iteration where silhouette and motion matter more than edge loops, it's the fastest path from concept to playtest.
When Meshy's Creative Lab beats stock 3D libraries
A 5-person marketing team launching a smart-home product needs branded lamp renders for six ad variants. Stock 3D sites have generic lamps; commissioning custom models takes two weeks and $1,200. Meshy's Creative Lab prototype-to-build flow costs 36 credits per lamp (prototype plus build) and delivers in 48 hours. The team uploads the product's industrial design renders, runs the lamp prototype task, tweaks the output in the Creative Lab UI, then triggers the build. Six lamps at 36 credits is 216 credits, under $25. The catch: Creative Lab is locked to specific product types (lamps, keycaps, fidgets), so if your campaign needs abstract sculptures or furniture, you're back to the generic image-to-3D tools. For teams running repeated campaigns around a fixed product category, the Creative Lab's entitled workflows and predictable credit costs beat both stock libraries and freelance modelers on speed and budget.
Frequently asked
What does the Meshy MCP do in Switchy?
It lets your team generate 3D models from text or images, animate rigged models, convert formats, and build Creative Lab products like lamps or keycaps — all without leaving Switchy's chat interface. You can start tasks, check status, and retrieve final assets using natural language instead of navigating Meshy's web UI or writing API calls.
Do I need a paid Meshy account to use this MCP?
Yes. The MCP authenticates with an API key from your Meshy account, and every task it runs consumes credits from your Meshy balance. Image-to-3D tasks cost 20 credits for Meshy 6 or 7, animations cost 3, and Creative Lab builds range from 6 to 50 credits depending on the product type.
Can the Meshy MCP edit an existing 3D model?
No. It generates new models from scratch using text prompts or images, converts completed models to different file formats, or applies animations to rigged models. If you need to modify geometry or textures on an existing mesh, you'll still need Blender or another 3D editor.
Why use the MCP instead of Meshy's web dashboard?
The MCP is faster when you're already working in Switchy and want to kick off a batch of generations or check task status without context-switching. It's also easier to script repetitive workflows — like converting ten models to GLB — by chaining tool calls in a single conversation.
Who on my team should connect the Meshy MCP?
Whoever owns your Meshy API key and manages the credit budget. Because every task the MCP runs charges your Meshy account, you probably want one person to connect it and share the workspace with teammates who need to generate models, rather than giving everyone their own key.