Skip to content

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.

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.js
index 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.js
index 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.js
index 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.js
index 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.',
},
},
},