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(three-token): bring the $THREE thesis up to the verified ecosystem numbers and cross-link it with Weekly Report #1

nirholasbfdb1cf1b73d
diff --git a/docs/start-here.md b/docs/start-here.md
index 0ee2d8e5f..b8d495161 100644
--- a/docs/start-here.md
+++ b/docs/start-here.md
@@ -108,7 +108,7 @@ Curious what happens between the prompt and the model? [How the Forge works](./h
- **Walking in real time, on-chain?** → [The on-chain world](./bnb-world.md) — `/agora`'s Play mode has an opt-in toggle that commits your walk to a real BNB Chain contract at its live ~0.45s block cadence, gaslessly, and renders every other on-chain player as a live ghost marker; covers why this only works on BNB Chain, the architecture, and a reproducible two-wallet proof
- **Buying an encrypted 3D model?** → [The vault](./bnb-vault.md) — `/vault` sells access to encrypted 3D models gated by a real BSC purchase that triggers a real cross-chain Greenfield permission grant; covers the buyer flow (browse, buy, settle, unlock, view — all decrypted client-side), the local session-key wallet model, and a reproducible anvil-fork browser proof
- **Want a branded on-chain address?** → [Vanity grinder](./vanity.md) — grind a Solana address that starts with your ticker (branded token mint or agent/treasury wallet) in one paid USDC call; keypair or importable mnemonic, nothing stored, optional sealed delivery, plus a provably-fair variant and a pre-ground premium inventory
-- **Going Pro?** → [Paid plans](./plan-checkout.md): upgrade with a single on-chain payment in USDC, SOL, or $THREE (the platform coin takes 20% off); [hold-to-access](./hold-to-access.md) covers the separate hold-$THREE tier ladder; [the $THREE thesis](./three-thesis.md) is the long-form case for the token with every utility, sink, listing, and risk in one place
+- **Going Pro?** → [Paid plans](./plan-checkout.md): upgrade with a single on-chain payment in USDC, SOL, or $THREE (the platform coin takes 20% off); [hold-to-access](./hold-to-access.md) covers the separate hold-$THREE tier ladder; [the $THREE thesis](./three-thesis.md) is the long-form case for the token with every utility, sink, listing, and risk in one place; [Weekly Report #1](./weekly-report-1.md) is the week-by-week record of everything shipped since the first commit
- **Building a community perk?** → [Token-gated 3D embeds](./token-gated-3d-embeds.md) — turn an avatar or on-chain agent into a holder-only interactive embed; visitors prove a real, server-verified on-chain balance before the live scene renders, no download-only gate
- **Watching a generation cook?** → [Generation Watch](./generation-watch.md): the /watch page tracks a running text-to-3D generation live, from the countdown to the automatic hand-off into the viewer
- **Browsing what the agents bought?** → [The Agent-Forged Gallery](./forged.md): 3D props purchased by autonomous agents with real USDC over x402, each carrying its paying wallet, price, and on-chain settlement receipt
diff --git a/docs/three-thesis.md b/docs/three-thesis.md
index 6a3aca871..2f9184677 100644
--- a/docs/three-thesis.md
+++ b/docs/three-thesis.md
@@ -80,14 +80,19 @@ Numbers measured directly from the repository on 2026-08-25:
| Public pages (`data/pages.json`) | **723** across 10 sections (Crypto 137, Build 59, Learn 373, Main 52, Labs 22, Blog 39, and more) |
| Changelog entries (`data/changelog.json`) | **2,673**, dated 2026-04-15 to 2026-08-24 |
| Changelog tag mix | fix 1,190 · improvement 1,075 · feature 991 · infra 320 · docs 225 · security 216 · sdk 166 |
-| npm packages under `packages/` | **70** (53 declared workspaces) |
+| npm packages published under @three-ws | **101** (42 of them MCP servers, 6,225 downloads in the last 30 days); 70 live under `packages/` in this repo |
| Root `package.json` | 257 scripts, 139 dependencies, version 1.5.2 |
-| MCP servers in the public catalog | **36** (including `three-token-mcp`, `threews-3d-studio`, `threews-pumpfun`, `x402-mcp`, `agora-mcp`, `metaplex-agent-mcp`) |
+| MCP servers in the official registry | **72** under `io.github.nirholas` (including `three-token-mcp`, `threews-3d-studio`, `threews-pumpfun`, `x402-mcp`, `agora-mcp`, `metaplex-agent`) |
| Docs mentioning $THREE | 89 markdown files |
| Cloud Scheduler crons | ~76 |
| Crypto news archive | **660,000+ articles** from September 2017 onward, 192 publisher feeds in 18 languages |
| DeFi pools indexed | ~15,000 live pools |
| Individually priced x402 datapoints | **1,000,000+** at $0.0005 each |
+| Priced x402 endpoints in the live discovery catalog | **4,519** |
+| x402 settlements through the self-hosted facilitator | **110,416** on-chain, plus 803,483 payment verifications |
+| Validator attestations and custody proofs on Solana | **3,000** attestations, 126,522 custody proofs across 244 epochs |
+| GitHub | 104 stars, 26 forks, 21 contributors, 60 pull requests, 9,508 commits; 111 related open-source repos with 1,222 stars between them |
+| ERC-8004 registries | live at one CREATE2 address on **12 EVM mainnets** |
The changelog cadence matters more than any single number. 2,673 holder-readable entries in roughly 130 days is about twenty shipped changes per day, every day, with 216 of them tagged security. This is what a team that is actually building looks like. The changelog is public at [three.ws/changelog](https://three.ws/changelog), with RSS and JSON feeds, and every entry is pushed automatically to the holders' Telegram channel (@three_ws) by a cron that diffs the feed against database state. Holders do not have to wonder whether development continues; it is announced to them twenty times a day.
@@ -365,6 +370,7 @@ PumpSwap three/SOL $48,861 · Meteora three/SOL $18,130 · Orca three/SOL $13,44
- **Jupiter Verified** (the default Solana swap router's trust list)
- **Phantom Verified** (the default Solana wallet's trust list)
+- **fomo** (fomo.family) in-app verification, which matters mostly as protection against lookalike mints
- **pump.fun verified project** badge on the coin page, plus a pump.fun-published feature article, "Three Builds With Tech Giants," on the official coin page. The platform reads pump.fun's verification status live on every request to `/api/three-token/stats` rather than hardcoding it; the same shared badge component renders on `/three-token` and the dashboard so the two can never disagree. The copy is deliberately precise: "verified project," not partner, endorsement, or investment.
- **CoinGecko** (id `three-ws`) and **CoinMarketCap** (live since 2026-05-17, with a community profile)
- **Investing.com**
@@ -522,7 +528,7 @@ If buybacks never turn on, perks never activate, or revenue does not grow, the t
## 17. Summary of the bull case
-1. **A real, shipping, open-source product** with 723 pages, 70 packages, 36 MCP servers, and 2,673 changelog entries in four months. The code is public and every mechanic in this document can be read.
+1. **A real, shipping, open-source product** with 725 pages, 101 npm packages, 72 MCP servers in the official registry, 4,519 priced x402 endpoints with 110,416 on-chain settlements, and 2,674 changelog entries in four months. The code is public and every mechanic in this document can be read. The week-by-week record is in [the first weekly report](./weekly-report-1.md).
2. **A complete agent-economy stack**: bodies (3D avatars), identities (ERC-8004 and Metaplex Core), wallets (custodial with a single spend-policy boundary), rails (x402 with a self-hosted Solana facilitator), trust (cross-chain reputation and identity verification), and markets (skills, assets, labor, bounties, vaults).
3. **The token is wired into every layer**: hold-to-access tiers, 20% discounts on plans and passes, marketplace-only currency, labor and bounty escrow, game cosmetics, gated embeds, holder worlds, rider passes, deploy-fee waivers, x402 acceptance, and one-signature allowances.
4. **Three simultaneous demand vectors**: standing demand from holding, spend demand from discounts, and buy-side demand from a published 50%-of-revenue buyback commitment plus a per-call micro-buy loop. The platform never sells and never burns.
diff --git a/docs/weekly-report-1.md b/docs/weekly-report-1.md
index cd83a6b25..28640912f 100644
--- a/docs/weekly-report-1.md
+++ b/docs/weekly-report-1.md
@@ -616,7 +616,7 @@ Because they are spread across nineteen weeks, here is the full list:
## Where $THREE sits in all of this
-Every week above added a place where the token does work. Collected:
+Every week above added a place where the token does work. Collected here; the full long-form case, with every mechanism sourced to the code and every risk the platform documents about itself, is the $THREE thesis at three.ws/docs/three-thesis.
- Hold to access. Five tiers resolved from the live USD value of $THREE held, never spent: Bronze at $25, Silver at $100, Gold at $500, Genesis at $2,500. Compute discounts from 5% to 30%, free-quota multipliers from 2x to 10x. Live today on Forge high-quality generation and game-ready export, with private worlds, early drops, and first dibs on rare threews.sol names next in line.
- Spend at a discount. Pro, Team, and Enterprise plans and the Premium Data API pass are 20% cheaper in $THREE than in USDC or SOL.