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
feat(mcp): add a dry-run-first registry deprecate path, sync solana-memo-media-mcp to npm 0.1.1, and stop quoting a rotting server count
nirholaseff0c3518d0a
diff --git a/docs/open-source-ecosystem.md b/docs/open-source-ecosystem.mdindex 860550fce..dd8c14053 100644--- a/docs/open-source-ecosystem.md+++ b/docs/open-source-ecosystem.md@@ -14,7 +14,7 @@ Everything below is Apache-2.0.- One repository: 9,508 commits, 21 contributors, 60 pull requests, 104 stars, 26 forks.- 101 npm packages under the @three-ws scope, 42 of them MCP servers, 6,225 downloads in the last 30 days.-- 72 MCP servers in the official Model Context Protocol registry under one namespace, io.github.nirholas.+- Dozens of MCP servers in the official Model Context Protocol registry under one namespace, io.github.nirholas. The live count is whatever the registry returns for that namespace; `node scripts/publish-mcp-servers.mjs --dry-run` reports it against the repo.- 4,519 priced x402 endpoints in a live discovery catalog, 110,416 on-chain USDC settlements and 803,483 payment verifications through a facilitator we host ourselves.- ERC-8004 identity, reputation, and validation registries at the same address on 12 EVM mainnets. Two Solana programs. Seven Solidity contracts. Four Rust crates.- 3,000 validator attestations and 126,522 custody proofs written to Solana.@@ -98,15 +98,15 @@ Everything on npm is installable today. Grouped by what it does:- @three-ws/irl, geofenced real-world presence with proof-of-presence.- @three-ws/agenc, a client for the AgenC coordination protocol on Solana.-**42 MCP servers on npm**, each one `npx`-runnable: activity, agenc, alerts, alibaba-cloud, assistant, audio, autopilot, avatar, avatar-agent, billing, brain, clash, concierge, copy, data-workbench, ibm-watsonx, ibm-x402, intel, kol, loom, marketplace, mcp-server, metaplex-agent, naming, notifications, portfolio, provenance, pumpfun, scene, signals, spatial, three-token, tutor, vanity, vision, x402, plus 3d-ar-studio-mcp, hood-mcp, robinhood-chain-mcp, and robinhood-mcp. Section 3 has what each one does.+**MCP servers on npm**, each one `npx`-runnable: activity, agenc, alerts, alibaba-cloud, assistant, audio, autopilot, avatar, avatar-agent, billing, brain, clash, concierge, copy, ibm-watsonx, ibm-x402, intel, kol, loom, marketplace, mcp-server, metaplex-agent, naming, notifications, portfolio, provenance, pumpfun, scene, signals, spatial, three-token, tutor, vanity, vision, x402, plus 3d-ar-studio-mcp, hood-mcp, robinhood-chain-mcp, and robinhood-mcp. Section 3 has what each one does.**The Robinhood Chain family, 17 packages**: hoodchain, robinhood-chain, hood-js, hood-cli, hood-api, hood-connect, hood-alerts, hood-launcher, hood-traders, hoodkit, hood402, hood402-facilitator, @three-ws/hood-pay, hood-mcp, robinhood-chain-mcp, robinhood-mcp, and erc8056, the reference implementation of the corporate-actions standard. A complete open SDK stack for a chain that launched this summer.----## 3. MCP: 72 servers in the official registry+## 3. MCP: our servers in the official registry-The Model Context Protocol registry at registry.modelcontextprotocol.io is where AI clients discover servers. Under one namespace, io.github.nirholas, three.ws publishes 72 of them. Any MCP-capable client can install any of these today.+The Model Context Protocol registry at registry.modelcontextprotocol.io is where AI clients discover servers. Under one namespace, io.github.nirholas, three.ws publishes dozens of them (count them live: `curl "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.nirholas&version=latest&limit=100"`, following `metadata.next_cursor`). Any MCP-capable client can install any of these today.**3D and avatars**: three.ws (the hosted server at three.ws/api/mcp behind OAuth 2.1), threews-3d-studio and threews-3d-studio-free (text and image to 3D, rigging, animation, stylize, retexture, segment), threews-avatar (render a live on-chain avatar inline), 3D-AI-Agent-Avatar, 3d-agent-mcp, 3d-ar-studio, scene-mcp (speak a diorama into being), loom-mcp (the community gallery), assistant-widget, concierge-mcp, audio-mcp (TTS, STT, audio-to-face), vision-mcp (free NVIDIA NIM vision models).@@ -114,11 +114,11 @@ The Model Context Protocol registry at registry.modelcontextprotocol.io is where**Payments**: x402-mcp, x402-bridge, threews-x402-bazaar, agentcore-payments-mcp, ibm-x402-mcp and ibm-x402-mcp-remote (pay-per-use IBM Granite in USDC, no IBM account), three-token-mcp (the first MCP server whose actions can burn a token).-**Markets and data**: threews-pumpfun and pumpfun-solana-mcp (23 free read-only pump.fun tools), pump-fun-sdk, pumpfun-claims-bot, intel-mcp, kol-mcp, signals-mcp, copy-mcp, portfolio-mcp, agent-sniper, data-workbench-mcp, crypto-market-data, free-crypto-news, universal-crypto-mcp, defi-agents, hood-mcp, robinhood-mcp, vanity-mcp.+**Markets and data**: threews-pumpfun and pumpfun-solana-mcp (23 free read-only pump.fun tools), pump-fun-sdk, pumpfun-claims-bot, intel-mcp, kol-mcp, signals-mcp, copy-mcp, portfolio-mcp, agent-sniper, crypto-market-data, free-crypto-news, universal-crypto-mcp, defi-agents, hood-mcp, robinhood-mcp, vanity-mcp.**Enterprise clouds**: ibm-watsonx, alibaba-cloud.-**Developer tooling**: github-to-mcp (turn any GitHub repo into an MCP server), abi-to-mcp (turn any contract ABI into one), solidity-compiler, extract-llms-docs, tool-discovery-mcp, crypto-tools-registry, repo-intel, claude-code-explorer-mcp, mcp-notify, xactions.+**Developer tooling**: github-to-mcp (turn any GitHub repo into an MCP server), abi-to-mcp (turn any contract ABI into one), solidity-compiler, extract-llms-docs, tool-discovery-mcp, crypto-tools-registry, repo-intel, mcp-notify, xactions.Beyond the official registry: 18 of these are indexed on PulseMCP and 10 on Glama; a LobeHub plugin manifest lives at three.ws/lobehub/plugin.json; the three.ws 3D Studio is a live app in the OpenAI GPT Store; and four Claude Code plugins ship from the repo's own marketplace (`/plugin marketplace add nirholas/three.ws`): three-ws-core (wallet and x402 skills), three-ws-3d (text to 3D and rigged avatars), three-ws-pump-fun (on-chain launch and trade skills), and three-ws-developer (scaffold agents and configure servers).diff --git a/packages/solana-memo-media-mcp/package.json b/packages/solana-memo-media-mcp/package.jsonindex f46639c75..014c0f358 100644--- a/packages/solana-memo-media-mcp/package.json+++ b/packages/solana-memo-media-mcp/package.json@@ -1,6 +1,6 @@{"name": "@three-ws/solana-memo-media-mcp",- "version": "0.1.0",+ "version": "0.1.1","mcpName": "io.github.nirholas/solana-memo-media-mcp","description": "Extract, validate, and display image data URIs embedded in Solana SPL Memo instructions. Read-only, local decoding, no key required.","type": "module",diff --git a/packages/solana-memo-media-mcp/server.json b/packages/solana-memo-media-mcp/server.jsonindex 506ae4f80..06a170326 100644--- a/packages/solana-memo-media-mcp/server.json+++ b/packages/solana-memo-media-mcp/server.json@@ -5,6 +5,6 @@"description": "Extract validated image data URIs from Solana SPL Memos and return them inline to MCP clients.","websiteUrl": "https://three.ws","repository": { "url": "https://github.com/nirholas/three.ws", "source": "github", "subfolder": "packages/solana-memo-media-mcp" },- "version": "0.1.0",- "packages": [{ "registryType": "npm", "identifier": "@three-ws/solana-memo-media-mcp", "version": "0.1.0", "runtimeHint": "npx", "transport": { "type": "stdio" }, "environmentVariables": [{ "name": "SOLANA_RPC_URLS", "description": "Optional comma-separated Solana JSON-RPC failover endpoints. Public mainnet endpoints are used when omitted.", "format": "string", "isRequired": false }, { "name": "SOLANA_RPC_URL", "description": "Optional primary Solana JSON-RPC endpoint.", "format": "string", "isRequired": false }] }]+ "version": "0.1.1",+ "packages": [{ "registryType": "npm", "identifier": "@three-ws/solana-memo-media-mcp", "version": "0.1.1", "runtimeHint": "npx", "transport": { "type": "stdio" }, "environmentVariables": [{ "name": "SOLANA_RPC_URLS", "description": "Optional comma-separated Solana JSON-RPC failover endpoints. Public mainnet endpoints are used when omitted.", "format": "string", "isRequired": false }, { "name": "SOLANA_RPC_URL", "description": "Optional primary Solana JSON-RPC endpoint.", "format": "string", "isRequired": false }] }]}diff --git a/prompts/finish/_context/integrate-PROGRESS.md b/prompts/finish/_context/integrate-PROGRESS.mdindex 1cbbfd04b..bca0f0064 100644--- a/prompts/finish/_context/integrate-PROGRESS.md+++ b/prompts/finish/_context/integrate-PROGRESS.md@@ -1332,3 +1332,7 @@ and are logged there.Commits: `d7bcabdcc` (package + API routes + migration + rate limit + vercel.json fix +tests), `df5e2d380` (CLI), `e55c84a15` (UI tab), `7c28d186c` (docs, STRUCTURE.md, changelog),this closing commit (PROGRESS log, order-file removal).++## 2026-10-23: order 530 (registry cleanup), partial, owner-gated++Prepared: `scripts/publish-mcp-servers.mjs --deprecate` (dry run unless `--apply`; `--dry-run` also prints the plan), a DEPRECATIONS list (claude-code-explorer-mcp, data-workbench-mcp), solana-memo-media-mcp bumped to 0.1.1 to match npm (registry still has 0.1.0), ecosystem doc count replaced by its source of truth. Remaining and owned by the owner: run the registry publish and deprecate commands (external writes). Order file left in place.diff --git a/prompts/store-submissions/_generated/mcp-listing-source.json b/prompts/store-submissions/_generated/mcp-listing-source.jsonindex 67f521f9c..495067bab 100644--- a/prompts/store-submissions/_generated/mcp-listing-source.json+++ b/prompts/store-submissions/_generated/mcp-listing-source.json@@ -1156,7 +1156,7 @@"transport": "stdio","connect": "npx -y @three-ws/solana-memo-media-mcp","npmPackage": "@three-ws/solana-memo-media-mcp",- "version": "0.1.0",+ "version": "0.1.1","description": "Extract validated image data URIs from Solana SPL Memos and return them inline to MCP clients.","tagline": "See the images people embed in Solana memos: give it a signature, get the picture back inline, validated.","category": "market-data",diff --git a/scripts/publish-mcp-servers.mjs b/scripts/publish-mcp-servers.mjsindex 5950c168a..7951bd181 100644--- a/scripts/publish-mcp-servers.mjs+++ b/scripts/publish-mcp-servers.mjs@@ -25,6 +25,8 @@// node scripts/publish-mcp-servers.mjs --only pumpfun-mcp,three-token-mcp// node scripts/publish-mcp-servers.mjs --npm-only # skip the registry step entirely// node scripts/publish-mcp-servers.mjs --stale # same check as publish-packages.mjs --stale+// node scripts/publish-mcp-servers.mjs --deprecate # plan the DEPRECATIONS list (dry run)+// node scripts/publish-mcp-servers.mjs --deprecate --apply # mark them deprecated in the registry and on npmimport { execFileSync } from 'node:child_process';import { readFileSync, existsSync } from 'node:fs';@@ -142,9 +144,31 @@ const SERVERS = [{ key: 'remote-grok', manifest: 'server-grok.json' },];+// Registry names we no longer stand behind: the source is lost, or the repository+// they point at is gone. Deprecation keeps the name resolvable (existing installs+// keep working) while clients and the registry UI warn against new use. Never+// republish code we cannot see; deprecate it. `npm` is the package to deprecate+// alongside, when one exists.+const DEPRECATIONS = [+ {+ name: 'io.github.nirholas/claude-code-explorer-mcp',+ npm: 'claude-code-explorer-mcp',+ message:+ 'Deprecated: the source repository it points at was taken down. Use the three.ws MCP servers instead: https://three.ws/mcp',+ },+ {+ name: 'io.github.nirholas/data-workbench-mcp',+ npm: '@three-ws/data-workbench-mcp',+ message:+ 'Deprecated: the source repository is no longer available and the server is unmaintained. Use the three.ws MCP servers instead: https://three.ws/mcp',+ },+];+const args = process.argv.slice(2);const dryRun = args.includes('--dry-run');const npmOnly = args.includes('--npm-only');+const deprecate = args.includes('--deprecate');+const apply = args.includes('--apply');const onlyArg = args.find((a) => a.startsWith('--only'));const only = onlyArg? (onlyArg.includes('=') ? onlyArg.split('=')[1] : args[args.indexOf(onlyArg) + 1] || '')@@ -247,6 +271,57 @@ async function publishToRegistry(manifest, token) {return JSON.parse(text);}+async function registryStatus(name) {+ const res = await fetch(`${REGISTRY}/v0/servers/${encodeURIComponent(name)}/versions/latest`);+ if (res.status === 404) return null;+ if (!res.ok) throw new Error(`MCP registry lookup for ${name} → HTTP ${res.status}`);+ const body = await res.json();+ return body?._meta?.['io.modelcontextprotocol.registry/official']?.status ?? 'active';+}++async function deprecateInRegistry(name, message, token) {+ const res = await fetch(`${REGISTRY}/v0.1/servers/${encodeURIComponent(name)}/status`, {+ method: 'PATCH',+ headers: { 'content-type': 'application/json', authorization: `Bearer ${token}` },+ body: JSON.stringify({ status: 'deprecated', statusMessage: message }),+ });+ const text = await res.text();+ if (!res.ok) throw new Error(`registry deprecate → HTTP ${res.status}: ${text}`);+}++async function npmDeprecated(pkg) {+ const out = execFileSync('npm', ['view', pkg, 'deprecated'], { encoding: 'utf8' }).trim();+ return out.length > 0;+}++async function runDeprecations(live) {+ let token = null;+ for (const d of DEPRECATIONS) {+ console.log(`\n── deprecate ${d.name}`);+ try {+ const status = await registryStatus(d.name);+ if (status === null) console.log(' registry: not published, nothing to do');+ else if (status === 'deprecated') console.log(' registry: already deprecated');+ else if (!live) console.log(` registry: would deprecate all versions (${d.message})`);+ else {+ token ??= await getRegistryToken();+ await deprecateInRegistry(d.name, d.message, token);+ console.log(' registry: deprecated');+ }+ if (d.npm) {+ if (await npmDeprecated(d.npm)) console.log(` npm: ${d.npm} already deprecated`);+ else if (!live) console.log(` npm: would deprecate ${d.npm}`);+ else {+ execFileSync('npm', ['deprecate', d.npm, d.message], { stdio: 'inherit' });+ console.log(` npm: ${d.npm} deprecated`);+ }+ }+ } catch (err) {+ fail(`${d.name}: deprecate failed: ${err.message}`);+ }+ }+}+function npmPublish(dir) {execFileSync('npm', ['publish', '--access', 'public'], {cwd: resolve(root, dir),@@ -273,6 +348,12 @@ if (args.includes('--stale')) {process.exit(await runStaleCli(root));}+if (deprecate) {+ await runDeprecations(apply && !dryRun);+ console.log(apply && !dryRun ? '\nDeprecation run complete.' : '\nDeprecation dry run complete (pass --apply to write).');+ process.exit(process.exitCode ?? 0);+}+let registryToken = null;for (const server of SERVERS) {@@ -324,7 +405,7 @@ for (const server of SERVERS) {}} catch (err) {npmOk = false;- fail(`${server.key}: npm publish failed — ${err.message}`);+ fail(`${server.key}: npm publish failed: ${err.message}`);}}if (!npmOk || npmOnly) continue;@@ -352,8 +433,10 @@ for (const server of SERVERS) {console.log(` registry: published (status ${out?.server?.status ?? 'ok'})`);}} catch (err) {- fail(`${server.key}: registry step failed — ${err.message}`);+ fail(`${server.key}: registry step failed: ${err.message}`);}}+if (dryRun && !only) await runDeprecations(false);+console.log(dryRun ? '\nDry run complete.' : '\nPublish run complete.');