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(changelog): tell holders the MCP servers now explain a failed call, and ship the examples

nirholas2047d53c5a97
diff --git a/data/changelog.json b/data/changelog.json
index ec93c1fd9..a8e70109c 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -1,6 +1,62 @@
{
"$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. `link` is optional and must be a live three.ws path.",
"entries": [
+ {
+ "date": "2026-08-16",
+ "title": "Token sentiment reads real pump.fun commentary again",
+ "summary": "The sentiment pulse for a Solana token was reading a pump.fun route that no longer exists, so it scored an empty set and reported every coin as perfectly neutral with full confidence. It now reads the coin's live callouts, the commentary feed the pump.fun coin page renders, and when that source is unreachable and you supplied no text of your own it says so with an error instead of returning a neutral-looking score. The scorer itself was also matching lexicon terms inside longer words, which read 'partnered' as bearish; it now matches whole words and knows the common variants (scammer, rugged, crashing, bought).",
+ "tags": [
+ "fix",
+ "improvement"
+ ],
+ "link": "/tutorials/emotion-from-data"
+ },
+ {
+ "date": "2026-08-16",
+ "title": "Agent attestations that stopped indexing now recover on their own",
+ "summary": "An agent's on-chain attestation history is indexed by walking Solana signatures newer than the last one we recorded. If that recorded signature aged out of the RPC node's history, the walk failed outright and kept failing: the same dead signature was replayed on every run, so that agent's attestations silently stopped appearing on its profile while the scheduled job still reported success. The crawler now recognises that case, re-scans from the most recent signatures instead, and clears the stale marker, so an agent that fell behind catches up by itself on the next pass.",
+ "tags": [
+ "fix",
+ "infra"
+ ]
+ },
+ {
+ "date": "2026-08-16",
+ "title": "The creations gallery now counts every creation a creator has made, and pages all the way to the end",
+ "summary": "The gallery ranked creators and paged the feed over only the newest 120 creations, however many the feed actually held. A creator's older work was invisible in their profile count, the top-creator board scored people on a fraction of their output, and scrolling the gallery dead-ended early with items still left to show. It now reads the full feed depth it always meant to, and does it in two database round trips instead of two per item, so the deeper read loads faster than the shallow one did.",
+ "tags": [
+ "fix",
+ "improvement"
+ ],
+ "link": "/creations"
+ },
+ {
+ "date": "2026-08-16",
+ "title": "The KOL, Loom and marketplace MCP servers now tell you why a call failed, and ship runnable examples",
+ "summary": "When a market-data provider was rate-limited, these servers passed back only a bare code like provider_unavailable and threw away the sentence explaining it. They now surface the full reason. The KOL portfolio tool used to answer a provider outage with an empty card that read as a quiet wallet with no trades; it now reports the outage as an outage, so nobody sizes up a trader from a blank. The KOL and Loom packages also gained runnable examples that talk to the live public API, and the naming SDK now answers an unregistered .eth name the same way it answers an unclaimed .sol one, with data instead of an exception.",
+ "tags": [
+ "fix",
+ "sdk"
+ ]
+ },
+ {
+ "date": "2026-08-16",
+ "title": "The agent wallet MCP server now quotes its own address when it asks an agent to pay",
+ "summary": "Agents that connect to the wallet server at /api/mcp-agent without a three.ws account can pay per call in USDC instead. The payment request it handed back named the main three.ws MCP server, not itself, so a paying agent signed a payment scoped to an endpoint it had not called and service directories listed the wallet server under the wrong description and tool list. It now describes itself: its own address, its own wallet-and-payments summary, and a directory example that only searches for services rather than spending anything. Separately, the one-sentence agent builder no longer mangles accented names when it suggests a handle: Munz now becomes munz rather than mu-nz.",
+ "tags": [
+ "fix"
+ ],
+ "link": "/docs/mcp-agent"
+ },
+ {
+ "date": "2026-08-16",
+ "title": "Creator subscription tiers save their edits again, and a mistyped subscription link says so plainly",
+ "summary": "Editing an existing subscription tier from the creator dashboard silently failed: the save never reached the server, so the new name, price or status was lost every time. Saving works now. Alongside it, a mistyped or truncated subscription or tier link used to answer with a generic server failure; it now says the id is not valid, which is what a reader can actually act on. Tier pages are also directly addressable, so a single tier can be linked and read on its own, with unpublished drafts still visible only to the creator who wrote them.",
+ "tags": [
+ "fix",
+ "improvement"
+ ]
+ },
{
"date": "2026-08-16",
"title": "The $THREE price quote survives an out-of-range dollar amount, and the payment audit log is admin-only for real",
diff --git a/packages/kol-mcp/package.json b/packages/kol-mcp/package.json
index cc757a39d..ab112bd53 100644
--- a/packages/kol-mcp/package.json
+++ b/packages/kol-mcp/package.json
@@ -30,6 +30,7 @@
},
"files": [
"src",
+ "examples",
"server.json",
"README.md",
"LICENSE"
diff --git a/packages/loom-mcp/package.json b/packages/loom-mcp/package.json
index 18d0df770..e5a6b4c4c 100644
--- a/packages/loom-mcp/package.json
+++ b/packages/loom-mcp/package.json
@@ -30,6 +30,7 @@
},
"files": [
"src",
+ "examples",
"server.json",
"README.md",
"LICENSE"
diff --git a/packages/marketplace-mcp/package.json b/packages/marketplace-mcp/package.json
index 7c5b20fa0..6aeef86e6 100644
--- a/packages/marketplace-mcp/package.json
+++ b/packages/marketplace-mcp/package.json
@@ -28,6 +28,7 @@
},
"files": [
"src",
+ "examples",
"server.json",
"README.md",
"LICENSE"
diff --git a/public/mcp-catalog.json b/public/mcp-catalog.json
index ff3ba3ae1..2a19ebb71 100644
--- a/public/mcp-catalog.json
+++ b/public/mcp-catalog.json
@@ -6127,7 +6127,7 @@
{
"name": "get_wallet_portfolio",
"title": "KOL wallet portfolio + P&L",
- "description": "Pull one KOL trader's live portfolio card from three.ws. Returns current holdings (total USD value, position count, and the single highest-value token the wallet holds) from the Birdeye proxy, plus realized P&L, win rate, trade count and volume over the last 30 days FIFO-computed from that wallet's own on-chain trades. Use this to size up a specific smart trader before copying or analyzing them. For ranking many traders at once use intel-mcp `kol_leaderboard`; this is the per-wallet deep dive. A null P&L field (with `pnl_source: null`) means three.ws has no trade history for that wallet in the window, which is an honest \"unknown\", NOT a flat or losing record: never report it as zero profit. `has_activity:false` means no holdings and no trades. Read-only live data.",
+ "description": "Pull one KOL trader's live portfolio card from three.ws. Returns current holdings (total USD value, position count, and the single highest-value token the wallet holds) from the Birdeye proxy, plus realized P&L, win rate, trade count and volume over the last 30 days FIFO-computed from that wallet's own on-chain trades. Use this to size up a specific smart trader before copying or analyzing them. For ranking many traders at once use intel-mcp `kol_leaderboard`; this is the per-wallet deep dive. A null P&L field (with `pnl_source: null`) means three.ws has no trade history for that wallet in the window, which is an honest \"unknown\", NOT a flat or losing record: never report it as zero profit. `has_activity:false` means no holdings and no trades. If the holdings provider is down or rate-limited the call fails with `upstream_unavailable` rather than answering with an empty card, so an outage is never reported as a quiet wallet. Read-only live data.",
"server": {
"id": "kol-mcp",
"title": "@three-ws/kol-mcp",
@@ -7022,6 +7022,11 @@
"maximum": 365,
"default": 30,
"description": "Days of price history for the chart, 1–365 (default 30)."
+ },
+ "chain_id": {
+ "type": "integer",
+ "exclusiveMinimum": 0,
+ "description": "Optional EVM chain id (8453 Base, 1 Ethereum, 42161 Arbitrum, …). Pins which chain the contract is priced on; defaults to the chain of the wallets holding it. Ignored on solana."
}
},
"required": [
@@ -7107,7 +7112,7 @@
{
"name": "get_trades_feed",
"title": "Public closed-trade PnL feed",
- "description": "The public feed of notable CLOSED positions across all three.ws agents, newest exit first — the canonical source of realized PnL on the platform. Each item carries the coin (mint, symbol, name), the trader (agent_id, agent_name, copier_count), entry_sol / exit_sol / realized_pnl_sol / realized_pnl_pct / multiple, hold_seconds, exit_reason, the buy/sell signatures, and oracle conviction context when the coin was scored. Filter by `mint` to see every closed trade on one coin (the time window is ignored when a mint is set). Paginate with `cursor` = the previous response's `next_cursor`. No auth required — read-only live data.",
+ "description": "The public feed of notable CLOSED positions across all three.ws agents, newest exit first — the canonical source of realized PnL on the platform. Each item carries the coin (mint, symbol, name), the trader (agent_id, agent_name, copier_count), entry_sol / exit_sol / realized_pnl_sol / realized_pnl_pct / multiple, where realized_pnl_pct and multiple are the whole position's return across every sell leg while entry_sol and exit_sol describe the remaining cost basis and the closing leg only, hold_seconds, exit_reason, the buy/sell signatures, and oracle conviction context when the coin was scored. Filter by `mint` to see every closed trade on one coin (the time window is ignored when a mint is set). Paginate with `cursor` = the previous response's `next_cursor`. No auth required — read-only live data.",
"server": {
"id": "portfolio-mcp",
"title": "@three-ws/portfolio-mcp",