Meshy MCP Server

Tools Meshy MCP Server exposes (28)

Listed by the server itself during our scan of commit f7fe59e.

• meshy_text_to_3d

  Generate an untextured 3D PREVIEW from a text prompt; texture it afterwards with meshy_text_to_3d_refine once the user approves. Typically 2–3 minutes. Cost: 20 credits (meshy-7.1 / latest / meshy-6), 5 (meshy-6-lite, meshy-t2, meshy-t2.5); Ultra geometry +5. PREFER THE IMAGE ROUTE: for higher qual

• meshy_image_to_3d

  Generate a 3D model from one image, textured by default (no refine step; should_texture false for a bare mesh). Typically 2–3 minutes. Cost: the mesh (meshy-7.1 / latest / meshy-6 20; meshy-6-lite, meshy-t2, meshy-t2.5 5) + 10 for the texture (15 at 8K), whichever texture_model; Ultra geometry +5.

• meshy_text_to_3d_refine

  Texture a SUCCEEDED meshy_text_to_3d preview. Cost: 10 credits (15 at 8K). Get the user's approval first; omit ai_model to inherit the preview's model. Example: { preview_task_id: "abc-123", texture_prompt: "rusty metal", enable_pbr: true }

• meshy_multi_image_to_3d

  Generate a 3D model from 1–4 views of the same object (better reconstruction), textured by default. Cost: the mesh (meshy-7.1 / latest / meshy-6 20; meshy-6-lite 5) + 10 for the texture (15 at 8K), whichever texture_model; Ultra geometry +5. IMAGE INPUT (exactly ONE): - file_paths: 1–4 local imag

• meshy_get_task_status

  Wait for a task to finish (wait=true, default) or check it once (wait=false). Reports the task's real task_type; pass it to the download and cancel tools. wait=true polls at the API's suggested interval (else 5s→30s backoff) until SUCCEEDED / FAILED / CANCELED or timeout_seconds runs out; a failed

• meshy_list_tasks

  List tasks of any status, newest first by default, merged across the types queried (one request per type). Default: text-to-3d, image-to-3d, multi-image-to-3d, text-to-image and image-to-image; pass task_type / task_types for printing, rigging, animation, motion, post-processing or Creative Lab task

• meshy_cancel_task

  Cancel a queued task, or delete a finished one. What happens depends on the task: Creative Lab tasks (task_type "creative-lab-..."): - PENDING → canceled, credits refunded - IN_PROGRESS → canceled, credits NOT refunded - SUCCEEDED / FAILED / CANCELED → cannot be canceled or deleted, even with

• meshy_download_model

  Save a finished task's output under meshy_output/ (project folders with history), or at save_to. - 3D tasks: ONE model format — ask the user which first (GLB viewing, OBJ white-model printing, 3MF multicolor printing, FBX game engines, USDZ AR, BLEND Blender); never download all. A format exists

• meshy_list_models

  List your finished 3D models (not AI models), newest first, each with its task_id, task_type and formats ready for meshy_download_model. Queries only image-to-3d by default (one request); pass task_types to widen. meshy_list_tasks lists tasks of any status instead, images included.

• meshy_remesh

  Remesh an existing model: change its polygon count or topology. Cost: 5 credits. For a format change only use meshy_convert (1 credit); to scale, meshy_resize (1 credit). Example: { input_task_id: "abc-123", topology: "quad", target_polycount: 10000, target_formats: ["fbx"] }

• meshy_retexture

  Apply new AI textures to an existing model. Cost: 10 credits (15 at 8K). Ask the user for EXACTLY ONE style input (the tool rejects combinations): - text_style_prompt: the style in words ("rusty metal", "cartoon") - image_style_url: one image used as a STYLE reference - multiview_image_urls:

• meshy_rig

  Auto-rig a humanoid character for animation. Cost: 5 credits, including free walking + running animations (GLB + FBX, separate files). REQUIREMENT: a textured humanoid (biped) model with a clear body and limbs, ≤300,000 faces (checked first; remesh if over). model_url must be a .glb facing +Z. Gene

• meshy_animate

  Animate a rigged character (rig_task_id). Cost: 3 credits per action. Give exactly ONE of action_id, action_ids or motion_task_id. meshy_rig already returns walking and running free, as separate files; include their ids in action_ids only to bundle them into one multi-clip file. meshy_download_mode

