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
fix(pump-mcp): teach the pump.fun MCP tools signed pool reserves, synthetic migration, and fee sweeps
nirholas11cd4d2d99ea
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 00841c278..a6be0b7d0 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -22,6 +22,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr- **One command sets up Grok Bot**: Run npx three-ws setup --client grok-bot to get the exact connector fields for Grok Bot, the server URL copied to your clipboard, and a live check that the public URL answers. Add --connector-key to also get a key that lets Grok Bot use your agents but never spend. (`/docs/cli`) `[feature]`- **One Grok Bot connector for 3D and your agents**: https://three.ws/api/mcp-grok is now the one URL to paste into Grok Bot. With no sign-in it is the free 3D studio: text or an image to a 3D model, a rigged avatar, or a talking persona, with links Grok can share. Sign the same URL in with OAuth at https://three.ws/api/mcp-grok?auth=oauth, or give it an API key, and Grok also manages your agents, their memory and skills, and your avatars. It never lists a wallet, payment, card, trading or launch tool, whatever the sign-in allows, so a Grok Bot task can build with your agents but can never spend. (`/docs/grok`) `[feature]`- **Paired coins: launch a coin on Robinhood Chain that trades against up to five assets at once**: A paired coin trades in up to five markets at the same time, each its own bonding curve: tokenized stocks, WETH, stablecoins or chain coins, in whatever split you choose. Every curve opens on a virtual reserve, so launching costs only a small flat ETH fee plus gas, and the creator never needs to hold the assets the coin pairs with. Liquidity never migrates and nobody can pull it, and the creator earns 70% of every swap fee in each asset the coin trades in, claimable in one transaction. Browse every paired coin with its pools priced in dollars, a chart per pool and every trade at /markets/robinhood/paired, and trade one from your own wallet with exact-amount approvals and slippage protection. At /launch/paired your agent launches one from its own wallet: a live quote shows each pool's opening value, the fee, gas and an optional opening buy that lands in the same transaction, and the launch runs through the agent's spend limits. Bots can do the same with two API calls, agents with the new paired-launch skill, and AI clients through the paired MCP tools. The developer guide is at /docs/paired-coins. (`/markets/robinhood/paired`) `[feature]`+- **pump.fun MCP tools explain the October program upgrade**: The hosted pump.fun MCP server now tells AI clients how pump.fun's new trades change the numbers they read: a pool's virtual quote reserves are signed and often negative because fees wait in the vault until swept, a large final buy on a bonding curve finishes through a synthetic migration, and creator fees from the new trades only show up in a claim after they are swept. Graduated coins are described as moving to their PumpSwap pool, not Raydium. `[fix]`- **Ready-made recipes for Grok Bot and other always-on agents**: The 3D Studio and Grok connectors now offer guided prompts written for an agent that runs on a schedule with nobody watching: a daily 3D brief that turns the top trending topic into a model and a poster image, a themed asset pack that uses the free catalog first and generates only the gaps, a rigged avatar from a photo, a quick tour, and a read-only status report on your agents. Each one names the exact tools, never stops to ask a question, and reuses a retry key so a repeated run collects the original model instead of generating twice. A new list_my_agents tool lets a signed-in connector see which agents your account holds. (`/grok`) `[feature]`- **Remesh reads FBX files, and stylize says plainly when it cannot**: The remesh tool now accepts a binary FBX for every operation, not only FBX-to-FBX conversion: convert it to GLB, OBJ or any other format, simplify it, repair it or retopologize it, even from a download link with no file extension. Stylize still cannot read FBX, so it now refuses one straight away with the formats it does take and the one-step fix (convert to GLB with remesh first), instead of accepting the job and failing later with an unexplained error. Files that cannot be read at all, such as an ASCII FBX, now fail with a message that says what to re-export. Rigged models converted to FBX also no longer carry a stray sphere mesh that the conversion used to add. (`/forge`) `[improvement, fix]`- **Safe retries and live status for 3D jobs**: The free 3D studio now has a get_job tool that reports a job's status, progress, time remaining, download links, or a failure with what to do next. Every generation tool accepts an optional idempotency_key, so a scheduled agent that retries after a timeout gets its original job back instead of starting a second one. Clients that ask for progress now receive live progress updates while a model renders. (`/docs/mcp-studio`) `[feature]`diff --git a/api/_lib/mcp-clients.js b/api/_lib/mcp-clients.jsindex 55ce1373b..37c4ee3e9 100644--- a/api/_lib/mcp-clients.js+++ b/api/_lib/mcp-clients.js@@ -121,7 +121,7 @@ export function issueSession(res, body, prefix = 'mcs') {if (!initializes(body)) return null;const id = `${prefix}_${randomUUID()}`;res.setHeader('mcp-session-id', id);- const exposed = res.getHeader('access-control-expose-headers');+ const exposed = typeof res.getHeader === 'function' ? res.getHeader('access-control-expose-headers') : undefined;res.setHeader('access-control-expose-headers', exposed ? `${exposed}, mcp-session-id` : 'mcp-session-id');return id;}diff --git a/data/changelog.json b/data/changelog.jsonindex 3822e49d4..8c41fa711 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,12 @@{"$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-09",+ "title": "pump.fun MCP tools explain the October program upgrade",+ "summary": "The hosted pump.fun MCP server now tells AI clients how pump.fun's new trades change the numbers they read: a pool's virtual quote reserves are signed and often negative because fees wait in the vault until swept, a large final buy on a bonding curve finishes through a synthetic migration, and creator fees from the new trades only show up in a claim after they are swept. Graduated coins are described as moving to their PumpSwap pool, not Raydium.",+ "tags": ["fix"]+ },{"date": "2026-10-09","title": "A skill file you can hand to Grok",diff --git a/packages/pumpfun-mcp/README.md b/packages/pumpfun-mcp/README.mdindex 863650cc5..d981370f7 100644--- a/packages/pumpfun-mcp/README.md+++ b/packages/pumpfun-mcp/README.md@@ -84,19 +84,19 @@ The hosted endpoint also serves three tools the table below does not list: `get_| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- || `search_tokens` | Search pump.fun tokens by name, symbol, or mint. || `get_token_details` | Full metadata for a mint. |-| `get_bonding_curve` | Real/virtual reserves + graduation progress (on-chain). |+| `get_bonding_curve` | Real/virtual quote reserves + graduation progress for a coin still on the curve (on-chain). A v3 buy that empties the curve finishes through a synthetic migration. || `get_token_trades` | Recent buy/sell history for a token. || `get_trending_tokens` | Top tokens by market cap. || `get_new_tokens` | Most recently launched tokens. |-| `get_graduated_tokens` | Tokens that graduated to the Raydium AMM. |+| `get_graduated_tokens` | Tokens that graduated to their PumpSwap pool. || `get_king_of_the_hill` | Highest-cap token still on the bonding curve. || `get_token_holders` | Top holders with concentration analysis (on-chain). || `get_creator_profile` | A creator's tokens with rug-pull risk flags. || `kol_leaderboard` | Top KOL traders ranked by P&L for a 24h/7d/30d window. |-| `pumpfun_list_claims` | Recent creator fee-claim events (on-chain). |+| `pumpfun_list_claims` | Recent creator fee-claim events (on-chain). Fees from v3 curve / v2 pool trades appear once swept. || `pumpfun_watch_claims` | Fee claims for a creator within a look-back window. || `pumpfun_first_claims` | First-ever creator claims — a cash-out signal. |-| `pumpfun_quote_swap` | Read-only pump.fun AMM swap quote (no signing). |+| `pumpfun_quote_swap` | Read-only PumpSwap AMM swap quote for a graduated coin (no signing). Prices on vault + signed, often negative, `virtual_quote_reserves`. || `pumpfun_watch_whales` | Collect large trades on a token over a short window. || `pumpfun_vanity_mint` | Grind a vanity Solana keypair (secret returned to caller, never stored). || `sns_resolve` | Resolve a `.sol` domain to its owner wallet. |@@ -108,6 +108,28 @@ The hosted endpoint also serves three tools the table below does not list: `get_The live tool list is fetched from the backend at startup; a bundled copy ships as an offline fallback so a fresh install always advertises a correct surface.+### How prices are derived++A pump.fun coin has two lifetimes, priced by two different on-chain accounts. Every tool here belongs to exactly one of them, and reading a number from the wrong one is the classic way to get a confidently wrong answer.++**Before graduation: the pump program `BondingCurve` account.** Spot price is `virtual_quote_reserves / virtual_token_reserves`. Those quote-side fields were renamed upstream (`virtual_sol_reserves` → `virtual_quote_reserves`, `real_sol_reserves` → `real_quote_reserves`) when a non-SOL quote asset became possible, and the curve gained a `quote_mint`, which is the SOL default on every coin created to date. The rename is the same u64 at the same offset, so the response fields `virtualSolReserves` / `solReserves` keep their names and stay SOL-denominated. Served by `get_bonding_curve` and `social_x_post_impact`.++**After graduation: the PumpSwap (`pump_amm`) `Pool` account.** Quotes price against the **effective** quote reserve:++```+effective_quote_reserves = pool_quote_token_account.amount + pool.virtual_quote_reserves+```++`pool.virtual_quote_reserves` is an appended `Pool` field, a **signed** `i128`. A positive value adds depth held outside the vault. Since 2026-09-30 it is commonly **negative**: the PumpSwap v2 trades (`buy_v2`, `sell_v2`, `buy_exact_quote_in_v2`) and `multi_hop_swap` keep the protocol and creator fee inside the quote vault until a sweep pays them out, and subtract that amount here so waiting fees never count as liquidity. So `quote_reserve` alone overstates depth, `effective_quote_reserve` can sit below it, and the program guarantees the sum is never negative. Read the field as a signed integer: never unsigned, never clamped to `0`, never absolute-valued. Pools created before the field existed read it as `0`. Buys and sells both price on the effective figure, and `priceImpactBps` measures execution against the spot price it implies, so virtual liquidity reads as depth rather than as impact. The **base** side is unchanged: still the raw `pool_base_token_account.amount`. Served by `pumpfun_quote_swap`.++The two `virtual_quote_reserves` are different fields on different accounts that happen to share a name. A coin has one or the other, never both. If `get_bonding_curve` returns `complete: true`, stop reading the curve and quote the pool.++**The handoff: synthetic migration.** A v3 bonding-curve buy (`buy_v3`, `buy_exact_quote_in_v3`) that empties the curve has no max size. It takes what the curve has left at the curve price, completes the curve, and buys the rest at the price the PumpSwap pool will open with, so a large final buy is not capped at `realTokenReserves`. Mayhem coins are excluded. After that buy every curve trade fails until the migration lands. Off-chain quoting uses `getBuyV3QuoteAmountFromTokenAmount` / `getBuyV3TokenAmountFromQuoteAmount` from `@pump-fun/pump-sdk` 4.0.0 with `curveBaseTokenBalance` from `fetchBuyState`.++**Creator fees wait until swept.** The v3 curve trades and v2 pool trades do not pay the creator fee out per trade; it waits on the curve (`BondingCurve.creator_fee`) and pool (`Pool.creator_fees`) until a `sweep_creator_fee` moves it to the creator vault, normally right before the claim in the same transaction. The claim tools report claimed amounts, so fees still waiting on the curve or pool appear in no claim until they are swept.++Upstream reference: [pump-public-docs](https://github.com/pump-fun/pump-public-docs), in particular `NEGATIVE_VIRTUAL_QUOTE_RESERVES.md`, `SYNTHETIC_MIGRATION.md` and `instructions/SWEEP_FEES.md`.+### Inspect the tools```bashdiff --git a/packages/pumpfun-mcp/src/tools.js b/packages/pumpfun-mcp/src/tools.jsindex 1edb851f6..fdabcc5de 100644--- a/packages/pumpfun-mcp/src/tools.js+++ b/packages/pumpfun-mcp/src/tools.js@@ -21,11 +21,20 @@//// Post-graduation · PumpSwap (pump_amm) Pool account. Quotes price against the// EFFECTIVE quote reserve, pool_quote_token_account.amount +-// pool.virtual_quote_reserves, a field appended to Pool that carries a-// non-zero value on boost pools from 2026-07-20. It is an i128, so it is-// signed and effective depth can fall below the raw vault balance. The base-// side is unchanged: still the raw pool_base_token_account.amount. Surfaced-// by pumpfun_quote_swap.+// pool.virtual_quote_reserves, a field appended to Pool. It is an i128 and+// commonly NEGATIVE: since 2026-09-30 the PumpSwap v2 trades and+// multi_hop_swap keep the protocol and creator fee inside the quote vault+// until a sweep pays them out, and subtract that amount here so waiting+// fees never count as liquidity. Effective depth can therefore sit below+// the raw vault balance; the program guarantees it is never negative. The+// base side is unchanged: still the raw pool_base_token_account.amount.+// Surfaced by pumpfun_quote_swap.+//+// The handoff · the v3 buy (buy_v3 / buy_exact_quote_in_v3) that empties a+// curve has no max size: it completes the curve and buys the rest through a+// synthetic migration, priced on the reserves the pool will open with. Once+// complete=true every curve trade fails until migration lands, so callers+// move to the pool.//// The two virtual_quote_reserves are DIFFERENT fields, on DIFFERENT accounts,// with DIFFERENT widths, that happen to share a name. A coin has one or the@@ -177,8 +186,11 @@ export const FALLBACK_TOOLS = ['PumpSwap pool. Pump renamed the quote-side fields (real_sol_reserves → real_quote_reserves, ' +'virtual_sol_reserves → virtual_quote_reserves) when a non-SOL quote asset became possible; the ' +'response keys below keep their original names and are still denominated in SOL, because the curve ' +- 'quote_mint is the SOL default on every coin created to date. Once complete=true the curve is ' +- 'retired and pricing moves to the PumpSwap pool, so use pumpfun_quote_swap from that point on.',+ 'quote_mint is the SOL default on every coin created to date. A v3 buy that empties the curve ' ++ 'completes it and buys the rest through a synthetic migration, priced on the reserves the ' ++ 'PumpSwap pool will open with, so a large final buy is not capped at realTokenReserves. Once ' ++ 'complete=true the curve is retired and pricing moves to the PumpSwap pool, so use ' ++ 'pumpfun_quote_swap from that point on.',inputSchema: {type: 'object',properties: {@@ -258,7 +270,7 @@ export const FALLBACK_TOOLS = [},{name: 'get_graduated_tokens',- description: 'Tokens that graduated from the bonding curve to Raydium AMM.',+ description: 'Tokens that graduated from the bonding curve to their PumpSwap (pump_amm) pool.',inputSchema: {type: 'object',properties: { limit: { type: 'integer', minimum: 1, maximum: 50, default: 10 } },@@ -334,7 +346,10 @@ export const FALLBACK_TOOLS = [{name: 'pumpfun_list_claims',description:- 'List recent pump.fun fee-claim events for a creator wallet (on-chain, no indexer needed). Returns signature, mint, lamports, and Unix timestamp for each claim.',+ 'List recent pump.fun fee-claim events for a creator wallet (on-chain, no indexer needed). Returns signature, mint, lamports, and Unix timestamp for each claim. ' ++ 'Creator fees from the v3 curve and v2 pool trades wait on the curve and pool until a ' ++ 'sweep_creator_fee moves them to the creator vault, so a claim covers only what was swept ' ++ '(usually in the same transaction) and fees still waiting appear in no claim yet.',inputSchema: {type: 'object',properties: {@@ -447,7 +462,8 @@ export const FALLBACK_TOOLS = ['sending. One of inputMint/outputMint must be wSOL (So11111111111111111111111111111111111111112). ' +'Returns amountOut, priceImpactBps, route, expiresAtMs. Pricing follows PumpSwap exactly: the ' +'quote side is the EFFECTIVE reserve, pool_quote_token_account.amount + pool.virtual_quote_reserves ' +- '(non-zero on launchpad coins since 2026-07-20), while the base side is the raw ' ++ '(a SIGNED i128, commonly negative because PumpSwap v2 trades keep waiting protocol and creator ' ++ 'fees in the vault and subtract them there), while the base side is the raw ' +'pool_base_token_account.amount, unchanged. Coins still on the bonding curve have no pool, so use ' +'get_bonding_curve instead. The quote is a snapshot: honour expiresAtMs and re-quote after it.',inputSchema: {@@ -501,17 +517,23 @@ export const FALLBACK_TOOLS = [quote_reserve: {type: 'string',description:- 'Raw quote vault balance (pool_quote_token_account.amount), before virtual reserves.',+ 'Raw quote vault balance (pool_quote_token_account.amount), before virtual reserves. ' ++ 'Includes protocol and creator fees waiting for a sweep, so it overstates liquidity on ' ++ 'its own; price on effective_quote_reserve.',},virtual_quote_reserves: {type: 'string',description:- 'Pool.virtual_quote_reserves, an i128. Quote-side liquidity held outside the vault. 0 on non-boost pools. SIGNED: may be negative, so do not parse it unsigned.',+ 'Pool.virtual_quote_reserves, a SIGNED i128 serialized as a decimal string. Positive values ' ++ 'add depth held outside the vault; negative values remove fees that sit in the vault ' ++ 'waiting for a sweep (common since the PumpSwap v2 trades). Parse it as a signed ' ++ 'integer: never unsigned, never clamped to 0, never absolute-valued.',},effective_quote_reserve: {type: 'string',description:- 'quote_reserve + virtual_quote_reserves. The reserve the quote is actually priced against.',+ 'quote_reserve + virtual_quote_reserves. The reserve the quote is actually priced against. ' ++ 'Never negative (the program guarantees it); may be below quote_reserve.',},},required: ['amountOut', 'priceImpactBps', 'route', 'expiresAtMs'],diff --git a/packages/pumpfun-mcp/test/tools.test.mjs b/packages/pumpfun-mcp/test/tools.test.mjsindex 17b01d814..236225c3d 100644--- a/packages/pumpfun-mcp/test/tools.test.mjs+++ b/packages/pumpfun-mcp/test/tools.test.mjs@@ -134,6 +134,80 @@ test('inputSchema integrity: required fields exist and defaults respect their bo}});+// A pump.fun coin is priced by the bonding curve before graduation and by the+// PumpSwap pool after it. Both accounts now carry a field spelled+// virtual_quote_reserves, and they are NOT the same quantity. These tools are+// read by a model with no human in the loop, so each pricing tool has to say+// which account it reads. Dropping that wording is a real regression: it lets a+// caller apply pool math to curve reserves (or vice versa) and get a confidently+// wrong price with no error anywhere.+const byName = (name) => {+ const tool = FALLBACK_TOOLS.find((t) => t.name === name);+ assert.ok(tool, `${name}: missing from FALLBACK_TOOLS`);+ return tool;+};++test('get_bonding_curve documents the renamed quote-side curve fields', () => {+ const tool = byName('get_bonding_curve');+ assert.match(tool.description, /bonding[- ]curve account/i);+ assert.match(tool.description, /virtual_quote_reserves/);+ // The rename is the trap: a decoder still reading virtual_sol_reserves gets+ // undefined, which coerces to a 0 price rather than throwing.+ assert.match(tool.description, /virtual_sol_reserves/);+ // Reserve fields must name their on-chain source so the rename is traceable.+ const props = tool.outputSchema.properties;+ assert.match(props.solReserves.description, /real_quote_reserves/);+ assert.match(props.virtualSolReserves.description, /virtual_quote_reserves/);+});++test('pumpfun_quote_swap documents pricing against effective quote reserves', () => {+ const tool = byName('pumpfun_quote_swap');+ // effective = vault balance + pool.virtual_quote_reserves.+ assert.match(tool.description, /effective/i);+ assert.match(tool.description, /pool\.virtual_quote_reserves/);+ assert.match(tool.description, /pool_quote_token_account\.amount/);+ // The base side is explicitly unchanged upstream, so the description says so.+ // Without it, a reader may "symmetrically" add a virtual figure to the base.+ assert.match(tool.description, /pool_base_token_account\.amount/);+ assert.match(tool.outputSchema.properties.priceImpactBps.description, /effective quote reserve/i);+});++// Since 2026-09-30 Pool.virtual_quote_reserves is commonly negative: PumpSwap v2+// trades keep waiting protocol and creator fees in the quote vault and subtract+// them there. A model told the field is "0 on most pools" or allowed to read it+// unsigned overstates depth by exactly the waiting fees.+test('pumpfun_quote_swap says virtual_quote_reserves is signed and commonly negative', () => {+ const tool = byName('pumpfun_quote_swap');+ const props = tool.outputSchema.properties;+ assert.match(tool.description, /signed/i);+ assert.match(tool.description, /negative/i);+ const virt = props.virtual_quote_reserves.description;+ assert.match(virt, /i128/);+ assert.match(virt, /signed/i);+ assert.match(virt, /negative/i);+ assert.match(virt, /never unsigned/i);+ assert.match(virt, /never clamped/i);+ // The stale claim that non-boost pools always read 0 must not come back.+ assert.doesNotMatch(virt, /0 on non-boost pools/);+ assert.doesNotMatch(tool.description, /non-zero on launchpad coins/);+ // The raw vault includes fees waiting for a sweep, so it is not depth.+ assert.match(props.quote_reserve.description, /waiting/i);+ assert.match(props.effective_quote_reserve.description, /never negative/i);+});++test('get_bonding_curve documents the synthetic migration handoff', () => {+ const tool = byName('get_bonding_curve');+ assert.match(tool.description, /v3 buy/);+ assert.match(tool.description, /synthetic migration/i);+ assert.match(tool.description, /complete=true/);+});++test('claim tools explain that v3 and v2 creator fees appear only once swept', () => {+ const tool = byName('pumpfun_list_claims');+ assert.match(tool.description, /sweep_creator_fee/);+ assert.match(tool.description, /creator vault/);+});+test('native composed tools carry the same annotation contract', () => {assert.ok(NATIVE_TOOLS.length > 0);const fallbackNames = new Set(FALLBACK_TOOLS.map((t) => t.name));diff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex 22de1c1f1..871e5dca6 100644--- a/public/changelog-recent.json+++ b/public/changelog-recent.json@@ -1,11 +1,11 @@{- "generated_at": "2026-10-09T04:16:42.903Z",+ "generated_at": "2026-10-09T04:19:53.652Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},- "total": 3860,+ "total": 3861,"complete": false,"full_feed": "/changelog.json","entries": [@@ -175,6 +175,16 @@"feature"]},+ {+ "date": "2026-10-09",+ "type": "update",+ "title": "pump.fun MCP tools explain the October program upgrade",+ "summary": "The hosted pump.fun MCP server now tells AI clients how pump.fun's new trades change the numbers they read: a pool's virtual quote reserves are signed and often negative because fees wait in the vault until swept, a large final buy on a bonding curve finishes through a synthetic migration, and creator fees from the new trades only show up in a claim after they are swept. Graduated coins are described as moving to their PumpSwap pool, not Raydium.",+ "link": null,+ "tags": [+ "fix"+ ]+ },{"date": "2026-10-09","type": "update",@@ -1541,17 +1551,6 @@"feature","sdk"]- },- {- "date": "2026-09-18",- "type": "update",- "title": "469 generated animations in the library, and for sale as rigged GLBs",- "summary": "The animation library now carries 469 clips generated on our own motion model, covering 175 prompts across walks, idles, gestures, dance, combat, sport, reactions and more. Every one passed the quality gate that checks for sliding feet, sudden jumps and broken loops, and fewer than three in ten takes were thrown away. While checking them on a real avatar we found that every generated clip, including the ones already live, played with the head thrown back and the arms raised, because the model describes its skeleton with the arms hanging and the head in front of the neck. That is fixed, walks now travel instead of skating in place, and a foot flicker is smoothed out. The same fix applies when you generate a motion from a prompt in the Animation Studio. Each clip is also listed in the marketplace as a GLB on the three.ws rig that opens in Blender, Unity or Unreal, for 0.01 USDC through the x402 download, and a rotating set of twelve is free each week.",- "link": "/animations",- "tags": [- "feature",- "fix"- ]}]}diff --git a/public/changelog.json b/public/changelog.jsonindex e00074e6f..02feca6a5 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-09T04:16:42.879Z",+ "generated_at": "2026-10-09T04:19:53.629Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -172,6 +172,16 @@"feature"]},+ {+ "date": "2026-10-09",+ "type": "update",+ "title": "pump.fun MCP tools explain the October program upgrade",+ "summary": "The hosted pump.fun MCP server now tells AI clients how pump.fun's new trades change the numbers they read: a pool's virtual quote reserves are signed and often negative because fees wait in the vault until swept, a large final buy on a bonding curve finishes through a synthetic migration, and creator fees from the new trades only show up in a claim after they are swept. Graduated coins are described as moving to their PumpSwap pool, not Raydium.",+ "link": null,+ "tags": [+ "fix"+ ]+ },{"date": "2026-10-09","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex 6e15fe875..efbe3cebe 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -134,6 +134,14 @@<category>feature</category><description>A paired coin trades in up to five markets at the same time, each its own bonding curve: tokenized stocks, WETH, stablecoins or chain coins, in whatever split you choose. Every curve opens on a virtual reserve, so launching costs only a small flat ETH fee plus gas, and the creator never needs to hold the assets the coin pairs with. Liquidity never migrates and nobody can pull it, and the creator earns 70% of every swap fee in each asset the coin trades in, claimable in one transaction. Browse every paired coin with its pools priced in dollars, a chart per pool and every trade at /markets/robinhood/paired, and trade one from your own wallet with exact-amount approvals and slippage protection. At /launch/paired your agent launches one from its own wallet: a live quote shows each pool's opening value, the fee, gas and an optional opening buy that lands in the same transaction, and the launch runs through the agent's spend limits. Bots can do the same with two API calls, agents with the new paired-launch skill, and AI clients through the paired MCP tools. The developer guide is at /docs/paired-coins.</description></item>+ <item>+ <title>pump.fun MCP tools explain the October program upgrade</title>+ <link>https://three.ws/changelog</link>+ <guid isPermaLink="false">2026-10-09:pump.fun MCP tools explain the October program upgrade</guid>+ <pubDate>Fri, 09 Oct 2026 12:00:00 GMT</pubDate>+ <category>fix</category>+ <description>The hosted pump.fun MCP server now tells AI clients how pump.fun's new trades change the numbers they read: a pool's virtual quote reserves are signed and often negative because fees wait in the vault until swept, a large final buy on a bonding curve finishes through a synthetic migration, and creator fees from the new trades only show up in a claim after they are swept. Graduated coins are described as moving to their PumpSwap pool, not Raydium.</description>+ </item><item><title>Ready-made recipes for Grok Bot and other always-on agents</title><link>https://three.ws/grok</link>diff --git a/public/mcp-catalog.json b/public/mcp-catalog.jsonindex ed90d4c1c..afdffb934 100644--- a/public/mcp-catalog.json+++ b/public/mcp-catalog.json@@ -18160,7 +18160,7 @@{"name": "get_bonding_curve","title": null,- "description": "Bonding curve analysis: real reserves, virtual reserves, and graduation progress (on-chain). Pre-graduation only: these reserves come from the pump program bonding-curve account, not from a PumpSwap pool. Pump renamed the quote-side fields on-chain (real_sol_reserves -> real_quote_reserves, virtual_sol_reserves -> virtual_quote_reserves) once a non-SOL quote asset became possible; the response keys below keep their original names and are still denominated in SOL, because the curve quote_mint is the SOL default on every coin created to date. Once complete=true the curve is retired and pricing moves to the PumpSwap pool, so use pumpfun_quote_swap from that point on.",+ "description": "Bonding curve analysis: real reserves, virtual reserves, and graduation progress (on-chain). Pre-graduation only: these reserves come from the pump program bonding-curve account, not from a PumpSwap pool. Pump renamed the quote-side fields on-chain (real_sol_reserves -> real_quote_reserves, virtual_sol_reserves -> virtual_quote_reserves) once a non-SOL quote asset became possible; the response keys below keep their original names and are still denominated in SOL, because the curve quote_mint is the SOL default on every coin created to date. A v3 buy that empties the curve completes it and buys the rest through a synthetic migration, priced on the reserves the PumpSwap pool will open with, so a large final buy is not capped at realTokenReserves. Once complete=true the curve is retired and pricing moves to the PumpSwap pool, so use pumpfun_quote_swap from that point on.","server": {"id": "threews-pumpfun","title": "pump.fun",@@ -18282,7 +18282,7 @@{"name": "get_graduated_tokens","title": null,- "description": "Tokens that graduated from the bonding curve to Raydium AMM.",+ "description": "Tokens that graduated from the bonding curve to their PumpSwap (pump_amm) pool.","server": {"id": "threews-pumpfun","title": "pump.fun",@@ -18699,7 +18699,7 @@{"name": "pumpfun_list_claims","title": null,- "description": "List recent pump.fun fee-claim events for a creator wallet (on-chain, no indexer needed). Returns signature, mint, lamports, and Unix timestamp for each claim.",+ "description": "List recent pump.fun fee-claim events for a creator wallet (on-chain, no indexer needed). Returns signature, mint, lamports, and Unix timestamp for each claim. Creator fees from the v3 curve and v2 pool trades wait on the curve and pool until a sweep_creator_fee moves them to the creator vault, so a claim covers only what was swept (usually in the same transaction) and fees still waiting appear in no claim yet.","server": {"id": "threews-pumpfun","title": "pump.fun",@@ -18749,7 +18749,7 @@{"name": "pumpfun_quote_swap","title": null,- "description": "Read-only price quote for a pump.fun AMM (PumpSwap) swap. No signing or tx sending. One of inputMint/outputMint must be wSOL (So11111111111111111111111111111111111111112). Only GRADUATED coins have an AMM pool; for a coin still on its bonding curve use get_bonding_curve instead. Pricing runs on the pool effective quote reserves (quote vault balance + pool.virtual_quote_reserves); the base side is the raw base vault balance. Returns amountOut, priceImpactBps, route, expiresAtMs, plus the reserves the quote was computed from so the number can be reproduced.",+ "description": "Read-only price quote for a pump.fun AMM (PumpSwap) swap. No signing or tx sending. One of inputMint/outputMint must be wSOL (So11111111111111111111111111111111111111112). Only GRADUATED coins have an AMM pool; for a coin still on its bonding curve use get_bonding_curve instead. Pricing runs on the pool effective quote reserves (quote vault balance + pool.virtual_quote_reserves, a SIGNED i128 that is commonly negative because PumpSwap v2 trades keep waiting protocol and creator fees in the vault and subtract them there); the base side is the raw base vault balance. Returns amountOut, priceImpactBps, route, expiresAtMs, plus the reserves the quote was computed from so the number can be reproduced.","server": {"id": "threews-pumpfun","title": "pump.fun",diff --git a/src/pump/mcp-tools.js b/src/pump/mcp-tools.jsindex 141039c94..1b201808c 100644--- a/src/pump/mcp-tools.js+++ b/src/pump/mcp-tools.js@@ -17,11 +17,20 @@//// Post-graduation · PumpSwap (pump_amm) Pool account. Quotes price against the// EFFECTIVE quote reserve: pool_quote_token_account.amount +-// pool.virtual_quote_reserves, a field appended to Pool that carries a-// non-zero value on boost pools from 2026-07-20. It is an i128, so it is-// signed and effective depth can fall below the raw vault balance. The base-// side is unchanged: still the raw pool_base_token_account.amount. Surfaced-// by pumpfun_quote_swap.+// pool.virtual_quote_reserves, a field appended to Pool. It is an i128 and+// commonly NEGATIVE: since 2026-09-30 the PumpSwap v2 trades and+// multi_hop_swap keep the protocol and creator fee inside the quote vault+// until a sweep pays them out, and subtract that amount here so waiting+// fees never count as liquidity. Effective depth can therefore sit below+// the raw vault balance; the program guarantees it is never negative. The+// base side is unchanged: still the raw pool_base_token_account.amount.+// Surfaced by pumpfun_quote_swap.+//+// The handoff · the v3 buy (buy_v3 / buy_exact_quote_in_v3) that empties a+// curve has no max size: it completes the curve and buys the rest through a+// synthetic migration, priced on the reserves the pool will open with. Once+// complete=true every curve trade fails until migration lands, so callers+// move to the pool.//// The two virtual_quote_reserves are DIFFERENT fields, on DIFFERENT accounts,// with DIFFERENT widths, that happen to share a name. A coin has one or the@@ -172,8 +181,11 @@ export const TOOLS = ['PumpSwap pool. Pump renamed the quote-side fields on-chain (real_sol_reserves -> real_quote_reserves, ' +'virtual_sol_reserves -> virtual_quote_reserves) once a non-SOL quote asset became possible; the ' +'response keys below keep their original names and are still denominated in SOL, because the curve ' +- 'quote_mint is the SOL default on every coin created to date. Once complete=true the curve is retired ' +- 'and pricing moves to the PumpSwap pool, so use pumpfun_quote_swap from that point on.',+ 'quote_mint is the SOL default on every coin created to date. A v3 buy that empties the curve ' ++ 'completes it and buys the rest through a synthetic migration, priced on the reserves the ' ++ 'PumpSwap pool will open with, so a large final buy is not capped at realTokenReserves. Once ' ++ 'complete=true the curve is retired and pricing moves to the PumpSwap pool, so use ' ++ 'pumpfun_quote_swap from that point on.',inputSchema: {type: 'object',properties: {@@ -237,7 +249,7 @@ export const TOOLS = [},{name: 'get_graduated_tokens',- description: 'Tokens that graduated from the bonding curve to Raydium AMM.',+ description: 'Tokens that graduated from the bonding curve to their PumpSwap (pump_amm) pool.',inputSchema: {type: 'object',properties: { limit: { type: 'integer', minimum: 1, maximum: 50, default: 10 } },@@ -315,7 +327,7 @@ export const TOOLS = [{name: 'pumpfun_list_claims',description:- 'List recent pump.fun fee-claim events for a creator wallet (on-chain, no indexer needed). Returns signature, mint, lamports, and Unix timestamp for each claim.',+ 'List recent pump.fun fee-claim events for a creator wallet (on-chain, no indexer needed). Returns signature, mint, lamports, and Unix timestamp for each claim. Creator fees from the v3 curve and v2 pool trades wait on the curve and pool until a sweep_creator_fee moves them to the creator vault, so a claim covers only what was swept (usually in the same transaction) and fees still waiting appear in no claim yet.',inputSchema: {type: 'object',properties: {@@ -462,7 +474,7 @@ export const TOOLS = [{name: 'pumpfun_quote_swap',description:- 'Read-only price quote for a pump.fun AMM (PumpSwap) swap. No signing or tx sending. One of inputMint/outputMint must be wSOL (So11111111111111111111111111111111111111112). Only GRADUATED coins have an AMM pool; for a coin still on its bonding curve use get_bonding_curve instead. Pricing runs on the pool effective quote reserves (quote vault balance + pool.virtual_quote_reserves); the base side is the raw base vault balance. Returns amountOut, priceImpactBps, route, expiresAtMs, plus the reserves the quote was computed from so the number can be reproduced.',+ 'Read-only price quote for a pump.fun AMM (PumpSwap) swap. No signing or tx sending. One of inputMint/outputMint must be wSOL (So11111111111111111111111111111111111111112). Only GRADUATED coins have an AMM pool; for a coin still on its bonding curve use get_bonding_curve instead. Pricing runs on the pool effective quote reserves (quote vault balance + pool.virtual_quote_reserves, a SIGNED i128 that is commonly negative because PumpSwap v2 trades keep waiting protocol and creator fees in the vault and subtract them there); the base side is the raw base vault balance. Returns amountOut, priceImpactBps, route, expiresAtMs, plus the reserves the quote was computed from so the number can be reproduced.',inputSchema: {type: 'object',properties: {@@ -487,17 +499,20 @@ export const TOOLS = [},quote_reserve: {type: 'string',- description: 'Raw quote vault balance, before virtual reserves are added.',+ description: 'Raw quote vault balance, before virtual reserves are added. Includes protocol and creator fees waiting for a sweep, so it overstates liquidity on its own; price on effective_quote_reserve.',},virtual_quote_reserves: {type: 'string',description:- 'Pool.virtual_quote_reserves. Quote-side liquidity the pool carries outside its vault. 0 on non-launchpad pools.',+ 'Pool.virtual_quote_reserves, a SIGNED i128 serialized as a decimal string. Positive values ' ++ 'add depth held outside the vault; negative values remove fees that sit in the vault ' ++ 'waiting for a sweep (common since the PumpSwap v2 trades). Parse it as a signed ' ++ 'integer: never unsigned, never clamped to 0, never absolute-valued.',},effective_quote_reserve: {type: 'string',description:- 'quote_reserve + virtual_quote_reserves. This is what the quote is priced against.',+ 'quote_reserve + virtual_quote_reserves (signed addition). This is what the quote is priced against; the program guarantees it is never negative.',},},required: ['amountOut', 'priceImpactBps', 'route', 'expiresAtMs'],diff --git a/tests/fixtures/mcp-golden-tools.json b/tests/fixtures/mcp-golden-tools.jsonindex 1e69b2065..2d64d1dbb 100644--- a/tests/fixtures/mcp-golden-tools.json+++ b/tests/fixtures/mcp-golden-tools.json@@ -4378,8 +4378,8 @@},{"name": "get_graduated_tokens",- "descHead": "Tokens that graduated from the bonding curve to Raydium AMM.",- "descHash": "b9156b64cef8",+ "descHead": "Tokens that graduated from the bonding curve to their PumpSwap (pump_amm",+ "descHash": "c5d541ec3a11","schemaHash": "d99491585978"},{@@ -4445,13 +4445,13 @@{"name": "pumpfun_list_claims","descHead": "List recent pump.fun fee-claim events for a creator wallet (on-chain, no",- "descHash": "2f700653d228",+ "descHash": "5eeeab19ee14","schemaHash": "ed5b74ae7e58"},{"name": "pumpfun_quote_swap","descHead": "Read-only price quote for a pump.fun AMM (PumpSwap) swap. No signing or ",- "descHash": "8e5de97f6929",+ "descHash": "0c6ad3619605","schemaHash": "6174606137d0"},{