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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs(news): document the Wayback, SEC EDGAR and sibling lanes and the news_resolve tool, with changelog entry
nirholasbc1af793dbe8
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex d77752a87..6f0a70504 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -28,6 +28,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **Leaked-wallet rescue runbook with a dry run, and live Jito tip accounts**: A new rescue script moves every token and the remaining SOL out of a compromised wallet in one atomic Jito bundle, paid for by a separate safe wallet, and its default dry run simulates the whole bundle and prints the plan without sending anything. The leak alarm now links the runbook. Jito tips also read the block engine's live tip-account list with a pinned fallback, instead of three hardcoded copies. `[security, infra]`- **llms.txt links the docs as markdown, and install.md tells an agent how to connect**: llms.txt now links each curated doc as /docs/<slug>.md, the text/markdown twin an agent can read directly. llms-full.txt carries the full text of those docs (capped at 40 KB each, with a link to the rest) after the page index. A new /install.md, generated from the MCP directory, gives one place for the setup command, per-client settings and every hosted endpoint. (`/docs/cli`) `[docs]`- **Market anomaly feed: scored price, TVL, depeg, funding and open interest alerts**: A new scanner runs every 15 minutes over real market series (coin price, Solana TVL and stablecoin supply, stablecoin pegs, Hyperliquid funding and open interest) and records statistically scored anomalies with a medium, high or critical severity. Read them per call at /api/x402/market-anomalies ($0.001 USDC), or create a market_anomaly alert rule in alerts-mcp to be notified. Thin or flat series are skipped instead of guessed at. (`/docs/market-anomalies`) `[feature]`+- **News reader recovers blocked stories and gives a structured trading read**: When a publisher blocks or paywalls an article, the reader now recovers it from the Internet Archive, the SEC EDGAR filing the headline names, or other outlets covering the same story, and says which lane it used. The analysis is now a structured trading read: affected assets with exposure and direction, whether the news is priced in, the horizon, and a counter-argument. The same resolution is available to agents as the free news_resolve MCP tool. The excerpt limit applies to every lane. (`/markets/news`) `[feature, improvement]`- **Onchain viewer reads multi-part memo inscriptions**: Paste any transaction of a first/1, firsts/1 or SPL404 inscription into /onchain and it collects the other parts, checks each part and the whole SHA-256, names missing parts, and shows the file. Images render from verified bytes; SVG and HTML are shown as text and never executed. The Solana Memo Media MCP gains a read_inscription tool that does the same. (`/onchain`) `[feature]`- **One catalog for all 39 HookForge hooks, and a census that recognizes them**: The Uniswap v4 hooks guide now carries the full HookForge registry (39 hooks, pinned by commit) grouped by family, with the agent-native ones linked to their Solana counterparts, plus a design note reconciling AgentTierHook with reputation-fee. The hook census now decodes each hook's 14 permission bits from its address and calls hookName() to flag HookForge hooks when they show up on chain. (`/docs/uniswap-v4-hooks`) `[docs]`- **Oracle's smart-wallet prior now reads the live database**: The cold-start wallet prior behind Oracle's pedigree pillar is loaded from the daily-seeded wallet_reputation table instead of a committed June snapshot, so it tracks the current gmgn.ai rankings. It is cached in-process with a bounded refresh, keeps the last good rows if the database blips, and serves an empty prior (and logs it) rather than inventing wallets. (`/docs/oracle`) `[improvement]`diff --git a/data/changelog.json b/data/changelog.jsonindex 67ecbdd9e..dcda70e74 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,13 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-10-23",+ "title": "News reader recovers blocked stories and gives a structured trading read",+ "summary": "When a publisher blocks or paywalls an article, the reader now recovers it from the Internet Archive, the SEC EDGAR filing the headline names, or other outlets covering the same story, and says which lane it used. The analysis is now a structured trading read: affected assets with exposure and direction, whether the news is priced in, the horizon, and a counter-argument. The same resolution is available to agents as the free news_resolve MCP tool. The excerpt limit applies to every lane.",+ "tags": ["feature", "improvement"],+ "link": "/markets/news"+ },{"date": "2026-10-23","title": "Trust grades for every MCP server",diff --git a/docs/mcp-tools.md b/docs/mcp-tools.mdindex a636a9887..1ebfc6aab 100644--- a/docs/mcp-tools.md+++ b/docs/mcp-tools.md@@ -126,6 +126,7 @@ generation lane**; the rest are paid and quote their price in the| `forge_free` | **Free** | Text → textured GLB on the free NVIDIA NIM (Microsoft TRELLIS) lane; returns a GLB URL + viewer link. || `crypto_news` | **Free** | Live crypto headlines from every publisher feed in the registry (`api/_lib/news-sources.js`, 27 categories, 17 languages), filterable by category, source, language, or search. || `crypto_news_digest` | **Free** | Clusters the last 1-72h of coverage into distinct narratives with stance, tickers, and covering outlets. |+| `news_resolve` | **Free** | Resolves one article URL into a bounded excerpt, summary, tickers and a structured trading read (assets with exposure and direction, priced-in, horizon, counter-argument). Blocked or paywalled pages are recovered from the Internet Archive, SEC EDGAR or sibling coverage; `extraction` names the lane. || `crypto_news_archive` | free quota, then $0.001/search | Search 660,000+ archived articles back to September 2017. Stats and trending modes are always free; search is free up to a daily per-IP quota, then $0.001 USDC per search via x402. || `text_to_avatar` | paid | Text → 3D avatar. || `mesh_forge` | paid | Text/image → 3D mesh via a Granite-directed model chain. |diff --git a/docs/news-rights.md b/docs/news-rights.mdindex 17af462c9..39d8c60d9 100644--- a/docs/news-rights.md+++ b/docs/news-rights.md@@ -30,6 +30,18 @@ The cap is not a UI preference. It is enforced server-side in [`api/_lib/news-riThe extraction ladder still fetches the full text internally: the LLM needs the whole article to summarize it accurately, and the agents' grounding corpus reasons over it server-side. What changes is that the full text never reaches a response.+## Extraction lanes++When a publisher page and the reader service both come back empty, the ladder in [`api/_lib/article-extract.js`](../api/_lib/article-extract.js) tries the lanes in [`api/_lib/article-lanes.js`](../api/_lib/article-lanes.js), in this order:++| Lane | Source | Notes |+|---|---|---|+| `wayback` | The Internet Archive's closest snapshot of the same URL | Needs at least 3 paragraphs and more text than the live page |+| `primary` | The SEC EDGAR filing (8-K exhibit, 10-K, 10-Q, S-1) of the company the headline names | Contact User-Agent (`SEC_CONTACT_EMAIL`, default `[email protected]`), throttled to 8 requests/second, cached by accession |+| `siblings` | Other outlets covering the same story, from the native feed | Each contributes only its own bounded feed description, attributed by name |++Every network fetch goes through the SSRF guard, and the lane used is reported as `extraction` and `lane_sources` on `/api/news/article` and the `news_resolve` MCP tool. The excerpt cap above applies to every lane identically: a lane widens what we can read and analyze, never what a response quotes.+## Withdrawn stories and publishers`news-rights.js` holds two lists:diff --git a/mcp-server/README.md b/mcp-server/README.mdindex 761bf1681..cb08a721e 100644--- a/mcp-server/README.md+++ b/mcp-server/README.md@@ -26,7 +26,7 @@----> MCP tools from [three.ws](https://three.ws), **five need no payment, wallet, or API key to start**: `forge_free` (text prompt → 3D GLB on the free NVIDIA NIM / Microsoft TRELLIS lane), `vanity_premium` (browse the pre-ground premium vanity inventory), and the crypto-news trio (`crypto_news`, `crypto_news_digest`, and `crypto_news_archive`, archive search is free up to a daily quota, then $0.001 USDC per search via x402). The rest are paid: text/image→3D mesh generation, 3D avatars, one-call text→rigged-avatar generation, GLB auto-rigging, conversational model refinement, material restyling, pose seeds, pump.fun snapshots, ERC-8004 agent reputation, ENS/SNS resolution, agent-to-agent delegation and end-to-end agent hiring, token sentiment, AgenC coordination reads, aixbt market intel, and a Solana vanity grinder. Paid calls are settled in USDC via the [x402](https://x402.org) payment protocol on Solana mainnet (`exact` scheme). No subscription, no API key, pay per call, and failed calls never bill the caller.+> MCP tools from [three.ws](https://three.ws), **six need no payment, wallet, or API key to start**: `forge_free` (text prompt → 3D GLB on the free NVIDIA NIM / Microsoft TRELLIS lane), `vanity_premium` (browse the pre-ground premium vanity inventory), and the crypto-news set (`crypto_news`, `crypto_news_digest`, `news_resolve`, and `crypto_news_archive`, archive search is free up to a daily quota, then $0.001 USDC per search via x402). The rest are paid: text/image→3D mesh generation, 3D avatars, one-call text→rigged-avatar generation, GLB auto-rigging, conversational model refinement, material restyling, pose seeds, pump.fun snapshots, ERC-8004 agent reputation, ENS/SNS resolution, agent-to-agent delegation and end-to-end agent hiring, token sentiment, AgenC coordination reads, aixbt market intel, and a Solana vanity grinder. Paid calls are settled in USDC via the [x402](https://x402.org) payment protocol on Solana mainnet (`exact` scheme). No subscription, no API key, pay per call, and failed calls never bill the caller.---@@ -64,7 +64,7 @@ Restart Claude Desktop. All tools appear immediately — no install step require## Tools-All <!-- mcp-count:three-ws-mcp-server.tools -->26<!-- /mcp-count --> tools are listed below. Most quote a fixed USDC price and settle `exact` on Solana mainnet (prices below come straight from each tool's source); **`forge_free`, `vanity_premium`, `crypto_news`, and `crypto_news_digest` are free**, no payment, no wallet, no API key, and `crypto_news_archive` search is free up to a daily quota (stats/trending always free). Every tool also declares MCP tool annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`) so clients can scope confirmation prompts correctly, none of these tools are destructive.+All <!-- mcp-count:three-ws-mcp-server.tools -->26<!-- /mcp-count --> tools are listed below. Most quote a fixed USDC price and settle `exact` on Solana mainnet (prices below come straight from each tool's source); **`forge_free`, `vanity_premium`, `crypto_news`, `crypto_news_digest`, and `news_resolve` are free**, no payment, no wallet, no API key, and `crypto_news_archive` search is free up to a daily quota (stats/trending always free). Every tool also declares MCP tool annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`) so clients can scope confirmation prompts correctly, none of these tools are destructive.### 3D generation@@ -91,6 +91,7 @@ All <!-- mcp-count:three-ws-mcp-server.tools -->26<!-- /mcp-count --> tools are| `aixbt_projects` | $0.01 | aixbt momentum scan — projects ranked by spiking/climbing/active scores, with ticker, chain, market metrics (price, mcap, 24h volume + change), and recent intel. Filter by names or chain. Live aixbt REST API. || `crypto_news` | FREE | Live crypto headlines aggregated natively by three.ws from 197 publisher RSS/Atom feeds in 17 languages. Filter by category, source, or language, or full-text search. Each article carries the publisher link, publish time, detected tickers, and lexicon sentiment. No payment, no key. || `crypto_news_digest` | FREE | The last 1–72h of coverage clustered into distinct narratives — title, plain-language summary, bullish/bearish stance, tickers, coverage count, and every real article behind each story. Names its engine honestly (`llm` semantic grouping or `heuristic` Jaccard clustering). No payment, no key. |+| `news_resolve` | FREE | Resolve one article URL into a bounded lead excerpt, summary, key points, tickers, and a structured trading read (affected assets with exposure and direction, `priced_in`, `horizon`, and a mandatory counter-argument). When the publisher blocks fetches, recovers the story from the Internet Archive, the SEC EDGAR filing the headline names, or other outlets covering it, and reports the lane in `extraction`. Never returns a full publisher body; `full_text_url` points to the original. || `crypto_news_archive` | FREE tier | Search 660,000+ archived articles back to September 2017 (refreshed hourly) by keyword, ticker, source, date range, sentiment, or language — with market context at publication where captured. `mode: stats` and `mode: trending` for corpus statistics and most-covered tickers (always free, no key). Search has a free daily quota (60/day per IP), then $0.001 USDC per search via x402 on the HTTP API; an exhausted quota returns a `payment_required` envelope with the price and networks. |### Agents & identitydiff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex a9e18371b..1495f6c7a 100644--- a/public/changelog-recent.json+++ b/public/changelog-recent.json@@ -1,11 +1,11 @@{- "generated_at": "2026-10-23T22:24:41.310Z",+ "generated_at": "2026-10-23T22:31:41.495Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},- "total": 4142,+ "total": 4143,"complete": false,"full_feed": "/changelog.json","entries": [@@ -232,6 +232,17 @@"feature"]},+ {+ "date": "2026-10-23",+ "type": "update",+ "title": "News reader recovers blocked stories and gives a structured trading read",+ "summary": "When a publisher blocks or paywalls an article, the reader now recovers it from the Internet Archive, the SEC EDGAR filing the headline names, or other outlets covering the same story, and says which lane it used. The analysis is now a structured trading read: affected assets with exposure and direction, whether the news is priced in, the horizon, and a counter-argument. The same resolution is available to agents as the free news_resolve MCP tool. The excerpt limit applies to every lane.",+ "link": "/markets/news",+ "tags": [+ "feature",+ "improvement"+ ]+ },{"date": "2026-10-23","type": "update",@@ -1550,17 +1561,6 @@"feature","desktop"]- },- {- "date": "2026-10-11",- "type": "update",- "title": "The desktop now looks and works like a real operating system",- "summary": "The desktop shell is rebuilt to feel like a computer, not a web page. A floating island taskbar with Start, Widgets and Assistant buttons. A new Start menu with your avatar, the time, an A to Z list of every app and page, pinned apps, recent files, quick folder links and a power button, plus search across apps, pages and your files. A system tray with live network, volume and battery readouts that opens quick settings (dark mode, night light, do not disturb, energy saver, sounds, full screen, brightness and volume). A notification centre over a month calendar, with toasts that open the app that sent them. A lock screen (Ctrl+Alt+L), a power menu with restart, shut down and sign out, a Run box (Ctrl+Alt+R) and an About page with your real device specs. The desktop is now your Desktop folder: create folders and text files from the right-click menu, rename with F2, delete to the Recycle Bin, drop files from your computer onto it, and set any picture as the wallpaper. New Bubbles wallpaper in dark and light, glossy app icons, and Ctrl+Alt shortcuts for every system surface.",- "link": "/?view=desktop",- "tags": [- "feature",- "desktop"- ]}]}diff --git a/public/changelog.json b/public/changelog.jsonindex 8016481a2..b82af6d2c 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-23T22:24:41.286Z",+ "generated_at": "2026-10-23T22:31:41.436Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -229,6 +229,17 @@"feature"]},+ {+ "date": "2026-10-23",+ "type": "update",+ "title": "News reader recovers blocked stories and gives a structured trading read",+ "summary": "When a publisher blocks or paywalls an article, the reader now recovers it from the Internet Archive, the SEC EDGAR filing the headline names, or other outlets covering the same story, and says which lane it used. The analysis is now a structured trading read: affected assets with exposure and direction, whether the news is priced in, the horizon, and a counter-argument. The same resolution is available to agents as the free news_resolve MCP tool. The excerpt limit applies to every lane.",+ "link": "/markets/news",+ "tags": [+ "feature",+ "improvement"+ ]+ },{"date": "2026-10-23","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex 58f771c6f..ac76d4336 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -182,6 +182,14 @@<category>feature</category><description>A new scanner runs every 15 minutes over real market series (coin price, Solana TVL and stablecoin supply, stablecoin pegs, Hyperliquid funding and open interest) and records statistically scored anomalies with a medium, high or critical severity. Read them per call at /api/x402/market-anomalies ($0.001 USDC), or create a market_anomaly alert rule in alerts-mcp to be notified. Thin or flat series are skipped instead of guessed at.</description></item>+ <item>+ <title>News reader recovers blocked stories and gives a structured trading read</title>+ <link>https://three.ws/markets/news</link>+ <guid isPermaLink="false">2026-10-23:News reader recovers blocked stories and gives a structured trading read</guid>+ <pubDate>Fri, 23 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>When a publisher blocks or paywalls an article, the reader now recovers it from the Internet Archive, the SEC EDGAR filing the headline names, or other outlets covering the same story, and says which lane it used. The analysis is now a structured trading read: affected assets with exposure and direction, whether the news is priced in, the horizon, and a counter-argument. The same resolution is available to agents as the free news_resolve MCP tool. The excerpt limit applies to every lane.</description>+ </item><item><title>Onchain viewer reads multi-part memo inscriptions</title><link>https://three.ws/onchain</link>