• meshy_text_to_motion

  Generate a character motion clip (skeleton motion, not a model) from text. Cost: 10 credits (prime) or 3 (swift) — confirm first. Clips are kept for 3 days. Apply it to a rigged biped with meshy_animate (motion_task_id), or save the clip with meshy_download_model (FBX for prime, BVH for swift; form

• meshy_list_animations

  Look up preset animations: the action ids meshy_animate takes. Free. Filters combine; with none the whole (long) library comes back, so prefer search or category. Returns [{ action_id, name, key, category, sub_category, preview_url }]; preview_url is an animated GIF.

• meshy_convert

  Convert a model to other file formats. Cost: 1 credit (cheaper than remesh for a format-only change). Example: { input_task_id: "abc-123", target_formats: ["stl", "3mf"] }

• meshy_resize

  Rescale a model to real-world size on Meshy. Cost: 1 credit. Give exactly one of resize_height, resize_longest_side or auto_size. Later tasks (e.g. Auto Split) use the new size. To only scale a downloaded OBJ for a slicer, meshy_download_model with print_ready + print_height_mm does it locally for

• meshy_uv_unwrap

  Make a clean, non-overlapping UV layout ("UV white model") before texturing in Blender, Substance Painter or Unreal. Cost: 5 credits. GLB input only, ≤40,000 faces (denser meshes are rejected: remesh first). The output GLB keeps the geometry (quads/n-gons triangulated) with fresh UVs and a grey pla

• meshy_text_to_image

  Generate a 2D image from text, e.g. a design for the user to approve before 3D. Typically ~30 s. Cost: nano-banana 3, nano-banana-2 6, nano-banana-2-lite 3, nano-banana-2-1 4, nano-banana-pro 9, GPT Image models 9 credits. To make it 3D: meshy_image_to_3d with input_task_id = this task (multi-view

• meshy_image_to_image

  Edit or restyle images with a text prompt. Cost: nano-banana 3, nano-banana-2 6, nano-banana-2-lite 3, nano-banana-2-1 4, nano-banana-pro 9, GPT Image models 12 credits. Give exactly ONE reference source: input_task_id (all images of an earlier image task), reference_file_paths (local files; never b

• meshy_send_to_slicer

  Detect installed 3D printing slicers and return their launch commands. Call it at the START of a print workflow and keep the result; at the END, replace {file} in a launch_command with the downloaded file's local path and run it. If you cannot run shell commands, give the user the command and the fi

• meshy_analyze_printability

  Check whether a model is printable: watertightness, non-manifold edges, holes, degenerate faces and volume — plus thin walls when printer_type and/or a print size is given (FDM, SLA/resin or full-color). FREE. This is the authoritative answer to "is it printable?". The finished task (task_type "pri

• meshy_repair_printability

  Repair a model for 3D printing (FDM, SLA/resin or full-color): fixes non-manifold edges, degenerate faces and holes and makes it watertight. Cost: 10 credits. Textures are removed (retexture afterwards if needed). Output format: input_task_id → GLB; model_url → the input's format (.stl → STL, .obj

• meshy_process_multicolor

  Turn a textured model into a multi-color 3MF that opens ready to print in the slicer of printer_brand. Cost: 10 credits. Confirm first: max_colors (the printer's AMS/MMU capacity), style, printer_brand, and max_depth (realistic only). Download with format "3mf", then open it with meshy_send_to_slic

• meshy_auto_split

  Cut a model into separately printable parts: when it is too big for the bed, parts need different colors/materials, or it should be assembled. Cost: 10 credits. The texture is not kept. There is no bed-size parameter: cuts follow mode and prompt, not your printer, so resize the model to the print s

• meshy_creative_lab

  Turn a photo (file_path or image_url; no text prompt) into a finished Creative Lab product 3D model, end to end. Products and cost — confirm before calling: - figure (chibi), vinyl-figure, brick-figure, keychain, fridge-magnet, fidget-pixel (pixel-art board of interlocking pieces) → 36 credits (6

• meshy_check_balance

  Check the Meshy credit balance. Free. For team members it is the team's shared pool.

• meshy_list_usage

  List the team's finished API tasks with the credits each consumed, newest first. Free. Use it to break down spend per endpoint or API key. Only for API keys on a Studio or Enterprise team (others get 403). Covers SUCCEEDED and FAILED tasks (FAILED ones are refunded, so they show 0); a task still ru

At a glance

Stars

89

Forks

21

Language

TypeScript

License

MIT

Created

Apr 2026

Last update

Oct 30, 2026

Type

MCP Server

Price

Free

Topics

Questions about Meshy MCP Server

Guides

• How to Install an MCP Server in Claude, Cursor and VS Code
• MCP Server Security: How to Vet a Server Before You Use It
• MCP Tool Poisoning: Malicious Descriptions and Rug Pulls
• Glossary of MCP, skills and agent security terms
• More Design & Media agents, MCP servers & skills