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.

feat(announce): queue the assistant announcement and move four kits into review

ni3a7cdcc607a036
diff --git a/data/announce-media.json b/data/announce-media.json
index d178525ad..29ce73ddb 100644
--- a/data/announce-media.json
+++ b/data/announce-media.json
@@ -153,7 +153,7 @@
"id": "activity-mcp-hero",
"surface": "@three-ws/activity-mcp",
"viewport": "wide",
- "alt": "A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom.",
+ "alt": "A dark title card headed at three-ws slash activity-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming get_trending_agents, get_trending_coins, get_holder_leaderboard, get_tier_info and get_feed_events.",
"caption": "Title card for @three-ws/activity-mcp, typeset from its README and package.json.",
"card": {
"dir": "packages/activity-mcp",
@@ -177,14 +177,14 @@
"id": "knock-hero",
"surface": "/knock",
"url": "/knock",
- "alt": "The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it.",
+ "alt": "The Knock page on three.ws: the headline and its description, three numbered cards reading Set your price, They pay it and You hear it in person, and the signed-out door panel below them.",
"caption": "Captured from the live /knock route for the knock announcement."
},
{
"id": "avatar-mcp-hero",
"surface": "@three-ws/avatar-mcp",
"viewport": "wide",
- "alt": "A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom.",
+ "alt": "A dark title card headed at three-ws slash avatar-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming render_avatar, avatar_embed_code and get_avatar.",
"caption": "Title card for @three-ws/avatar-mcp, typeset from its README and package.json.",
"card": {
"dir": "packages/threews-avatar-mcp",
diff --git a/data/x-content/queue.json b/data/x-content/queue.json
index cafcda5bf..b507169a5 100644
--- a/data/x-content/queue.json
+++ b/data/x-content/queue.json
@@ -1208,7 +1208,7 @@
},
{
"id": "activity-mcp",
- "status": "draft",
+ "status": "review",
"kind": "post",
"tier": 3,
"lane": "developer",
@@ -1224,7 +1224,7 @@
"media": [
{
"path": "public/announce/img/activity-mcp-hero.webp",
- "alt": "A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom."
+ "alt": "A dark title card headed at three-ws slash activity-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming get_trending_agents, get_trending_coins, get_holder_leaderboard, get_tier_info and get_feed_events."
}
]
},
@@ -1259,6 +1259,69 @@
],
"mentions": {}
},
+ {
+ "id": "avatar-mcp",
+ "status": "review",
+ "kind": "post",
+ "tier": 3,
+ "lane": "developer",
+ "pattern": "mechanism",
+ "notBefore": "2026-09-21T04:00:00Z",
+ "source": {
+ "path": "docs/announcements/avatar-mcp.md"
+ },
+ "posts": [
+ {
+ "text": "Ask your assistant for an avatar and it renders in the chat: live, rotatable, idling, with a paste-anywhere embed beside it. npmjs.com/package/@three-ws/avatar-mcp",
+ "textFrom": "docs/announcements/avatar-mcp.post.txt",
+ "media": [
+ {
+ "path": "public/announce/img/avatar-mcp-hero.webp",
+ "alt": "A dark title card headed at three-ws slash avatar-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming render_avatar, avatar_embed_code and get_avatar."
+ }
+ ]
+ },
+ {
+ "text": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat. All three tools are free and read-only."
+ },
+ {
+ "text": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."
+ }
+ ],
+ "claims": [
+ {
+ "says": "All three tools are free and read-only",
+ "evidence": [
+ {
+ "type": "file",
+ "path": "packages/threews-avatar-mcp/README.md",
+ "contains": "All three tools are free, read-only, and annotated (`readOnlyHint`, `idempotentHint`, `openWorldHint`) so hosts can run them without confirmation prompts."
+ }
+ ]
+ },
+ {
+ "says": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat.",
+ "evidence": [
+ {
+ "type": "file",
+ "path": "packages/threews-avatar-mcp/README.md",
+ "contains": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat."
+ }
+ ]
+ },
+ {
+ "says": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere.",
+ "evidence": [
+ {
+ "type": "file",
+ "path": "packages/threews-avatar-mcp/README.md",
+ "contains": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."
+ }
+ ]
+ }
+ ],
+ "mentions": {}
+ },
{
"id": "mocap-studio",
"status": "draft",
@@ -1315,7 +1378,7 @@
},
{
"id": "knock",
- "status": "draft",
+ "status": "review",
"kind": "post",
"tier": 1,
"lane": "token",
@@ -1332,7 +1395,7 @@
"media": [
{
"path": "public/announce/img/knock-hero.webp",
- "alt": "The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it."
+ "alt": "The Knock page on three.ws: the headline and its description, three numbered cards reading Set your price, They pay it and You hear it in person, and the signed-out door panel below them."
}
]
},
@@ -1388,62 +1451,53 @@
"mentions": {}
},
{
- "id": "avatar-mcp",
+ "id": "assistant",
"status": "draft",
"kind": "post",
- "tier": 3,
+ "tier": 2,
"lane": "developer",
- "pattern": "mechanism",
- "notBefore": "2026-09-22T04:00:00Z",
+ "pattern": "clip",
+ "notBefore": "2026-09-22T12:00:00Z",
"source": {
- "path": "docs/announcements/avatar-mcp.md"
+ "path": "docs/announcements/assistant.md",
+ "url": "https://three.ws/assistant"
},
"posts": [
{
- "text": "Ask your assistant for an avatar and it renders in the chat: live, rotatable, idling, with a paste-anywhere embed beside it. npmjs.com/package/@three-ws/avatar-mcp",
- "textFrom": "docs/announcements/avatar-mcp.post.txt",
+ "text": "One script tag puts a 3D avatar assistant in the corner of any site. Pick a body, a background, and what it knows about your page. three.ws/assistant",
+ "textFrom": "docs/announcements/assistant.post.txt",
"media": [
{
- "path": "public/announce/img/avatar-mcp-hero.webp",
- "alt": "A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom."
+ "path": "public/announce/img/assistant-hero.webp",
+ "alt": "The assistant configurator with the option columns on the left and the floating launcher open in the corner showing a 3D avatar over the live page preview."
}
]
},
{
- "text": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat. All three tools are free and read-only."
+ "text": "The live preview runs in the corner of the page while you configure it, and every change above re-mounts it."
},
{
- "text": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."
+ "text": "Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body. It answers in chat, or speaks what you type in a speech bubble."
}
],
"claims": [
{
- "says": "All three tools are free and read-only",
- "evidence": [
- {
- "type": "file",
- "path": "packages/threews-avatar-mcp/README.md",
- "contains": "All three tools are free, read-only, and annotated (`readOnlyHint`, `idempotentHint`, `openWorldHint`) so hosts can run them without confirmation prompts."
- }
- ]
- },
- {
- "says": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat.",
+ "says": "The live preview runs in the corner of the page while you configure it, and every change above re-mounts it.",
"evidence": [
{
- "type": "file",
- "path": "packages/threews-avatar-mcp/README.md",
- "contains": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat."
+ "type": "page",
+ "url": "https://three.ws/assistant",
+ "contains": "Live preview running in the corner. Every change above re-mounts it."
}
]
},
{
- "says": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere.",
+ "says": "Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body.",
"evidence": [
{
- "type": "file",
- "path": "packages/threews-avatar-mcp/README.md",
- "contains": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."
+ "type": "page",
+ "url": "https://three.ws/assistant",
+ "contains": "Use a built-in body, any three.ws avatar id (make one in Forge), a GLB URL, or an agent's body via data-agent."
}
]
}
diff --git a/docs/announcements/activity-mcp.md b/docs/announcements/activity-mcp.md
index 31b896b7d..f56f410b7 100644
--- a/docs/announcements/activity-mcp.md
+++ b/docs/announcements/activity-mcp.md
@@ -2,7 +2,7 @@
**Surface:** [`@three-ws/activity-mcp`](https://three.ws) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never
-Ranked 31 of 324 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/activity-mcp.json`](../../data/announce-plan/briefs/activity-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
+Ranked 33 of 329 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/activity-mcp.json`](../../data/announce-plan/briefs/activity-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
---
@@ -55,7 +55,7 @@ Captured from the live route by `npm run announce:media`, which drives the real
**Alt text, required on the post:**
-> A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom.
+> A dark title card headed at three-ws slash activity-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming get_trending_agents, get_trending_coins, get_holder_leaderboard, get_tier_info and get_feed_events.
## The post
diff --git a/docs/announcements/assistant.md b/docs/announcements/assistant.md
new file mode 100644
index 000000000..1f4006c0b
--- /dev/null
+++ b/docs/announcements/assistant.md
@@ -0,0 +1,106 @@
+# Announcement pack: A 3D assistant on any site, from one script tag
+
+**Surface:** [`/assistant`](https://three.ws/assistant) · **Stage:** drafted · **Slot:** 2026-09-22 · **Announced externally:** never
+
+Ranked 46 of 324 never-announced surfaces by `npm run announce:rank` (score 66). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/assistant.json`](../../data/announce-plan/briefs/assistant.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
+
+---
+
+## At a glance
+
+| Field | Value |
+|---|---|
+| Pack id | `assistant` |
+| Publish slot | 2026-09-22. The minute is decided at send time from the production schedule seed, so it is not knowable from this repository |
+| Lane and pattern | developer / clip |
+| Audience | Engineers who will read the code |
+| Primary channel | X, @trythreews, through the reviewed content queue |
+| Secondary channels | Telegram (@three_ws), the surface's own docs page |
+| Proof | https://three.ws/assistant |
+| Tracked links | Telegram `https://three.ws/assistant?utm_source=telegram&utm_medium=community&utm_campaign=announce-assistant&utm_content=announcement`. The X post links the bare URL on purpose: X wraps every link in t.co and the queue's own ledger records the send, so a tagged link buys nothing and reads like marketing. |
+| The single CTA | Open /assistant and use it |
+| Media | `assistant-hero`, motion loop |
+| KPI | loop completions and profile visits, then route sessions on the day |
+
+## Why this one, and why now
+
+The ranker scored it on signals measured against our own archive, not on taste:
+
+- **reach (16)**: sitemap priority 0.80, which is what we already decided this surface is worth
+- **visual (25)**: a showcase surface, so its frame can be a motion loop
+- **novelty (20)**: on the coverage audit's hand-picked shortlist of strongest candidates
+- **depth (5)**: documented in the tree, so there is enough to write a mechanism about and link proof for
+
+The coverage audit's note on it: The AI concierge and assistant widgets: the embeddable business story beyond avatars.
+
+It shipped on 2026-07-18 and has never been posted about.
+
+The changelog has 4 entries about it, the most recent from 2026-08-16: "The assistant widget now tells you the truth when its chat lane is busy".
+
+## The claim, and where it is checked
+
+> One script tag puts a 3D avatar assistant in the corner of any site. Pick a body, a background, and what it knows about your page. three.ws/assistant
+
+Every checkable part of that is declared as a claim in the queue item, and the verifier re-checks each one against the live surface before the post can be approved:
+
+| Claim | Checked against |
+|---|---|
+| The live preview runs in the corner of the page while you configure it, and every change above re-mounts it. | live page shows "Live preview running in the corner. Every change above re-mounts it." |
+| Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body. | live page shows "Use a built-in body, any three.ws avatar id (make one in Forge), a GLB URL, or an agent's body via data-agent." |
+
+## Media
+
+Captured from the live route by `npm run announce:media`, which drives the real page in a real Chromium and writes provenance (route, commit, time, sha256) beside the pixels in [`public/announce/media-manifest.json`](../../public/announce/media-manifest.json).
+
+| Shot | File | Notes |
+|---|---|---|
+| `assistant-hero` | `/announce/img/assistant-hero.webp` | Motion loop of the live route. |
+
+**Alt text, required on the post:**
+
+> The assistant configurator with the option columns on the left and the floating launcher open in the corner showing a 3D avatar over the live page preview.
+
+## The post
+
+Pattern: clip. **154 weighted characters**, inside the 100 to 179 band that measured a 3.0x lift. Postable file: [`assistant.post.txt`](./assistant.post.txt), which is the byte-for-byte source the queue item points at.
+
+```text
+One script tag puts a 3D avatar assistant in the corner of any site. Pick a body, a background, and what it knows about your page. three.ws/assistant
+```
+
+### Why it is written that way
+
+The post leads on the first move a developer makes and what comes back: configure, watch the preview re-mount, copy one tag. That is the whole product, and it is the shortest path from reading to shipping an avatar on a real site.
+
+### Thread
+
+2/ (108)
+
+```text
+The live preview runs in the corner of the page while you configure it, and every change above re-mounts it.
+```
+
+3/ (154)
+
+```text
+Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body. It answers in chat, or speaks what you type in a speech bubble.
+```
+
+## Telegram (@three_ws)
+
+The same facts in the channel's longer register. The changelog cron posts release notes there automatically; this is the announcement register, sent by hand or queued alongside the post.
+
+```text
+The assistant widget puts a talking 3D avatar on any website with one script tag. Pick a body, a background, and what the chatbot should know about your site, and the live preview in the corner re-mounts on every change. Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body, then copy the tag. three.ws/assistant
+```
+
+## Ship it
+
+```bash
+npm run announce:media -- --only assistant-hero # capture the frame from the live route
+npm run x:content -- review assistant # lint, live fact checks, AI editor
+npm run x:content -- run --dry-run --id assistant # exactly what would be sent to X
+```
+
+The queue item is `assistant` in [`data/x-content/queue.json`](../../data/x-content/queue.json), at status `draft`. It becomes eligible to publish when a passing review record exists and the owner sets its status to `approved`; the Cloud Scheduler tick then sends it at its slot. Nothing here posts on its own.
+
diff --git a/docs/announcements/assistant.post.txt b/docs/announcements/assistant.post.txt
new file mode 100644
index 000000000..73bae9978
--- /dev/null
+++ b/docs/announcements/assistant.post.txt
@@ -0,0 +1 @@
+One script tag puts a 3D avatar assistant in the corner of any site. Pick a body, a background, and what it knows about your page. three.ws/assistant
diff --git a/docs/announcements/avatar-mcp.md b/docs/announcements/avatar-mcp.md
index eb2948a3b..35eb7607f 100644
--- a/docs/announcements/avatar-mcp.md
+++ b/docs/announcements/avatar-mcp.md
@@ -1,8 +1,8 @@
# Announcement pack: A live 3D avatar rendered inside the chat
-**Surface:** [`@three-ws/avatar-mcp`](https://three.ws) · **Stage:** drafted · **Slot:** 2026-09-22 · **Announced externally:** never
+**Surface:** [`@three-ws/avatar-mcp`](https://three.ws) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never
-Ranked 36 of 324 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/avatar-mcp.json`](../../data/announce-plan/briefs/avatar-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
+Ranked 38 of 329 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/avatar-mcp.json`](../../data/announce-plan/briefs/avatar-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
---
@@ -11,7 +11,7 @@ Ranked 36 of 324 never-announced surfaces by `npm run announce:rank` (score 67).
| Field | Value |
|---|---|
| Pack id | `avatar-mcp` |
-| Publish slot | 2026-09-22. The minute is decided at send time from the production schedule seed, so it is not knowable from this repository |
+| Publish slot | 2026-09-21. The minute is decided at send time from the production schedule seed, so it is not knowable from this repository |
| Lane and pattern | developer / mechanism |
| Audience | Engineers who will read the code |
| Primary channel | X, @trythreews, through the reviewed content queue |
@@ -56,7 +56,7 @@ Captured from the live route by `npm run announce:media`, which drives the real
**Alt text, required on the post:**
-> A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom.
+> A dark title card headed at three-ws slash avatar-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming render_avatar, avatar_embed_code and get_avatar.
## The post
diff --git a/docs/announcements/knock.md b/docs/announcements/knock.md
index 6bdbcbe3f..e46d1aa1b 100644
--- a/docs/announcements/knock.md
+++ b/docs/announcements/knock.md
@@ -2,7 +2,7 @@
**Surface:** [`/knock`](https://three.ws/knock) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never
-Ranked 29 of 324 never-announced surfaces by `npm run announce:rank` (score 70). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/knock.json`](../../data/announce-plan/briefs/knock.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
+Ranked 31 of 329 never-announced surfaces by `npm run announce:rank` (score 70). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/knock.json`](../../data/announce-plan/briefs/knock.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
---
@@ -58,7 +58,7 @@ Captured from the live route by `npm run announce:media`, which drives the real
**Alt text, required on the post:**
-> The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it.
+> The Knock page on three.ws: the headline and its description, three numbered cards reading Set your price, They pay it and You hear it in person, and the signed-out door panel below them.
## The post
diff --git a/public/announce/media-manifest.json b/public/announce/media-manifest.json
index 7e32d212c..f578d181a 100644
--- a/public/announce/media-manifest.json
+++ b/public/announce/media-manifest.json
@@ -1,6 +1,6 @@
{
"generatedBy": "scripts/capture-doc-media.mjs",
- "generatedAt": "2026-09-20T05:56:28.175Z",
+ "generatedAt": "2026-09-20T06:09:35.981Z",
"shots": {
"activity-hero": {
"id": "activity-hero",
@@ -41,7 +41,7 @@
"activity-mcp-hero": {
"id": "activity-mcp-hero",
"src": "/announce/img/activity-mcp-hero.webp",
- "alt": "A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom.",
+ "alt": "A dark title card headed at three-ws slash activity-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming get_trending_agents, get_trending_coins, get_holder_leaderboard, get_tier_info and get_feed_events.",
"caption": "Title card for @three-ws/activity-mcp, typeset from its README and package.json.",
"route": "card:packages/activity-mcp",
"viewport": "wide",
@@ -58,7 +58,7 @@
"avatar-mcp-hero": {
"id": "avatar-mcp-hero",
"src": "/announce/img/avatar-mcp-hero.webp",
- "alt": "A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom.",
+ "alt": "A dark title card headed at three-ws slash avatar-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming render_avatar, avatar_embed_code and get_avatar.",
"caption": "Title card for @three-ws/avatar-mcp, typeset from its README and package.json.",
"route": "card:packages/threews-avatar-mcp",
"viewport": "wide",
@@ -151,7 +151,7 @@
"knock-hero": {
"id": "knock-hero",
"src": "/announce/img/knock-hero.webp",
- "alt": "The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it.",
+ "alt": "The Knock page on three.ws: the headline and its description, three numbered cards reading Set your price, They pay it and You hear it in person, and the signed-out door panel below them.",
"caption": "Captured from the live /knock route for the knock announcement.",
"route": "/knock",
"viewport": "wide",