three.ws 3D Studio (free)
by nirholas · remote · no sign-in to list tools · v1.0.1 · published by GitHub user nirholas
Free text/image → 3D: generate, rig, avatar-ify, and refine GLB models. No auth, no payment.
15 tools: 11 change things and 4 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things11Claude Code: ask: see these tools
- Only reads4Claude Code: allow: see these tools
1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http threews-3d-studio-free https://three.ws/api/mcp-studioFindings
Matches of fixed checks, with the text they matched.
- Warnget_job
The server marks "get_job" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "get_job" says "get": a word for reading.
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
15 tools
Changes things 11Claude Code: ask
check_jobCheck on a 3D generation that returned status "pending" and collect the finished model.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it 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. Use this when the user is waiting to see the finished model; for quiet polling on a schedule call get_job instead.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
create_agent_personaTurn a generated GLB into a NAMED, persistent agent body: a "persona" the assistant reuses across turns and across sessions.No findings
Why it is in this group
- The name "create_agent_persona" says "create": a word for a change.
Description, as the server wrote it 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. Use this once a rigged model should become a recurring character the assistant speaks through. No sign-in required.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
forge_avatarGenerate a rigged, animation-ready 3D avatar (GLB) from a single text prompt or a reference image, in one step.No findings
Why it is in this group
- The description's first verb is "generate": a word for a change.
Description, as the server wrote it 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. Use this when the user wants a character they can pose or animate.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
forge_freeTurn a text prompt into a textured, downloadable 3D model (GLB), free.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it 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. Use this for a single object or creature from text; for a posable character call forge_avatar, and to change a model you already made call refine_model.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
get_jobMachine-readable status of a generation that returned "pending".1 finding
Why it is in this group
- The name "get_job" says "get": a word for reading.
- The server marks it as not read-only (readOnlyHint: false).
Findings
- Warn
The server marks "get_job" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The name "get_job" says "get": a word for reading.
Description, as the server wrote it Machine-readable status of a generation that returned "pending". Returns status (queued, running, done, failed, not_found), progress (0 to 1, null when unknown), eta_seconds, and next_check_seconds while it runs; the asset links (viewer_url, glb_url, poster_png_url, embed_html) when done; and a plain error with a remedy when it failed. Safe to call on a schedule: it never starts work and is not counted against the generation quota. Use this to poll a pending job from code or a loop; call check_job with the same job_id when you want the finished model rendered in the inline viewer.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
look_at_modelFREE.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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 to check your own work right after generating: 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
mesh_forgeGenerate a textured 3D mesh (GLB) from a text prompt or a reference image URL.No findings
Why it is in this group
- The description's first verb is "generate": a word for a change.
Description, as the server wrote it 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. Use this for a single object or prop when mesh quality matters most; for characters call text_to_avatar or forge_avatar.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
persona_sayMake a persona PERFORM a reply: the body lip-syncs the text and shows the matching facial expression and body gesture.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it 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. Use this whenever the persona speaks, on every turn, with the persona_id from create_agent_persona or get_agent_persona.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
refine_modelIterate on a model you already generated: just describe the change in words ("make it metallic", "bigger helmet", "add wings").No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it 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. Use this instead of a fresh generation when the user wants to change a model they already have.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
rig_meshAuto-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.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it 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. Use this when you already have a static model; to generate and rig a character in one step call forge_avatar instead.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
text_to_avatarGenerate a textured 3D avatar (GLB) from a text description or a reference image URL.No findings
Why it is in this group
- The description's first verb is "generate": a word for a change.
Description, as the server wrote it 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. Use this for a character that only needs to be viewed; when it must be posed or animated call forge_avatar instead.
Annotations the server declares
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
Only reads 4Claude Code: allow
get_agent_personaBring back a previously saved persona by its persona_id: the SAME body and identity, in a fresh session.No findings
Why it is in this group
- The name "get_agent_persona" says "get": a word for reading.
Description, as the server wrote it 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 when a conversation starts and the user returns to a named agent.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_catalog_itemFree, no account needed.No findings
Why it is in this group
- The name "get_catalog_item" says "get": a word for reading.
Description, as the server wrote it Free, no account needed. Read one three.ws catalog item in full by its id from search_catalog (for example "object:adjustable_wrench"): metadata, license, CDN urls, the site links that preview or edit it, related items of the same kind, and which source frameworks get_item_source can emit for it. Use this after search_catalog to inspect one result before you embed it; for paste-ready code call get_item_source instead.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_item_sourceFree, no account needed.No findings
Why it is in this group
- The name "get_item_source" says "get": a word for reading.
Description, as the server wrote it Free, no account needed. Returns working code that renders one three.ws catalog item on any site: the <agent-3d> web component (pinned to the exact published version with its SRI hash), the <model-viewer> tag our own browse grids use, plain three.js with GLTFLoader, or a React component. Motion clips return three.js code that parses the clip JSON and plays it. Omit `framework` to get the one that fits the item best; pass `all` to get every variant at once. Use this when you are ready to put a catalog item on a page or in an app; call get_catalog_item first if you still need its license or metadata.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
search_catalogFree, no account needed.No findings
Why it is in this group
- The name "search_catalog" says "search": a word for reading.
Description, as the server wrote it Free, no account needed. Search every ready-made asset three.ws publishes in one call: CC0 3D props and objects, rigged humanoid characters, and retargetable motion clips. Returns ids, titles, tags, licenses, and CDN urls, plus category facets to narrow the next query. Use this before generating anything: if the catalog already has the prop or character, dropping it in is instant and free where generating one is not. Feed a returned id to get_item_source for code that renders it on any site.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.0.1. Values in angle brackets are yours to fill in.
claude mcp add --transport http threews-3d-studio-free https://three.ws/api/mcp-studioRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__threews-3d-studio-free__search_catalog",
"mcp__threews-3d-studio-free__get_catalog_item",
"mcp__threews-3d-studio-free__get_item_source",
"mcp__threews-3d-studio-free__get_agent_persona"
],
"ask": [
"mcp__threews-3d-studio-free__forge_free",
"mcp__threews-3d-studio-free__text_to_avatar",
"mcp__threews-3d-studio-free__mesh_forge",
"mcp__threews-3d-studio-free__rig_mesh",
"mcp__threews-3d-studio-free__forge_avatar",
"mcp__threews-3d-studio-free__refine_model",
"mcp__threews-3d-studio-free__check_job",
"mcp__threews-3d-studio-free__get_job",
"mcp__threews-3d-studio-free__look_at_model",
"mcp__threews-3d-studio-free__create_agent_persona",
"mcp__threews-3d-studio-free__persona_say"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as threews-3d-studio-free. Review it before you use it.
