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.

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.md
index 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.json
index 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.json
index 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.md
index 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.json
index 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.mjs
index 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 npm
import { 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.');