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
fix(mcp-studio): take the em-dashes out of the tool and widget copy
nirholasdc8856f57896
diff --git a/api/_mcp-studio/component.js b/api/_mcp-studio/component.jsindex 0df5decbe..87774daf7 100644--- a/api/_mcp-studio/component.js+++ b/api/_mcp-studio/component.js@@ -279,7 +279,7 @@ export const COMPONENT_HTML = `<!doctype html>show(loading);mv.classList.remove('fading');mv.classList.add('veiled');- // The forge paints a concept image before sculpting the mesh — use it as+ // The forge paints a concept image before sculpting the mesh, so use it as// the model-viewer poster so the user sees the painted reference the// instant the widget renders, while the GLB is still streaming in.if (isHttps(out.referenceImageUrl)) { mv.setAttribute('poster', out.referenceImageUrl); }diff --git a/api/_mcp-studio/dispatch.js b/api/_mcp-studio/dispatch.jsindex b9cff3ca4..c01a0ed2b 100644--- a/api/_mcp-studio/dispatch.js+++ b/api/_mcp-studio/dispatch.js@@ -36,7 +36,7 @@ export const PROTOCOL_VERSION = '2025-06-18';const SERVER_INFO = { name: 'three-ws-3d-studio-free', version: '1.0.0' };const INSTRUCTIONS = [- 'three.ws 3D Studio turns a text prompt or an image into an interactive, downloadable 3D model (GLB) — free.',+ 'three.ws 3D Studio turns a text prompt or an image into an interactive, downloadable 3D model (GLB), free.','forge_free(prompt) generates a model from text; text_to_avatar and mesh_forge generate an avatar or art-directed','mesh from text or a reference image; rig_mesh(glb_url) makes a static model animation-ready; forge_avatar does','generate + rig in one step. Each result includes a glbUrl and a viewerUrl and renders inline in a 3D viewer widget.',@@ -61,7 +61,7 @@ function widgetResources() {mimeType: COMPONENT_MIME,text: COMPONENT_HTML,_meta: {- 'openai/widgetDescription': 'Interactive 3D viewer for a generated model — rotate, view, and download the GLB.',+ 'openai/widgetDescription': 'Interactive 3D viewer for a generated model: rotate, view, and download the GLB.','openai/widgetCSP': componentCsp(),'openai/widgetDomain': 'https://three.ws','openai/widgetPrefersBorder': true,diff --git a/api/_mcp-studio/persona-tools.js b/api/_mcp-studio/persona-tools.jsindex cb8716653..1675cf3e8 100644--- a/api/_mcp-studio/persona-tools.js+++ b/api/_mcp-studio/persona-tools.js@@ -94,7 +94,7 @@ async function guardWrite(req) {// ── handlers ──────────────────────────────────────────────────────────────────async function handleCreatePersona(args, _auth, req) {- if (!(await guardWrite(req))) return toolError('Too many requests — slow down and try again shortly.');+ if (!(await guardWrite(req))) return toolError('Too many requests. Slow down and try again shortly.');const glbUrl = String(args.glb_url || '').trim();const name = String(args.name || '').trim();if (!name) return toolError('Provide a display name for the agent (1–80 characters).');@@ -133,8 +133,8 @@ async function handleCreatePersona(args, _auth, req) {`Saved "${persona.name}" as a living persona.\n` +`Persona ID: ${persona.persona_id}\n` +(persona.look?.rigged- ? 'Rig: humanoid — full body animation + lip-sync.\n'- : 'Rig: static/non-humanoid — falls back to a gentle idle gracefully.\n') ++ ? 'Rig: humanoid, full body animation + lip-sync.\n'+ : 'Rig: static/non-humanoid, falls back to a gentle idle gracefully.\n') +'Show the attached view to see the body. Call persona_say with this persona_id to make it ' +'speak a reply, or get_agent_persona to bring it back in a future session.',},@@ -167,7 +167,7 @@ async function handleGetPersona(args) {}async function handlePersonaSay(args, _auth, req) {- if (!(await guardWrite(req))) return toolError('Too many requests — slow down and try again shortly.');+ if (!(await guardWrite(req))) return toolError('Too many requests. Slow down and try again shortly.');const id = String(args.persona_id || '').trim();const text = String(args.text || '').trim();if (!isPersonaId(id)) return toolError('That is not a valid persona id.');@@ -189,7 +189,7 @@ async function handlePersonaSay(args, _auth, req) {text:`${persona.name} says it with a ${expr.emotion} expression` +(expr.gesture ? ` and a ${expr.gesture} gesture` : '') +- '. Show the attached view — the body lip-syncs the reply and emotes.',+ '. Show the attached view: the body lip-syncs the reply and emotes.',},embodimentArtifact({persona,@@ -247,11 +247,11 @@ const DEFS = [name: 'create_agent_persona',title: 'Save a rigged model as a living, persistent agent body',description:- 'Turn a generated GLB into a NAMED, persistent agent body — a "persona" the assistant reuses across ' ++ '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 ' ++ '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.',inputSchema: {type: 'object',@@ -272,7 +272,7 @@ const DEFS = [name: 'get_agent_persona',title: 'Reload a persona by id (continuity across sessions)',description:- 'Bring back a previously saved persona by its persona_id — the SAME body and identity, in a fresh ' ++ '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.',inputSchema: {@@ -294,14 +294,14 @@ const DEFS = ['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.',+ 'this turn: show it alongside the reply. This is the turn-by-turn embodiment hook.',inputSchema: {type: 'object',additionalProperties: false,required: ['persona_id', 'text'],properties: {persona_id: { type: 'string', minLength: 8, maxLength: 64, description: 'The persona to speak through.' },- text: { type: 'string', minLength: 1, maxLength: 2000, description: 'The reply text the agent is saying this turn — drives lip-sync and emotion.' },+ text: { type: 'string', minLength: 1, maxLength: 2000, description: 'The reply text the agent is saying this turn: drives lip-sync and emotion.' },emotion: { type: 'string', enum: ['neutral', 'joy', 'sad', 'angry', 'surprised', 'thinking'], description: 'Optional explicit emotion override; omit to auto-detect from the text.' },},},diff --git a/api/_mcp-studio/tools.js b/api/_mcp-studio/tools.jsindex dae509d2b..1f7e42ef6 100644--- a/api/_mcp-studio/tools.js+++ b/api/_mcp-studio/tools.js@@ -522,7 +522,7 @@ async function handleForgeAvatar(args, _auth, req) {}if (prompt && !imageUrl && args.allow_non_humanoid !== true && looksNonHumanoid(prompt)) {return toolError(- 'That looks like an object rather than a character. Auto-rigging needs a humanoid figure — use the 3D mesh generator for objects, or set allow_non_humanoid to override.',+ 'That looks like an object rather than a character. Auto-rigging needs a humanoid figure. Use the 3D mesh generator for objects, or set allow_non_humanoid to override.',);}try {@@ -823,7 +823,7 @@ const DEFS = [name: 'forge_free',title: 'Generate a 3D model from text',description:- 'Turn a text prompt into a textured, downloadable 3D model (GLB) — free. Describe a single object, ' ++ '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.',@@ -909,7 +909,7 @@ const DEFS = [name: 'forge_avatar',title: 'Generate a rigged, animation-ready avatar',description:- 'Generate a rigged, animation-ready 3D avatar (GLB) from a single text prompt or a reference image — ' ++ '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.',@@ -930,11 +930,11 @@ const DEFS = [name: 'refine_model',title: 'Refine a 3D model by describing a change',description:- 'Iterate on a model you already generated — just describe the change in words ("make it metallic", ' ++ '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 — the returned lineage drives a version strip in ' ++ '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.',inputSchema: {type: 'object',@@ -951,7 +951,7 @@ const DEFS = [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.',+ description: 'Optional: the prompt that produced the model being refined, so the change builds on it instead of starting over.',},reference_image_url: {type: 'string',@@ -960,13 +960,13 @@ const DEFS = [},parent_lineage: {type: 'array',- description: 'Optional — the lineage array from a previous refine_model result, to extend the same version history.',+ description: 'Optional: the lineage array from a previous refine_model result, to extend the same version history.',items: { type: 'object', additionalProperties: true },},parent_index: {type: 'integer',minimum: 0,- description: 'Optional — branch off an earlier version in parent_lineage (its index) instead of the latest.',+ description: 'Optional: branch off an earlier version in parent_lineage (its index) instead of the latest.',},},},