Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs(mcp-studio): count fifteen tools now that get_job ships, and document its annotations
nirholas6e442e1def39
diff --git a/api/_mcp-studio/dispatch.js b/api/_mcp-studio/dispatch.jsindex 5334a9616..c34f97b0f 100644--- a/api/_mcp-studio/dispatch.js+++ b/api/_mcp-studio/dispatch.js@@ -113,7 +113,7 @@ const PERSONA_INSTRUCTIONS = [// examples, and any MCP host that renders the inline living body,// plus the free asset catalog tools (./catalog-tools.js), the only// place a keyless MCP client can reach them.-// chatgpt /api/mcp-chatgpt: the eight tools in ./tools.js and the+// chatgpt /api/mcp-chatgpt: the nine tools in ./tools.js and the// model-viewer widget only. The persona widget frames the hosted// embodiment page, which requires frameDomains, and OpenAI's app// guidelines reserve frame domains for embedding an essentialdiff --git a/docs/mcp-studio.md b/docs/mcp-studio.mdindex 345d76541..26c6d4c85 100644--- a/docs/mcp-studio.md+++ b/docs/mcp-studio.md@@ -29,9 +29,9 @@ generation quota:| URL | Serves | Use it for ||---|---|---|-| `https://three.ws/api/mcp-studio` | all fourteen tools (the 3D tools, the asset catalog, the persona tools), both widgets | any MCP host, including a ChatGPT developer-mode connector |+| `https://three.ws/api/mcp-studio` | all fifteen tools (the 3D tools, the asset catalog, the persona tools), both widgets | any MCP host, including a ChatGPT developer-mode connector || `https://three.ws/api/mcp-chatgpt` | the nine 3D tools and the model viewer | the ChatGPT plugin directory listing |-| `https://three.ws/api/mcp-grok` | all fourteen tools, every call answered within 40 s, quota per MCP session | Grok Bot, Grok connectors and the xAI Responses API ([guide](./grok.md)) |+| `https://three.ws/api/mcp-grok` | all fifteen tools, every call answered within 40 s, quota per MCP session | Grok Bot, Grok connectors and the xAI Responses API ([guide](./grok.md)) |The ChatGPT surface leaves out the three catalog tools, which keeps that listing's reviewed tool set unchanged, and the three persona tools, because their widgetframes the hosted embodiment page, which needs `frameDomains`. OpenAI's app@@ -77,18 +77,18 @@ launcher, living avatars, link unfurls) is documented end to end in## Tools-`tools/list` returns exactly **fourteen** tools, and they split five ways:+`tools/list` returns exactly **fifteen** tools, and they split five ways:- **Six generation tools** (`forge_free`, `text_to_avatar`, `mesh_forge`,`rig_mesh`, `forge_avatar`, `refine_model`), in the table below.-- **One collector**, `check_job`, also in the table below.+- **Two collectors**, `check_job` and `get_job`, also in the table below.- **One inspector**, `look_at_model`, also in the table below.- **Three asset catalog reads** (`search_catalog`, `get_catalog_item`,`get_item_source`), in **Ready-made assets** below.- **Three persona/embodiment tools** (`create_agent_persona`,`get_agent_persona`, `persona_say`), in the **Embodiment** section further down.-All fourteen are free and keyless.+All fifteen are free and keyless.The six generation tools run operator-funded on the platform's own generationpipeline. Annotations: `readOnlyHint:false`, `destructiveHint:false`,@@ -100,6 +100,8 @@ the creation, copying the model into our storage, recording the row and runningthe quality gate, and it can route failed work to another provider. Later checksof the same job are served from the done-frame cache, which is exactly why it isnot idempotent either. It still never counts against the generation quota.+`get_job` carries the same annotations, because its first look at a finished job+saves the model in the same way.`look_at_model` is genuinely read-only and idempotent,but it renders frames server-side, so it rides the same per-IP generationquota as the six generators.@@ -112,7 +114,7 @@ quota as the six generators.| `rig_mesh` | Rig a 3D model for animation | `glb_url` | rigged GLB || `forge_avatar` | Generate a rigged, animation-ready avatar | `prompt?` / `image_url?`, `allow_non_humanoid?` | rigged GLB avatar || `refine_model` | Refine a 3D model by describing a change | `glb_url`, `instruction`, `parent_prompt?`, `parent_lineage?`, `parent_index?` | refined GLB + version lineage |-| `check_job` | Check a pending 3D generation and collect it | `job_id` | GLB model, or an updated pending state |+| `check_job` | Check a pending 3D generation | `job_id` | GLB model, or an updated pending state || `get_job` | Get the status of a 3D job | `job_id` | `status`, `progress`, `eta_seconds`, asset links when done, error and remedy when failed || `look_at_model` | Look at a 3D model | `glb_url`, `views?` (up to 6 of `front`, `three-quarter`, `side`, `back`, `top`, `bottom`; default three-quarter, front, side, back), `size?` (128 to 1024 px, default 512) | rendered frames as images, plus geometry stats (triangles, materials, textures) and a plain reading of them |diff --git a/public/features.json b/public/features.jsonindex fd2e22c4a..b344b496f 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-09T16:56:49.136Z",+ "generated_at": "2026-10-09T17:21:05.029Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",diff --git a/tests/mcp-studio.test.js b/tests/mcp-studio.test.jsindex e03bb553b..5aecf804e 100644--- a/tests/mcp-studio.test.js+++ b/tests/mcp-studio.test.js@@ -13,7 +13,7 @@ import { MODEL_VIEWER_CDN_ORIGIN } from '../api/_lib/model-viewer-cdn.js';// look_at_model (renders frames of an existing model). (also get_job, its machine-readable twin). PERSONA adds the three// embodiment tools from api/_mcp-studio/persona-tools.js (which render the// living-body embed). CATALOG adds the three free asset catalog reads-// (api/_mcp-studio/catalog-tools.js) on the full surface only, for the fourteen+// (api/_mcp-studio/catalog-tools.js) on the full surface only, for the fifteen// /api/mcp-studio advertises in total.const ALLOWED = ['forge_free', 'text_to_avatar', 'mesh_forge', 'rig_mesh', 'forge_avatar', 'refine_model', 'check_job', 'get_job', 'look_at_model'];const PERSONA = ['create_agent_persona', 'get_agent_persona', 'persona_say'];