MCP Server

three.ws 3D Studio (free)

io.github.nirholas/threews-3d-studio-free
Design & Creative Public & reachable MCP 2026-07-28

What this MCP does

Generates, refines, rigs, previews, and animates textured GLB 3D models and persistent character avatars from text or images.

check_job
Check a pending 3D generation
Check on a 3D generation that returned status "pending" and collect the finished model. Pass the job_id from the pending result. While it is still rendering you get updated timing; call again after the suggested wait. Checking can save the completed model and restart failed work on another provider. When it is done the model renders inline in the interactive 3D viewer.
Open world
Input schema
{'type': 'object', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'maxLength': 4096, 'minLength': 8, 'description': 'The job_id (or jobId) a pending generation returned.'}, 'refine': {'type': 'object', 'properties': {'lineage': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'refKind': {'enum': ['text', 'image'], 'type': 'string'}, 'instruction': {'type': 'string', 'maxLength': 500}, 'parentIndex': {'type': 'integer', 'minimum': 0}}, 'description': 'Optional: the refine object a pending refine_model result carried. Pass it back unchanged so the finished model joins that version history.', 'additionalProperties': True}}, 'additionalProperties': False}
create_agent_persona
Save a rigged model as a living, persistent agent body
Turn a generated GLB into a NAMED, persistent agent body: a "persona" the assistant reuses across turns and across sessions. The model is copied into durable storage so the body survives the source URL expiring, then registered under a stable persona_id. The returned view renders the LIVING body inline: it idles between turns, and persona_say makes it lip-sync and emote a reply. The persona_id is the handle: keep it and pass it to get_agent_persona or persona_say later to bring the exact same body back. No sign-in required.
Open world
Input schema
{'type': 'object', 'required': ['glb_url', 'name'], 'properties': {'name': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'A display name for the persona, 1–80 characters.'}, 'voice': {'type': 'string', 'maxLength': 64, 'description': 'Optional voice name to speak with (used for audio-driven lip-sync when available).'}, 'glb_url': {'type': 'string', 'format': 'uri', 'description': 'Public https URL of the rigged GLB to embody (e.g. from forge_avatar).'}, 'source_prompt': {'type': 'string', 'maxLength': 1000, 'description': 'Optional: the prompt that generated this body, kept as provenance.'}}, 'additionalProperties': False}
forge_avatar
Generate a rigged, animation-ready avatar
Generate a rigged, animation-ready 3D avatar (GLB) from a single text prompt or a reference image, in one step. Generates the mesh, then auto-rigs it with a humanoid skeleton so it is ready to pose and animate. Best for characters; objects are steered to the mesh generator. Renders inline in an interactive 3D viewer.
Open world
Input schema
{'type': 'object', 'properties': {'prompt': {'type': 'string', 'maxLength': 1000, 'description': 'Description of the character/avatar to generate.'}, 'image_url': {'type': 'string', 'format': 'uri', 'description': 'Optional http(s) URL to a reference image to reconstruct in 3D.'}, 'allow_non_humanoid': {'type': 'boolean', 'description': 'Set true to rig a non-humanoid subject anyway (rigging assumes a humanoid figure).'}}, 'additionalProperties': False}
forge_free
Generate a 3D model from text
Turn a text prompt into a textured, downloadable 3D model (GLB), free. Describe a single object, character, or creature; the studio generates an interactive model you can rotate, view, and download. Optional quality tier (draft, standard, high); high is slower and may fall back to standard under load. Renders inline in an interactive 3D viewer.
Open world
Input schema
{'type': 'object', 'required': ['prompt'], 'properties': {'tier': {'enum': ['draft', 'standard', 'high'], 'type': 'string', 'description': 'Detail level: draft (fastest), standard (default), or high (best, slower; may fall back to standard under load).'}, 'prompt': {'type': 'string', 'maxLength': 1000, 'minLength': 3, 'description': 'Description of the single object or character to model, e.g. "a friendly round robot mascot, glossy white plastic".'}}, 'additionalProperties': False}
get_agent_persona
Reload a persona by id (continuity across sessions)
Bring back a previously saved persona by its persona_id: the SAME body and identity, in a fresh session. Returns the persona name, its model, the accumulated turn count, and the inline living-body view. Use this at the start of a conversation when the user returns to a named agent.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['persona_id'], 'properties': {'persona_id': {'type': 'string', 'maxLength': 64, 'minLength': 8, 'description': 'The persona_id returned by create_agent_persona.'}}, 'additionalProperties': False}
look_at_model
Look at a 3D model
FREE. See a 3D model instead of just linking to it. Renders the GLB from several angles and returns the frames as images you can actually look at, plus its geometry (triangles, materials, textures) and a plain reading of what those numbers mean. Use it right after generating to check your own work: is the subject complete, is the back finished, is anything melted or fused? Then regenerate naming the fault you saw. Works on any public https .glb, not only ones made here.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['glb_url'], 'properties': {'size': {'type': 'integer', 'maximum': 1024, 'minimum': 128, 'description': 'Pixel size of each square frame. Default 512.'}, 'views': {'type': 'array', 'items': {'enum': ['front', 'three-quarter', 'side', 'back', 'top', 'bottom'], 'type': 'string'}, 'maxItems': 6, 'description': 'Angles to render. Default: three-quarter, front, side, back.'}, 'glb_url': {'type': 'string', 'maxLength': 2048, 'minLength': 12, 'description': 'Public https URL of the .glb to look at.'}}, 'additionalProperties': False}
mesh_forge
Generate a 3D mesh (art-directed)
Generate a textured 3D mesh (GLB) from a text prompt or a reference image URL. In text mode an AI art-director first refines your prompt into an optimized single-subject spec for higher mesh quality. Renders inline in an interactive 3D viewer.
Open world
Input schema
{'type': 'object', 'properties': {'prompt': {'type': 'string', 'maxLength': 1000, 'description': 'Description of the single object to model.'}, 'image_url': {'type': 'string', 'format': 'uri', 'description': 'Optional http(s) URL to a reference image to reconstruct directly.'}}, 'additionalProperties': False}
persona_say
Speak a reply through a persona: lip-sync + emotion + gesture
Make a persona PERFORM a reply: the body lip-syncs the text and shows the matching facial expression and body gesture. Pass the persona_id and the exact text the agent is saying this turn; the emotion is detected from the text automatically (or set it explicitly). The returned view animates the body for this turn: show it alongside the reply. This is the turn-by-turn embodiment hook.
Input schema
{'type': 'object', 'required': ['persona_id', 'text'], 'properties': {'text': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'The reply text the agent is saying this turn: drives lip-sync and emotion.'}, 'emotion': {'enum': ['neutral', 'joy', 'sad', 'angry', 'surprised', 'thinking'], 'type': 'string', 'description': 'Optional explicit emotion override; omit to auto-detect from the text.'}, 'persona_id': {'type': 'string', 'maxLength': 64, 'minLength': 8, 'description': 'The persona to speak through.'}}, 'additionalProperties': False}
refine_model
Refine a 3D model by describing a change
Iterate on a model you already generated: just describe the change in words ("make it metallic", "bigger helmet", "add wings"). The studio re-generates a new version anchored to the previous one, carrying its form and materials forward. Pass the previous model's glb_url and, when you have it, the prompt that made it (parent_prompt) so the change builds on it. Each refinement is recorded as a new version in a lineage you can revert to or branch from, and the returned lineage drives a version strip in the viewer. Renders the new version inline in the interactive 3D viewer.
Open world
Input schema
{'type': 'object', 'required': ['glb_url', 'instruction'], 'properties': {'glb_url': {'type': 'string', 'format': 'uri', 'description': 'http(s) URL of the model to refine (e.g. the glbUrl a previous generation returned).'}, 'instruction': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'The change to make, in plain language: "make it metallic", "bigger helmet", "add a cape".'}, 'parent_index': {'type': 'integer', 'minimum': 0, 'description': 'Optional: branch off an earlier version in parent_lineage (its index) instead of the latest.'}, 'parent_prompt': {'type': 'string', 'maxLength': 1000, 'description': 'Optional: the prompt that produced the model being refined, so the change builds on it instead of starting over.'}, 'parent_lineage': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Optional: the lineage array from a previous refine_model result, to extend the same version history.'}, 'reference_image_url': {'type': 'string', 'format': 'uri', 'description': 'Optional http(s) image of the current model to anchor the re-generation (image→3D). Omit for text-guided refinement.'}}, 'additionalProperties': False}
rig_mesh
Rig a 3D model for animation
Auto-rig a static 3D model (GLB) into an animation-ready model: adds a humanoid skeleton and skin weights so it can be posed and animated. Provide the GLB URL of a model (e.g. one generated by the other tools). Renders the rigged result inline in an interactive 3D viewer.
Open world
Input schema
{'type': 'object', 'required': ['glb_url'], 'properties': {'glb_url': {'type': 'string', 'format': 'uri', 'description': 'http(s) URL to the static GLB mesh to rig.'}}, 'additionalProperties': False}
text_to_avatar
Generate a 3D avatar
Generate a textured 3D avatar (GLB) from a text description or a reference image URL. Best for characters and figures. Renders inline in an interactive 3D viewer.
Open world
Input schema
{'type': 'object', 'properties': {'prompt': {'type': 'string', 'maxLength': 1000, 'description': 'Description of the avatar to generate.'}, 'image_url': {'type': 'string', 'format': 'uri', 'description': 'Optional http(s) URL to a reference image to reconstruct in 3D.'}}, 'additionalProperties': False}
Changed
check_job
Oct. 1, 2026, 2:47 a.m.
Added
persona_say
Sept. 17, 2026, 12:45 p.m.
Added
get_agent_persona
Sept. 17, 2026, 12:45 p.m.
Added
create_agent_persona
Sept. 17, 2026, 12:45 p.m.
Added
look_at_model
Sept. 17, 2026, 12:45 p.m.
Added
check_job
Sept. 17, 2026, 12:45 p.m.
Added
refine_model
Sept. 17, 2026, 12:45 p.m.
Added
forge_avatar
Sept. 17, 2026, 12:45 p.m.
Added
rig_mesh
Sept. 17, 2026, 12:45 p.m.
Added
mesh_forge
Sept. 17, 2026, 12:45 p.m.
Added
text_to_avatar
Sept. 17, 2026, 12:45 p.m.
Added
forge_free
Sept. 17, 2026, 12:45 p.m.