three.ws: Skill for Claude Code

Create a rigged 3D avatar

Turn a text prompt or a reference image into a rigged, animation-ready humanoid avatar (GLB). One call generates the textured mesh, then auto-rigs it (adding a humanoid skeleton and skin weights) so the model can be posed and play animation clips immediately.

The result is a glbUrl for the rigged model plus a pose-studio link that opens the avatar ready to pose in the browser.

When to use which tool

Auto-rigging assumes a humanoid figure. A clearly non-humanoid subject (furniture, vehicle, quadruped) is steered to generate-3d-model instead.

Fastest path: the MCP tool

If the three.ws MCP server is connected, call the one-step avatar tool:

• Tool: forge_avatar
• Input: { "prompt": "<character description>" } or { "image_url": "<https URL to a reference image>" }
  • prompt: describe a single full-body humanoid in a neutral standing pose, for example "a friendly cartoon astronaut in a glossy white suit".
  • image_url: reconstruct and rig a character from a photo/render.
  • allow_non_humanoid: set true only to rig a non-humanoid subject anyway.
• Returns: the rigged glbUrl (or riggedGlbUrl), the intermediate mesh URL, a pose-studio link, and per-stage timing.

For a fast unrigged figure (no skeleton), use text_to_avatar instead: same inputs, mesh only.

Portable path: the hosted HTTP endpoint

No MCP client needed. The free hosted lane is a public JSON-RPC endpoint at https://three.ws/api/mcp-studio:

curl -s -X POST https://three.ws/api/mcp-studio \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "forge_avatar",
      "arguments": { "prompt": "a friendly cartoon astronaut in a glossy white suit" }
    }
  }'