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.

docs(announcements): add the Forged gallery pack and queue the $THREE token MCP post with its catalog hero shot

nirholasdc96a991f73f
diff --git a/data/announce-media.json b/data/announce-media.json
index bd5f8199c..a61b1b570 100644
--- a/data/announce-media.json
+++ b/data/announce-media.json
@@ -76,6 +76,31 @@
"alt": "The article live on the AWS Builder Center under the three.ws byline, headlined \"Budgets, entitlements, and the $THREE token layer: how we authorize autonomous agent spending\", published 11 September 2026 as the second article in the three.ws series",
"caption": "Published on AWS's own builder platform, with $THREE named in the headline.",
"settle": 4500
+ },
+ {
+ "id": "three-token-mcp-hero",
+ "surface": "@three-ws/three-token-mcp",
+ "url": "/mcp-tools?server=three-token-mcp",
+ "alt": "The three.ws MCP Tool Catalog filtered to the @three-ws/three-token-mcp server: 3 of 321 tools, with three_balance and three_price labelled read-only and three_burn labelled irreversible, all free",
+ "caption": "The server's three tools as the public catalog classifies them: two reads an assistant can run unprompted, one irreversible burn it has to ask about.",
+ "actions": [
+ {
+ "type": "waitFor",
+ "selector": ".mc-card"
+ },
+ {
+ "type": "hide",
+ "selectors": [
+ ".mc-desc",
+ ".mc-title",
+ ".mc-policy-out"
+ ]
+ },
+ {
+ "type": "scroll",
+ "selector": "#mc-count"
+ }
+ ]
}
]
}
diff --git a/data/x-content/queue.json b/data/x-content/queue.json
index e43965c56..1334501b1 100644
--- a/data/x-content/queue.json
+++ b/data/x-content/queue.json
@@ -243,6 +243,89 @@
"mentions": {
"@awscloud": "The article is published on the AWS Builder Center under the three.ws byline, as an AWS Partner."
}
+ },
+ {
+ "id": "three-token-mcp",
+ "status": "review",
+ "kind": "post",
+ "lane": "token",
+ "pattern": "mechanism",
+ "notBefore": "2026-09-18T16:00:00Z",
+ "source": {
+ "path": "docs/announcements/three-token-mcp.md"
+ },
+ "posts": [
+ {
+ "text": "An MCP server that lets an AI burn $THREE on @solana. three_burn is flagged irreversible and by default won't sign without confirm: true. three.ws/mcp-tools?server=three-token-mcp",
+ "textFrom": "docs/announcements/three-token-mcp.post.txt",
+ "media": [
+ {
+ "path": "public/announce/img/three-token-mcp-hero.webp",
+ "alt": "The three.ws MCP Tool Catalog filtered to the @three-ws/three-token-mcp server: 3 of 321 tools, with three_balance and three_price labelled read-only and three_burn labelled irreversible, all free"
+ }
+ ]
+ }
+ ],
+ "claims": [
+ {
+ "says": "burn $THREE on @solana",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",
+ "contains": "Burn $THREE on-chain"
+ },
+ {
+ "type": "page",
+ "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",
+ "contains": "signs and broadcasts on Solana mainnet"
+ },
+ {
+ "type": "file",
+ "path": "packages/three-token-mcp/src/lib/token.js",
+ "contains": "export function assertCanonicalThree(config)"
+ }
+ ]
+ },
+ {
+ "says": "flagged irreversible",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",
+ "contains": "Irreversible. Cannot be undone once it runs."
+ },
+ {
+ "type": "file",
+ "path": "packages/three-token-mcp/src/tools/three-burn.js",
+ "contains": "destructiveHint: true"
+ }
+ ]
+ },
+ {
+ "says": "by default won't sign without confirm: true",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",
+ "contains": "IRREVERSIBLE: pass confirm:true"
+ },
+ {
+ "type": "file",
+ "path": "packages/three-token-mcp/src/tools/three-burn.js",
+ "contains": "if (REQUIRE_CONFIRM && confirm !== true)"
+ },
+ {
+ "type": "file",
+ "path": "packages/three-token-mcp/src/config.js",
+ "contains": "if (raw === undefined) return true;"
+ }
+ ]
+ }
+ ],
+ "mentions": {
+ "@solana": "three_burn signs and broadcasts one Solana mainnet transaction (packages/three-token-mcp/src/lib/token.js); $THREE is an SPL token and Solana is the platform's home chain."
+ }
}
]
}
diff --git a/docs/announcements/forged.md b/docs/announcements/forged.md
new file mode 100644
index 000000000..1c8dfab4b
--- /dev/null
+++ b/docs/announcements/forged.md
@@ -0,0 +1,119 @@
+# Announcement pack: the Agent-Forged Gallery
+
+**Surface:** [`/forged`](https://three.ws/forged) · **Ledger key:** `/forged` · **Stage:** drafted
+· **Shipped:** 2026-07-25 · **Announced externally:** never
+
+A showcase surface in `data/pages.json` (priority 0.7) that has never been posted about. Written
+against [the announcement voice](../announce-voice.md).
+
+---
+
+## The claim, and where it is checked
+
+> Every 3D prop in the gallery was bought by one of the platform's autonomous agents: the agent
+> paid the Forge $0.15 in USDC over x402, the payment settled on Solana, and the card carries the
+> receipt (price, paying wallet, settlement transaction).
+
+Verified by reading the code and by querying the live feed on 2026-09-17:
+
+| Part of the claim | Where it is real |
+|---|---|
+| Every prop was bought by an autonomous agent | The only writer of `forge_autonomous_props` is the `forge` pipeline in the autonomous x402 loop, [`api/_lib/x402/pipelines/forge-content.js`](../../api/_lib/x402/pipelines/forge-content.js) ("Each call is a real on-chain USDC payment from the seed wallet via the shared payX402 client"). The feed, [`api/forged.js`](../../api/forged.js), reads only that table and states "There are no synthetic entries". The live page says "Every asset here was purchased by one of the platform's autonomous agents". |
+| $0.15 in USDC per prop | The pipeline pays `POST /api/x402/forge` at the standard tier ([`docs/forged.md`](../forged.md), priced in [`api/_lib/forge-tiers.js`](../../api/_lib/forge-tiers.js)). `GET /api/forged?limit=100` on 2026-09-17 returned 100 of 100 props at `price_usdc: 0.15`, tier `standard`. Each card renders it as "$0.15 USDC" ([`src/forged-gallery.js`](../../src/forged-gallery.js), `formatUsdc`). |
+| Over x402 | `payX402` in [`api/_lib/x402/pay.js`](../../api/_lib/x402/pay.js) selects the `solana` accept entry and settles through the self-hosted facilitator. The page hero: "real USDC over the x402 payment protocol". |
+| The card links the Solana settlement | `toProp()` in [`api/forged.js`](../../api/forged.js) builds `explorer_url` from the stored `tx_sig`; the card renders it as a `receipt` link titled "View the settlement transaction on Solscan". All 100 props returned carried a `tx_sig`. The newest one (`28gNXzZjZSAQ...`) was checked with `getSignatureStatuses` against Solana mainnet: `finalized`, `err: null`. |
+
+Full mechanism: [docs/forged.md](../forged.md). Live totals at time of writing, from the same feed
+the hero reads: 129 renderable props, $21.15 USDC settled, across 8 prop families.
+
+## Media
+
+Captured from the live route with `scripts/capture-doc-media.mjs`. Provenance (route, commit,
+time, sha256) goes in [`public/announce/media-manifest.json`](../../public/announce/media-manifest.json)
+when the recipe is merged into [`data/announce-media.json`](../../data/announce-media.json) and
+`npm run announce:media` runs.
+
+| Shot | File | Notes |
+|---|---|---|
+| `forged-hero` | `/announce/img/forged-hero.webp` | 1600x900 wide viewport, signed out (the gallery is public). The hero, its live "props forged / USDC settled on-chain" stats line, and the first row of cards with their receipt strips. |
+
+**Alt text, required on the post:**
+
+> The three.ws Agent-Forged Gallery: 3D props bought by AI agents, each card a rotating model with
+> the prompt the agent paid for and a receipt strip showing the USDC price, the paying agent
+> wallet, and a link to the Solana settlement transaction.
+
+No third-party token tickers or market data appear on this page. USDC is the payment asset of the
+x402 rail, not a promoted project, and the frame shows only prices paid.
+
+## The post
+
+Pattern: mechanism lead. **151 weighted characters** (per `post-tweet.mjs --dry-run`), inside the
+100-179 band. Tags `@solana` because every receipt on the page is a Solana mainnet settlement,
+and Solana is the home chain.
+
+Postable file: [`forged.post.txt`](./forged.post.txt).
+
+```text
+Every 3D prop in this gallery was bought by an autonomous agent for $0.15 in USDC over x402, and its card links the @solana settlement: three.ws/forged
+```
+
+Ship it with `forged-hero` attached and the alt text above.
+
+### Why it is written that way
+
+"AI-generated 3D gallery" is a category readers have seen a hundred times. The part nobody else
+can show is the buyer: an agent with its own wallet paid for each asset, and the proof sits on
+the card. So the post opens on "bought by an autonomous agent", gives the exact price (a number
+the frame and every receipt confirm), and ends on the receipt link, which is the reader's reason
+to click.
+
+The prop count (129) and the settled total ($21.15) were left out on purpose. They are true today
+and read live off the feed, but the autonomous loop can resume buying at any time, and a count in
+a queued post goes stale the moment it does. The per-prop price is fixed by the tier and does not
+drift.
+
+## Telegram variant
+
+```text
+The Agent-Forged Gallery is at three.ws/forged, and it has never been posted about.
+
+Every 3D prop in it was bought, not seeded. The platform's autonomous x402 loop pays the Forge for
+a standard-tier generation ($0.15 in USDC), the payment settles on Solana mainnet through our own
+facilitator, and the finished GLB lands in the gallery carrying its receipt:
+
+- the price the agent paid,
+- the paying agent wallet,
+- a link to the settlement transaction on Solscan.
+
+Each prompt is picked from a catalog of roughly 5,000 prop combinations across eight families
+(vehicles, furniture, club decor, AR objects, terrain and more) and scored for novelty against the
+last 200 props, so you can sort by most novel. Every prop opens in the 3D viewer or downloads as
+a GLB.
+
+three.ws/forged
+```
+
+## Changelog
+
+**No new entry.** The gallery shipped on 2026-07-25 and its page entry in `data/pages.json` already
+fed the changelog. This pack announces an existing surface externally for the first time and ships
+nothing new.
+
+## Notes
+
+- **Freshness.** The newest prop in the feed is from 2026-08-13; the autonomous loop has not bought
+ a prop since. Nothing in the post claims an ongoing cadence ("every hour" appears in the docs
+ but not in the copy), so the post stays true whether or not the loop resumes. Worth checking
+ the loop before scheduling: a live gallery that is growing on the day of the post is a better
+ demo than one that is a month old.
+- **Queue item:** status `review`, lane `agent-economy`, pattern `mechanism`, `notBefore` to be set
+ by the owner.
+
+## Posting
+
+Owner-gated, every time. Nothing in this pipeline posts.
+
+```bash
+node scripts/post-tweet.mjs --file docs/announcements/forged.post.txt --dry-run
+```
diff --git a/docs/announcements/forged.post.txt b/docs/announcements/forged.post.txt
new file mode 100644
index 000000000..48e7f3604
--- /dev/null
+++ b/docs/announcements/forged.post.txt
@@ -0,0 +1 @@
+Every 3D prop in this gallery was bought by an autonomous agent for $0.15 in USDC over x402, and its card links the @solana settlement: three.ws/forged