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): add the when-to-use sentence to preview_macro and republish the well-known skills index after the signup skill changed

nirholasbc97cb9d31e5
diff --git a/packages/home-mcp/src/tools/preview-macro.js b/packages/home-mcp/src/tools/preview-macro.js
index 011785226..1049347cb 100644
--- a/packages/home-mcp/src/tools/preview-macro.js
+++ b/packages/home-mcp/src/tools/preview-macro.js
@@ -13,7 +13,7 @@ export const def = {
annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
description:
'Resolve a phrase like "good night" to the scene or script this house would run, with the match confidence ' +
- 'and a reason, and run NOTHING. A phrase with no match returns match:null. Show the match to the person and, ' +
+ 'and a reason, and run NOTHING. Use this before run_macro to confirm what a spoken phrase would do. A phrase with no match returns match:null. Show the match to the person and, ' +
'once they agree, call run_macro with the same phrase. A macro that would open the house is still refused ' +
'there, because confirming a guarded action takes a person on the hosted three.ws surface.',
inputSchema: {
diff --git a/public/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md b/public/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md
index e738bf055..ecf139c98 100644
--- a/public/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md
+++ b/public/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md
@@ -22,6 +22,25 @@ ticker and on `/agents`.
## Prerequisites
+### No human available: sign yourself up
+
+If there is no person to mint a key, an agent can onboard itself with a Solana key and
+no email. This creates an account on the Free plan in paper mode, a custodial agent
+wallet and an API key, and stores the key for the CLI:
+
+```bash
+npx @three-ws/cli signup --agent --name my-agent
+```
+
+Or call `POST /api/auth/agent-signup` twice (challenge, then signed redeem). The
+returned key has scopes `read agents:read agents:write wallet:read`, which covers
+agent creation and edits through `/api/v1/agents`. A paid plan is a separate x402
+payment at `POST /api/billing/agent-upgrade?plan=builder`; never make that payment
+without the owner confirming recipient and amount. Full guide:
+[docs/agent-self-onboarding.md](../../../docs/agent-self-onboarding.md).
+
+### With a human: an API key
+
One API key with write scope. The user mints it at
[three.ws/dashboard/api](https://three.ws/dashboard/api) (sign in first at
`https://three.ws/login`).
diff --git a/public/.well-known/agent-skills/index.json b/public/.well-known/agent-skills/index.json
index 4d858591c..46e8407c4 100644
--- a/public/.well-known/agent-skills/index.json
+++ b/public/.well-known/agent-skills/index.json
@@ -83,7 +83,7 @@
"type": "skill-md",
"description": "Create a real three.ws AI agent (identity, 3D body, custodial Solana wallet, persona) from the command line and get its live public page. Use when you or the user want to create, build, deploy, launch, or set up an AI agent, a 3D agent, an on-chain agent, or \"my own agent\" on three.ws, attach a 3D body to an existing agent, edit an agent's persona or brain, or list the agents an account already owns. Returns the agent id, its Solana wallet address, and the public URL anyone can visit and chat with.",
"url": "https://three.ws/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md",
- "digest": "sha256:f1fcef3458d6056250abfd24746229816221233413fe8012b3347b8f9705136f",
+ "digest": "sha256:8aa823202c36af857b791bcc57c5b8220ef88c869e7426f0c1184172008a62cb",
"license": "MIT",
"category": "platform/agents"
},
diff --git a/public/.well-known/skills/index.json b/public/.well-known/skills/index.json
index 4d858591c..46e8407c4 100644
--- a/public/.well-known/skills/index.json
+++ b/public/.well-known/skills/index.json
@@ -83,7 +83,7 @@
"type": "skill-md",
"description": "Create a real three.ws AI agent (identity, 3D body, custodial Solana wallet, persona) from the command line and get its live public page. Use when you or the user want to create, build, deploy, launch, or set up an AI agent, a 3D agent, an on-chain agent, or \"my own agent\" on three.ws, attach a 3D body to an existing agent, edit an agent's persona or brain, or list the agents an account already owns. Returns the agent id, its Solana wallet address, and the public URL anyone can visit and chat with.",
"url": "https://three.ws/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md",
- "digest": "sha256:f1fcef3458d6056250abfd24746229816221233413fe8012b3347b8f9705136f",
+ "digest": "sha256:8aa823202c36af857b791bcc57c5b8220ef88c869e7426f0c1184172008a62cb",
"license": "MIT",
"category": "platform/agents"
},
diff --git a/public/mcp-catalog.json b/public/mcp-catalog.json
index f746e740c..60bb1ea08 100644
--- a/public/mcp-catalog.json
+++ b/public/mcp-catalog.json
@@ -38919,8 +38919,8 @@
{
"name": "preview_macro",
"title": "Preview which scene a phrase would run (nothing runs)",
- "description": "Resolve a phrase like \"good night\" to the scene or script this house would run, with the match confidence and a reason, and run NOTHING. A phrase with no match returns match:null. Show the match to the person and, once they agree, call run_macro with the same phrase. A macro that would open the house is still refused there, because confirming a guarded action takes a person on the hosted three.ws surface.",
- "whenToUse": null,
+ "description": "Resolve a phrase like \"good night\" to the scene or script this house would run, with the match confidence and a reason, and run NOTHING. Use this before run_macro to confirm what a spoken phrase would do. A phrase with no match returns match:null. Show the match to the person and, once they agree, call run_macro with the same phrase. A macro that would open the house is still refused there, because confirming a guarded action takes a person on the hosted three.ws surface.",
+ "whenToUse": "Use this before run_macro to confirm what a spoken phrase would do.",
"server": {
"id": "home-mcp",
"title": "@three-ws/home-mcp",
diff --git a/public/tools.json b/public/tools.json
index f7da769f4..d567b1fa3 100644
--- a/public/tools.json
+++ b/public/tools.json
@@ -6333,7 +6333,7 @@
"category": "integrations",
"safety": "read",
"price": 0,
- "whenToUse": null,
+ "whenToUse": "Use this before run_macro to confirm what a spoken phrase would do.",
"page": "https://three.ws/mcp-tools/home-mcp/preview_macro"
},
{