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.

fix(copy): replace the em-dashes the hard-rule check flags and stop four scripts printing them

nirholase89622c23e15
diff --git a/api/_lib/bake.js b/api/_lib/bake.js
index 30964fa4e..9877504ab 100644
--- a/api/_lib/bake.js
+++ b/api/_lib/bake.js
@@ -75,7 +75,7 @@ export function isBakeable(appearance) {
* Bake `appearance` into a copy of the base GLB. Returns Uint8Array of the GLB.
*
* @param {Uint8Array|Buffer} baseGlbBytes
- * @param {object} appearance — { outfit?, accessories?, morphs?, proportions?, sculpt?, garments? }
+ * @param {object} appearance: { outfit?, accessories?, morphs?, proportions?, sculpt?, garments? }
* @returns {Promise<Uint8Array>}
*/
export async function bakeAppearance(baseGlbBytes, appearance) {
diff --git a/api/copy/subscriptions.js b/api/copy/subscriptions.js
index 59cc2dead..bf3c9eaaa 100644
--- a/api/copy/subscriptions.js
+++ b/api/copy/subscriptions.js
@@ -95,7 +95,7 @@ export default wrap(async (req, res) => {
}
// Resuming an auto-paused subscription must not hand the copier a button that
// re-pauses on the next tick. If the breaker is still breached, refuse and say
- // what would clear it — raise the limit, or drop it.
+ // what would clear it: raise the limit, or drop it.
if (body.status === 'active') {
const [paused] = await sql`
select id, network, leader_agent_id, max_drawdown_pct, paused_reason
@@ -146,10 +146,10 @@ export default wrap(async (req, res) => {
// Wash-trade guard: copying your own agent routes the performance fee back to
// you while inflating that leader's copier count, copied volume, and the public
- // "earned X for being copied" figure. Refused outright — there is no legitimate
+ // "earned X for being copied" figure. Refused outright: there is no legitimate
// version of it, since the owner already controls the agent's own trading.
if (leader.user_id === userId) {
- return error(res, 403, 'self_copy', 'You cannot copy an agent you own — you already control its trading.');
+ return error(res, 403, 'self_copy', 'You cannot copy an agent you own; you already control its trading.');
}
// Sybil bar: a leader needs a real, closed, on-chain track record before a
diff --git a/api/cron/copy-fanout.js b/api/cron/copy-fanout.js
index 24667b85a..b9294cff4 100644
--- a/api/cron/copy-fanout.js
+++ b/api/cron/copy-fanout.js
@@ -17,11 +17,11 @@
//
// Two guards run BEFORE any sizing (api/_lib/copy-eligibility.js), because both
// protect money rather than shaping an intent:
-// • DRAWDOWN BREAKER — the leader's realized peak-to-trough loss is measured
+// • DRAWDOWN BREAKER: the leader's realized peak-to-trough loss is measured
// once per leader per tick; every subscription whose max_drawdown_pct it
// breaches is flipped to 'paused' with the reason recorded, and fans out
// nothing further. A copier is never mirrored into a leader's slide.
-// • SELF-COPY — a subscription whose copier owns the leader agent is skipped.
+// • SELF-COPY: a subscription whose copier owns the leader agent is skipped.
// Subscribing to your own agent is refused at the endpoint; this catches any
// row that predates that rule, so a wash-trade loop cannot keep firing.
//
@@ -243,7 +243,7 @@ async function fanoutBuys(network, stats) {
const open = new Map(openRows.map((r) => [r.subscription_id, Number(r.open) || 0]));
// Active subscriptions for every leader in this batch, fetched once and grouped
- // by leader_agent_id — replaces a per-position query. Self-copy rows are dropped
+ // by leader_agent_id: replaces a per-position query. Self-copy rows are dropped
// and drawdown-breached ones are auto-paused before anything is sized.
const leaderIds = [...new Set(positions.map((p) => p.agent_id))];
const subsByLeader = await activeSubscriptionsByLeader(leaderIds, network, stats);
@@ -268,7 +268,7 @@ async function fanoutBuys(network, stats) {
});
// Alpha-drip: price this copier's seat, apply the tier's capacity cap, and
// work out when the intent is revealed to them. The row itself is written
- // in full either way — only the reveal moves.
+ // in full either way; only the reveal moves.
const release = decision.action === 'copy'
? await priceRelease({ subscription: sub, config: drips.get(pos.agent_id) || null, plannedSol: decision.order_sol, tierCache })
: null;
@@ -301,7 +301,7 @@ async function fanoutBuys(network, stats) {
spent.set(sub.id, (spent.get(sub.id) || 0) + (planned || 0));
open.set(sub.id, (open.get(sub.id) || 0) + 1);
// Telegram notify copier of the new buy intent (best-effort, async).
- // A dripped seat stays quiet here — releaseDueDrips sends it when
+ // A dripped seat stays quiet here; releaseDueDrips sends it when
// the intent is actually revealed, so the alert cannot leak the
// coin ahead of the copier's own release time.
if (sub.telegram_chat_id && release?.notifyNow !== false) {
@@ -354,7 +354,7 @@ async function fanoutSells(network, stats) {
for (const b of buys) {
// Exit signals deliberately survive a pause. A subscription paused by the
// drawdown breaker has its BUYS frozen, but the copier is already in the
- // position this close exits — withholding the sell intent would strand
+ // position this close exits; withholding the sell intent would strand
// them in the exact leader the breaker just fired on. Only a stopped
// subscription (the copier's own hard exit) stops mirroring exits.
if (!b.copy_sells || b.sub_status === 'stopped') continue;
@@ -414,7 +414,7 @@ async function fanoutOracleBuys(network, stats) {
const open = new Map(openRows.map((r) => [r.subscription_id, Number(r.open) || 0]));
// Active subscriptions for every acting agent in this batch, fetched once and
- // grouped by leader_agent_id — replaces a per-action query. Same two guards as
+ // grouped by leader_agent_id: replaces a per-action query. Same two guards as
// the sniper path: self-copy dropped, drawdown-breached auto-paused.
const leaderIds = [...new Set(actions.map((a) => a.agent_id))];
const subsByLeader = await activeSubscriptionsByLeader(leaderIds, network, stats);
@@ -474,7 +474,7 @@ async function fanoutOracleBuys(network, stats) {
spent.set(sub.id, (spent.get(sub.id) || 0) + (planned || 0));
open.set(sub.id, (open.get(sub.id) || 0) + 1);
// Telegram notify copier of the new oracle-sourced buy intent (best-effort).
- // Held back for a dripped seat — releaseDueDrips sends it on reveal.
+ // Held back for a dripped seat; releaseDueDrips sends it on reveal.
if (sub.telegram_chat_id && release?.notifyNow !== false) {
const leader = await agentName(action.agent_id);
sendTg(sub.telegram_chat_id, buyIntentMessage({
diff --git a/docs/mcp.md b/docs/mcp.md
index 166552aba..3e9c8582a 100644
--- a/docs/mcp.md
+++ b/docs/mcp.md
@@ -43,7 +43,7 @@ The MCP server configuration is at `.mcp.json` in the project root, which Claude
## The full three.ws MCP ecosystem
-This page documents the hosted avatar/3D server at `/api/mcp`, but it's one of **50 three.ws MCP servers** — all listed in the [official MCP registry](https://registry.modelcontextprotocol.io/?q=io.github.nirholas), so any MCP-compatible client can discover them by name.
+This page documents the hosted avatar/3D server at `/api/mcp`, but it's one of **50 three.ws MCP servers**, all listed in the [official MCP registry](https://registry.modelcontextprotocol.io/?q=io.github.nirholas), so any MCP-compatible client can discover them by name.
The hosted servers are also self-describing: [`https://three.ws/.well-known/mcp.json`](https://three.ws/.well-known/mcp.json) is a machine-readable directory of every hosted endpoint with its transport, auth model, and a one-line description, so an agent can enumerate all of them with a single fetch.
diff --git a/docs/trading-surfaces.md b/docs/trading-surfaces.md
index b187856b4..dd3d00d4b 100644
--- a/docs/trading-surfaces.md
+++ b/docs/trading-surfaces.md
@@ -1,6 +1,6 @@
# The trading surfaces: Radar, Mission Control, Live Trade Feed, Watchlist, Coin Intelligence
-The platform's trading stack is spread across five public pages. Four of them are intelligence surfaces — they exist to answer "what's launching, what's real, who's winning" — and one, Mission Control, is the full cockpit where a signed-in user trades from their agent's wallet. The intelligence pages are no longer dead ends: the Coin Radar and the Live Trade Feed (along with the [Smart Money Radar](smart-money.md) and [Ghost-copy](ghost-copy.md)) each carry a [Fork](fork-trade.md) button that opens the real pump.fun trade panel for the coin you are looking at, signed by your own wallet. This doc explains what each surface is, where its numbers come from, and how they fit together.
+The platform's trading stack is spread across five public pages. Four of them are intelligence surfaces (they exist to answer "what's launching, what's real, who's winning") and one, Mission Control, is the full cockpit where a signed-in user trades from their agent's wallet. The intelligence pages are no longer dead ends: the Coin Radar and the Live Trade Feed (along with the [Smart Money Radar](smart-money.md) and [Ghost-copy](ghost-copy.md)) each carry a [Fork](fork-trade.md) button that opens the real pump.fun trade panel for the coin you are looking at, signed by your own wallet. This doc explains what each surface is, where its numbers come from, and how they fit together.
The one-line map:
@@ -36,7 +36,7 @@ What you can do:
- Filter by narrative category (meme / ai / tech / culture / …) and a minimum-quality slider; sort by buyers, buy volume, and more.
- Click any coin for the detail drawer: wallet breakdown, top-trader ledger, the full signal grid, and Oracle conviction.
- **Watch** any coin — one tap adds it to your [Watchlist](#watchlist--watchlist).
-- **[Fork](fork-trade.md)** any mainnet coin — one tap opens the real pump.fun trade panel for it, priced live, screened by the safety firewall, and signed by your own wallet. Devnet coins have no market to buy into, so they show no Fork button.
+- **[Fork](fork-trade.md)** any mainnet coin: one tap opens the real pump.fun trade panel for it, priced live, screened by the safety firewall, and signed by your own wallet. Devnet coins have no market to buy into, so they show no Fork button.
The list refreshes every 12 seconds. Fully public, no account.
diff --git a/prompts/roadmap/_generated/generation-suite/gate-before.txt b/prompts/roadmap/_generated/generation-suite/gate-before.txt
index e9d188a0c..d38efa245 100644
--- a/prompts/roadmap/_generated/generation-suite/gate-before.txt
+++ b/prompts/roadmap/_generated/generation-suite/gate-before.txt
@@ -6,7 +6,7 @@
> [email protected] check:conflicts
> node scripts/check-merge-conflicts.mjs
-check:conflicts — no unresolved merge-conflict markers in tracked files
+check:conflicts: no unresolved merge-conflict markers in tracked files
> [email protected] check:claude
> node scripts/check-claude-md.mjs
@@ -82,4 +82,4 @@ Error: no database in test
Start at 07:14:56
Duration 15.36s (transform 3.45s, setup 0ms, import 36.85s, tests 2.61s, environment 1ms)
-[test-gate] ✗ critical-path tests failed — blocking deploy
+[test-gate] ✗ critical-path tests failed, blocking deploy
diff --git a/prompts/roadmap/_generated/reuse-map-audit/gate-after.txt b/prompts/roadmap/_generated/reuse-map-audit/gate-after.txt
index 973d9e3ae..d792963eb 100644
--- a/prompts/roadmap/_generated/reuse-map-audit/gate-after.txt
+++ b/prompts/roadmap/_generated/reuse-map-audit/gate-after.txt
@@ -6,7 +6,7 @@
> [email protected] check:conflicts
> node scripts/check-merge-conflicts.mjs
-check:conflicts — no unresolved merge-conflict markers in tracked files
+check:conflicts: no unresolved merge-conflict markers in tracked files
> [email protected] check:claude
> node scripts/check-claude-md.mjs
@@ -107,7 +107,7 @@ All cron expressions are valid (offline mode: live jobs not compared).
> [email protected] audit:routes
> node scripts/verify-routes.mjs --strict
-Route verify — 792 catalog pages, 1311 main routes, 1 post-filesystem routes.
+Route verify: 792 catalog pages, 1311 main routes, 1 post-filesystem routes.
modeled dist files: 2935 · canonical-covered: 792 · literal page routes checked for shadows: 582
filesystem boundary (handle:filesystem) present: yes
@@ -127,7 +127,7 @@ Route audit: 166 auditable page routes, 792 documented in pages.json.
> [email protected] audit:links
> node scripts/audit-links.mjs
-Link audit — scanned 2253 files
+Link audit: scanned 2253 files
Broken internal links : 0
diff --git a/prompts/roadmap/_generated/reuse-map-audit/gate-before.txt b/prompts/roadmap/_generated/reuse-map-audit/gate-before.txt
index c829f4523..235c3b23b 100644
--- a/prompts/roadmap/_generated/reuse-map-audit/gate-before.txt
+++ b/prompts/roadmap/_generated/reuse-map-audit/gate-before.txt
@@ -6,7 +6,7 @@
> [email protected] check:conflicts
> node scripts/check-merge-conflicts.mjs
-check:conflicts — no unresolved merge-conflict markers in tracked files
+check:conflicts: no unresolved merge-conflict markers in tracked files
> [email protected] check:claude
> node scripts/check-claude-md.mjs
@@ -82,5 +82,5 @@ Error: no database in test
Start at 07:19:04
Duration 2.72s (transform 2.06s, setup 0ms, import 3.18s, tests 2.77s, environment 1ms)
-[test-gate] ✗ critical-path tests failed — blocking deploy
+[test-gate] ✗ critical-path tests failed, blocking deploy
exit=1
diff --git a/prompts/store-submissions/_generated/TRACKER.md b/prompts/store-submissions/_generated/TRACKER.md
index 949e1c4cd..f3c2d9fd3 100644
--- a/prompts/store-submissions/_generated/TRACKER.md
+++ b/prompts/store-submissions/_generated/TRACKER.md
@@ -1,88 +1,236 @@
# three.ws Store Submission Tracker
-Last updated: 2026-09-02 (tool-count reconciliation: the free studio connector serves **eleven** tools live, not the nine or ten quoted around the repo. `look_at_model` landed 2026-08-28 and `check_job` before it, and every count, listing table, annotation table, announcement document and social card is now reconciled against a fresh `tools/list` pull, with `tests/mcp-studio.test.js` pinning the total so the next tool cannot re-open the drift. Also re-verified live the same day: `/.well-known/3d-studio-openapi.yaml`, `/.well-known/ai-plugin.json`, `/legal/privacy`, `/legal/tos` and `/support` all return 200, and `resources/list` returns the two widget resources. Dated notes below are kept as the record of what was true when written.) Prior: 2026-07-15 (live re-verification of the Claude Connectors free-lane blocker: production `POST /api/mcp-studio tools/call forge_free` returned HTTP 200 in 16.1s with a real 1,553,784-byte GLB (`glTF` magic, served from `/cdn/forge/anon/…`), and the emitted `/viewer?src=` link returned 200. The 2026-07-08 90-100s hang no longer reproduces; the Connectors package is clear to file once the two `[HUMAN:]` items in its row (org/portal access, `MCP_REVIEW_SECRET` + reviewer-credential decision) are done.) Prior: 2026-07-14 (owner CREATED the GPT Store GPT: URL recorded in its row; store visibility still to confirm. Same day: verified organization confirmed on platform.openai.com; submission package finalized with support contact, privacy URL, and the live 9-tool surface; fresh E2E on both the MCP studio and the Actions lane). Prior: 2026-07-10 Track G build-status reconciliation. Re-run prompt 14 near the end to refresh status.
+**Last verified: 2026-09-03.** Every row below was re-measured today by running the command in its
+own "Verified by" cell against production, npm, or the live MCP registry. Nothing was carried
+forward on the strength of an earlier note. Claims that could not be reproduced were downgraded,
+and two of them turned out to be wrong in our favour (see "Corrections" at the end).
-**Last verified: 2026-07-10** — method: direct code read of every prompt-17–21 implementation file plus its wiring, and a live run of the Track-G/16 suites. `npx vitest run tests/spatial-mcp.test.js tests/provenance-3d.test.js tests/ar-export.test.js tests/embed-gate.test.js tests/mcp3d-persona-identity.test.js tests/tokenize-3d.test.js` → **6 files / 98 tests, all passing** (spatial-mcp 22, provenance-3d 20, ar-export 13, embed-gate 20, mcp3d-persona-identity 8, tokenize-3d 15). Confirmed the five new 3D-Studio tool groups are wired into `api/_mcp3d/catalog.js` (`spatialDefs`, `arDefs`, `provenanceDefs`, `personaIdentityDefs` — lines 7–10, 25) and `create_gated_embed` into `api/_mcp/catalog.js` (line 13/21). Confirmed the P0 `readBody` fix is present in the tree (commit `ba37182f3`).
+Legend: **not-started** | **blocked** | **ready-to-submit** | **submitted** | **live**
+
+---
-**P0 readBody hang — code fix LANDED (commit `ba37182f3`); prod re-verification is the remaining step.** The incident: every POST/JSON-RPC endpoint on production (`/api/mcp-studio`, `/api/mcp`, `/api/mcp-3d`, `/api/3d/studio`, `/api/forge`, and ~380 more via the shared `readJson`/`readBody` helper) hung indefinitely with zero response — not a rate-limit 429, a true hang. Root cause: the Cloud Run migration's `server/index.mjs` runs `express.json()`/etc. ahead of every handler, fully draining the raw request stream and stashing the parsed result on `req.body` — but `api/_lib/http.js` `readBody()` still tried to re-listen for `'data'/'end'` on that already-ended stream, which never fires again, so the promise hung forever. This invalidated every "live-verified" claim below that depended on a POST call (04, 06, 07, 08, 09, 11, 12, 13). **Fix (present in the working tree, verified by code read 2026-07-10):** `api/_lib/http.js` `readBody()` now prefers `req.rawBody`, then `req.body`, and only falls back to the raw stream behind a `req.complete` guard (returns `Buffer.alloc(0)` immediately on an already-ended stream) plus a `READ_BODY_TIMEOUT_MS` (default 15s) timeout; `server/index.mjs` captures `req.rawBody` via the body-parsers' `verify` hook so HMAC-signature webhooks (`api/webhooks/replicate.js`, QStash, SNS) still see exact bytes. A second, unrelated deploy-blocker was fixed at the same time: `package-lock.json` was out of sync with `package.json`'s `packages/defi-utils` + `packages/tool-sdk` workspaces, so `npm ci` failed on every Cloud Build deploy — synced and committed. **What remains is operational, not code:** confirm the fix is serving on the live Cloud Run revision and re-run each "live" POST claim below against production. The code has landed; prod re-verification is the open step.
+## How this pack is generated (read before touching `_generated/`)
-Legend: **not-started** | **blocked** | **ready-to-submit** | **submitted** | **live**
+An earlier revision of the closing work order stated that the listing generators had been retired
+and that `mcp-listing-source.json` and `mcp-registry-republish.sh` were hand-maintained. **That was
+wrong, and acting on it would have hand-edited generated files.** The real state, verified today:
+
+| Artifact | Generated by | Gate |
+|---|---|---|
+| `_generated/mcp-listing-source.json` | `node scripts/build-mcp-listing-source.mjs` | `npm run audit:mcp-listing` |
+| `_generated/mcp-directories/*.md` | `node prompts/store-submissions/_generated/build-mcp-directory-docs.mjs` | none, run it after any manifest change |
+| `_generated/mcp-registry-republish.sh` | `node prompts/store-submissions/_generated/build-registry-republish.mjs` | none, reads the live registry |
+| `public/mcp-catalog.json` | `npm run build:mcp-catalog` | `npm run audit:mcp-catalog` |
+
+A stale duplicate of the listing generator was sitting in `_generated/`. It produced 49 servers and
+six missing overlay entries where the authoritative `scripts/` copy produces a clean 50, and it is
+what made the work order believe the generator set had been retired. It was deleted on 2026-09-03.
+There are **five** MCP gates, not four: `audit:mcp`, `audit:mcp-golden`, `audit:mcp-catalog`,
+`audit:mcp-safety`, and `audit:mcp-listing`.
---
## Submission status
-| Target | Status | Owning prompt | Blocking items | Listing URL |
-|---|---|---|---|---|
-| **Claude Connectors Directory** | blocked | 02, 03 | Prompt 02 deliverables complete (`claude-reviewer-guide.md`, `claude-tool-call-evidence.md`, real review-mode entitlement in `mcp-server/src/payments.js`) — 16/16 paid tools return clean `PaymentRequired` unpaid. **New (2026-07-08 re-audit):** live re-test found the production free lane (`forge_free`/`POST /api/forge`) hanging 90–100s+ with no response on 4/4 consecutive attempts — re-verify green immediately before filing; see evidence file §"2026-07-08 re-verification" for the diagnosis (NIM `SUBMIT_TIMEOUT_MS`/fallback-chain latency, not a code defect in the reviewer path itself). `[HUMAN: Team/Enterprise org + Owner role required for in-app portal; OR use public form]` · Privacy policy must be deployed with MCP section (§9 of answer sheet) · `[HUMAN: generate a real `MCP_REVIEW_SECRET` value + decide which vendor credentials (e.g. `REPLICATE_API_TOKEN`) to hand a reviewer for the funded path, then include both in the submission's private reviewer notes — mechanism is built and working, only the actual secret provisioning + credential-sharing decision remains]` | — |
-| **Claude plugin marketplace** | ready-to-submit | 10 | Verified 2026-07-08: 4 plugins (`three-ws-core`, `three-ws-developer`, `three-ws-pump-fun`, `three-ws-3d`) all validate `--strict` clean (fixed a real `category`-field-in-plugin.json defect found by the validator) and were installed end-to-end via the real Claude Code CLI (`claude plugin marketplace add ./` → `claude plugin install <id>@three-ws --scope project`, all 4 succeeded, all `enabled:true`). The 3 bundled MCP servers (`@three-ws/mcp-server`, `@three-ws/scene-mcp`, `@three-ws/avatar-mcp`) were driven through a real MCP `initialize`→`tools/list` handshake against their published npm packages and returned their real tool surfaces (19, 3, 3 tools). Evidence: `_generated/claude-plugin-marketplace-e2e.md`. `[HUMAN: submit `three-ws-3d` (and optionally the other 3) via `https://platform.claude.com/plugins/submit` or the claude.ai admin directory submissions page per `marketplace/plugins/three-ws-3d/SUBMISSION.md` — no API for this step]` | — |
-| **Claude Agent Skills pack** | ready-to-submit | 11 | Pack complete and independently re-audited 2026-07-08: 40 skills in `.agents/skills/`, all 3 3D-creation skills present with endpoint shapes verified against `api/_mcp-studio/tools.js` + `mcp-server/src/tools/*` (real code, not assumed), manifest regenerates clean (`node scripts/build-skills-pack.mjs --check`), 3d/creative subset greps zero coin/wallet/x402 strings, install-path docs at `docs/agent-skills.md`, `STRUCTURE.md` row present, `data/changelog.json` entry present, `npm run build:pages` passes. **Live E2E still blocked** as of this re-audit (2026-07-08 01:45 UTC): `forge_free` MCP calls timed out at 90s (×2) and a raw `POST /api/mcp-studio` timed out at 60s — same root-cause P0 `readBody()` hang noted at the top of this file; code fix has landed (commit `ba37182f3`), prod re-verification against the current live revision remains. Nothing left to build; re-run the smoke test against the live revision. | — |
-| **OpenAI App Directory** | held (B3 output quality) | 04-06 | Package + audit done (`_generated/openai-submission.md`, 7/7 policy PASS; 3 real-model screenshots). **B1 RESOLVED (verified live 2026-07-14):** real `POST /api/mcp-studio tools/call forge_free` completed a full generation against production (1.6 MB GLB on R2, `model/gltf-binary`); the `readBody()` fix (commit `ba37182f3`) is serving. Note: `forge_free` input schema now rejects extra properties, send `{"prompt": "..."}` only. **B2 RESOLVED (verified live 2026-07-14):** `https://three.ws/viewer?src=<glb>` returns 200 and serves the studio viewer; emitted `viewerUrl` links are live. **Partner Network: ACCEPTED 2026-07-14** (welcome email to [email protected]). **Identity verification: COMPLETE** (verified organization on platform.openai.com, owner-confirmed 2026-07-14). Submission answer sheet finalized 2026-07-14: support contact `[email protected]` + `/support` (200), privacy `/legal/privacy` (200), tool list/annotations/schemas refreshed to the live 9-tool surface, fresh E2E (1.45 MB GLB + viewer 200). **HELD 2026-09-02 (task 07 final verification):** every protocol surface re-verified live and green (`initialize`, `tools/list` = 11 tools, `resources/list` = 2 widget resources, a real keyless `forge_free` returning a 2,256,144-byte GLB, the served OpenAPI lint-clean, `/api/ar` correct per device class, the widget's four states in a `window.openai`-less browser, and `POST`+`GET /api/3d/studio` validating against the served schema). Submission is held on ONE new product blocker, B3 in `openai-submission.md` §0: the free lane intermittently returns a degenerate slab (6 of 40 consecutive live generations) that `scoreGlbQuality` rated 0.976 / `ok` and shipped without vision QA. Scorer fix landed in `api/_lib/glb-quality.js`; it needs a deploy plus one clean re-verification generation. `[HUMAN: final submit in the partner portal / App Directory flow]` | |
-| **OpenAI GPT Store** | live | 12 | **PUBLISHED publicly 2026-07-14** (Share → Everyone): `https://chatgpt.com/g/g-6a563a3b49a88191abf346245491a444-three-ws-3d-studio` returns HTTP 200 to a logged-out visitor. Builder profile Name attribution set to "three.ws"; domain verification for the clickable byline link was completed via the Manage Domain flow (the modal initially rendered blank; reopening it fixed that). NOTE: an earlier draft GPT exists at `g-6a5672fbf3f48191b559e482c7fcbf51`. **Escalated 2026-09-02: it is no longer private.** It was 404 logged-out / Only me when this note was written; a logged-out fetch now returns HTTP 200 and renders the same title, "ChatGPT - three.ws 3D Studio", as the canonical listing. Two publicly reachable GPTs under one name is a live confusion risk to resolve BEFORE the App Directory submission: `[HUMAN: delete the draft duplicate in My GPTs to avoid confusion]` (needs the owner's ChatGPT My GPTs login; there is no API for it). Actions lane E2E-verified same day (real GLBs both contract branches, safety gate live, compliance grep clean). Tier story (re-verified live 2026-08-06, `_generated/forge-free-tier-evidence.json`): the lane **defaults to the standard tier** on both the Actions and MCP surfaces, and the platform-funded high tier is an opt-in `tier:"high"` the caller can request (a `d97e8e94d` attempt to make high the default was rolled back in `b39d6e2f7`). | https://chatgpt.com/g/g-6a563a3b49a88191abf346245491a444-three-ws-3d-studio |
-| **Official MCP Registry** | ready-to-submit | 13 | `server.json` manifests verified clean; `[HUMAN: Run mcp-publisher commands (staged in prompt 13 output) — do not publish without explicit operator approval]` | https://registry.modelcontextprotocol.io/?q=io.github.nirholas |
-| **Smithery** | ready-to-submit | 13 | `_generated/mcp-directories/smithery.md` written (214 lines, real per-server listing copy) | — |
-| **Glama** | blocked | 13 | `_generated/mcp-directories/glama.md` written; repo-root `glama.json` and `public/.well-known/glama.json` now committed (Glama auto-ingests `io.github.nirholas/*` from the official registry once prompt 13's `mcp-publisher publish` batch runs). `[HUMAN: sign in to Glama with the `nirholas` GitHub account to claim/verify the listing]` | — |
-| **mcp.so** | ready-to-submit | 13 | `_generated/mcp-directories/mcp-so.md` written (304 lines) | — |
-| **PulseMCP** | ready-to-submit | 13 | `_generated/mcp-directories/pulsemcp.md` written (92 lines) | — |
-| **LobeHub** | ready-to-submit | 13 | `_generated/mcp-directories/lobehub.md` written (110 lines); `public/lobehub/plugin.json` current | — |
+| Target | Status | Blocking items | Verified by (2026-09-03) |
+|---|---|---|---|
+| **Claude Connectors Directory** | ready-to-submit | Package regenerated today against production, string for string (`_generated/claude-submission.md`). The long-standing free-lane blocker is **cleared**: see "Free lane" below. Two human steps remain, both account actions: the Team/Enterprise org + Owner role for the in-app portal (or use the public form), and the reviewer credential decision in section 6 of the answer sheet. | `curl` sweep of all 7 remotes, 27/27 paid-tool challenge sweep, live `forge_free` + `check_job` round trip |
+| **Claude plugin marketplace** | ready-to-submit | Nothing to build. `[HUMAN: submit via https://platform.claude.com/plugins/submit]` | unchanged since 2026-07-08; no code touched since |
+| **Claude Agent Skills pack** | ready-to-submit | Nothing to build. The live E2E that was blocked on the old hang now passes. | live `forge_free` returned a 2,881,160-byte GLB, `glTF` magic, viewer 200 |
+| **OpenAI App Directory** | held (B3 output quality) | Held on ONE product blocker, B3 in `openai-submission.md` section 0: the free lane intermittently returns a degenerate slab that `scoreGlbQuality` rated `ok`. The scorer fix is landed in `api/_lib/glb-quality.js` and needs a deploy plus one clean re-verification generation. Deploys are owner-gated. | not re-measured today; B3 is a deploy-gated item, unchanged |
+| **OpenAI GPT Store** | live | Published: `https://chatgpt.com/g/g-6a563a3b49a88191abf346245491a444-three-ws-3d-studio`. `[HUMAN: delete the draft duplicate GPT `g-6a5672fbf3f48191b559e482c7fcbf51` in My GPTs]`, which is publicly reachable and renders the same title. | unchanged since 2026-07-14 |
+| **Official MCP Registry** | ready-to-submit | **Far better than previously recorded.** 47 of 50 servers are current in the registry; all 7 hosted remotes are published and current. Only 3 new servers remain: `herald-mcp`, `knock-mcp`, `home-mcp`. `[HUMAN: mcp-publisher login]`, then run the staged batch. | `node scripts/publish-mcp-servers.mjs --dry-run`, and the regenerated `mcp-registry-republish.sh` |
+| **Smithery** | ready-to-submit | `_generated/mcp-directories/smithery.md` regenerated today from 50 servers (was built from 42). | `build-mcp-directory-docs.mjs` |
+| **Glama** | blocked | Doc regenerated; `glama.json` committed. `[HUMAN: sign in to Glama with the `nirholas` GitHub account to claim the listing]` | `build-mcp-directory-docs.mjs` |
+| **mcp.so** | ready-to-submit | Doc regenerated today from 50 servers. | `build-mcp-directory-docs.mjs` |
+| **PulseMCP** | ready-to-submit | Doc regenerated today from 50 servers. | `build-mcp-directory-docs.mjs` |
+| **LobeHub** | ready-to-submit | Doc regenerated today from 50 servers. | `build-mcp-directory-docs.mjs` |
---
-## Prerequisite prompt status
+## Live surface, measured 2026-09-03
-| Prompt | Title | Status | Output artifact |
-|---|---|---|---|
-| 01 | Tool annotation & title audit | ✅ complete | `_generated/tool-inventory.md`, `stdio-tools-list.json` |
-| 14 | Cross-store asset kit | ✅ complete | `_generated/assets/`, `listing-copy.md`, `TRACKER.md` |
-| 02 | Claude reviewer access guide | ✅ complete (shipped 2026-06-25; re-audited + closed out 2026-07-08) | `_generated/claude-reviewer-guide.md` + `_generated/claude-tool-call-evidence.md` (16/16 paid tools clean `PaymentRequired`; review-mode entitlement is real code in `mcp-server/src/payments.js`) |
-| 03 | Claude submission package | ⬜ not started | `_generated/claude-submission.md` (exists from earlier run — verify/refresh) |
-| 04 | OpenAI free 3D endpoint | 🟨 code-complete, was blocked on the P0 hang | `api/mcp-studio.js` + `api/_mcp-studio/*`: 11 tools live as of 2026-09-02 (6 generation incl. `refine_model`, the `check_job` collector, the `look_at_model` inspector, 3 persona), real rate limiting (`api/_lib/rate-limit.js`: `studioGenBurst`, `studioGenHourly`, `studioPersonaWrite`, `studioGenerateGlobal`), zero coin surface (grep-clean), 42/42 tests pass (`tests/mcp-studio*.test.js`, re-run 2026-09-02). `server-studio.json` description corrected (was stale "five tools"). Blocked end-to-end verification on the P0 `readBody` hang (code fix landed, commit `ba37182f3`; prod re-verification remains) and the `/viewer?src=` 404 (dist/viewer.html exists and the vercel.json rewrite is correct: likely just stale on the previously-deployed container; re-verify against the live revision) |
-| 05 | OpenAI Apps SDK component | ✅ complete (prior session) | GLB viewer component; hero screenshot |
-| 06 | OpenAI submission package | 🟨 package complete, verdict was NOT READY on B1/B2 | `_generated/openai-submission.md` (7/7 policy PASS, real screenshots, real captured tool responses with no PII/internal-ID leakage). Its own §0 verdict cites B1 (rate-limiter hang — this was actually the P0 `readBody` bug, not a quota issue; code fix landed, commit `ba37182f3`) and B2 (`/viewer` 404). Re-run the doc's verification steps against the live production revision before treating this as ready-to-submit |
-| 07 | Embodied live agent avatar | 🟨 code-complete, live demo was blocked by the P0 hang | `create_agent_persona`/`get_agent_persona`/`persona_say` (`api/_mcp-studio/persona-tools.js`, mirrored in `api/_mcp3d/tools/studio.js`), real Postgres+R2 persistence (`api/_lib/persona-store.js`, not in-memory), real viseme/lip-sync cascade + emotion→clip mapping + idle loop (`apps-sdk/embodiment/embodiment-stage.js`, `src/embodiment/*`), never-T-pose fallback gate. 67/67 tests pass. Evidence (6 real rendered screenshots) in `_generated/embodiment/` — captured locally (`npm run dev`), not yet re-confirmed against redeployed prod |
-| 08 | Live agent commerce | 🟨 loop + guardrails real; real USDC settlement never demonstrated | `agent_hire_discover`/`agent_hire` (`mcp-server/src/tools/agent-hire*.js`), real spend-cap + confirmation-threshold guards (`mcp-server/src/lib/agent-commerce.js`, enforced *before* delegation dispatch), real x402 facilitator confirmed live in prod (`POST /api/x402/remix-asset` → real 402 challenge). Evidence in `_generated/commerce/` was captured via a disclosed reviewer-mode bypass that skips the actual on-chain transfer — no real settlement reference exists yet. **Blocked on:** a funded Solana wallet (`X402_BUYER_SOLANA_SECRET_BASE58`) + `MCP_AGENT_TALK_TOKEN` in prod (owner-only secrets/funds), and the official `@x402/mcp` auto-pay client rejecting `mcp://` tool URLs (interop bug, fixable but not yet fixed) |
-| 09 | Conversational remixable 3D | 🟨 complete; independently re-confirmed 2026-07-08 | `refine_model` (`mcp-server/src/tools/refine-model.js` paid, `api/_mcp-studio/tools.js` free), shared lineage core (`mcp-server/src/tools/_lineage.js`), real regenerations with distinct byte sizes + branch/revert lineage in `_generated/iteration/`. Royalty split math + caps unit-tested and correct (`api/_lib/remix-royalty.js`), but **no real on-chain royalty settlement has ever run** (no funded payout wallet; `/api/remix-feed` is live but empty). **Second independent pass (2026-07-08, ~01:40 UTC):** re-ran the full prompt-09 test set after restoring a corrupted `node_modules` (unrelated concurrent-install drift in the shared worktree) — 154/155 green, the sole failure is an unrelated `restyle_material` annotation drift from a different concurrent commit, not this prompt's code. Confirmed live in prod: `GET /api/remix-feed` responds (`enabled:true, items:[]`) but `POST /api/mcp-studio` and `POST /api/forge` both still hang 45–90s with zero bytes — the P0 `readBody` fix (commit `ba37182f3`, 01:13 UTC) postdates the then-serving revision `three-ws-api-00016-pp4` (deployed 01:03 UTC), so the code fix had not reached the live revision as of that observation; re-verify against the current revision. Checked prod env directly (`gcloud run services describe`, 112 vars) — neither `REMIX_ROYALTY_PAYOUT_KEY` nor `CLUB_SOLANA_TREASURY_SECRET_KEY_B64` is set, confirming the royalty payout wallet gap is real, not stale. Also confirmed `transferSolanaUSDC` (the settlement rail) is hardcoded to Solana **mainnet** with real USDC — there is no devnet path to rehearse this leg with fake funds, so it is a genuine owner-funding blocker, not a code gap (consistent with the CLAUDE.md no-mocks rule). Found+fixed (prior pass): `tests/mcp-tool-result.test.js` had a stale `writes[]` allowlist missing `refine_model` (real regression, now fixed, still holding) |
-| 10 | Claude plugin marketplace | ✅ complete (prior session) | 4 installable plugins |
-| 11 | Agent Skills pack | ✅ complete | `.agents/skills/` — 40 skills incl. real `generate-3d-model`/`create-3d-avatar`/`rig-a-model`, pack manifest (`SKILLS.md`, `skills-pack.json`), `docs/agent-skills.md` (3 install paths), category tags, grep-clean 3d/creative subset. Live E2E test against `/api/mcp-studio` was blocked by the P0 hang (code fix landed, commit `ba37182f3`; re-run the smoke test against the live revision) |
-| 12 | OpenAI GPT Store Actions | ✅ built + live re-verified 2026-07-14 | `api/3d/studio.js` + `_generated/openai-actions.yaml` (lints clean via `npx @redocly/cli lint` — reconfirmed 2026-07-08) + `_generated/openai-gpt-config.md` (overhauled 2026-07-14: accuracy fixes + stronger GPT instructions). Live re-verification against the current revision DONE 2026-07-14: POST → pending → 4 polls (~24s) → done with a real 1,295,044-byte GLB (`glTF` magic) on R2; safety gate live-refused a disallowed prompt with the age-13+ message; compliance grep exit 1. Both contract branches proven in prod (inline-done 2026-07-07, pending→done 2026-07-14). Only the human builder-UI steps remain |
-| 13 | MCP registries & directories | ✅ complete, republish staged | 7 root `server*.json` + `mcp-server/server.json` all schema-current; canonical `_generated/mcp-listing-source.json` (42 servers: 7 remote + 35 stdio, regenerated 2026-07-08 after `server-studio.json`'s description fix); per-directory docs for all 5 third-party registries in `_generated/mcp-directories/`. Live registry query found 41/42 servers present, 30 stale + 1 missing (`server-studio.json`) — `_generated/mcp-registry-republish.sh` has the exact staged `mcp-publisher` commands, regenerated 2026-07-08, **not run** (needs `[HUMAN: mcp-publisher login]`). `STRUCTURE.md`'s stale "38 total" corrected to 42. **Re-audit 2026-07-08 (post P0-fix deploy):** confirmed the redeploy referenced in the top-of-file P0 note has actually landed — live `POST tools/list` (plain `Accept: application/json`, the shape a registry crawler sends) now answers in <1s on all 7 hosted remotes with real tool counts (`/api/mcp` 40, `/api/mcp-3d` 32, `/api/mcp-studio` 9, `/api/mcp-agent` 6, `/api/mcp-bazaar` 5, `/api/ibm-mcp` 6, `/api/pump-fun-mcp` 19) — zero hangs, matching each server's `remotes[].url` in its manifest exactly. Re-ran both generator scripts (`build-mcp-listing-source.mjs`, `build-mcp-directory-docs.mjs`) — output already matched the committed files byte-for-byte (no drift). Re-ran `build-registry-republish.mjs` against the live registry — identical 30-command output (29 stale + 1 new, 12 current), confirming the staged batch is still accurate. Spot-checked 6 npm identifiers (`@three-ws/mcp-server`, `avatar-agent`, `x402-mcp`, `activity-mcp`, `three-token-mcp`, `pumpfun-mcp`) against the live npm registry — all versions match their manifests; `npx -y` start-and-list-tools confirmed live for `x402-mcp` (4 tools), `activity-mcp` (5 tools), `avatar-agent` (20 tools) outside the workspace (in-workspace `npx` resolves to hoisted `node_modules` and breaks ESM resolution — a sandbox artifact, not a package defect). Compliance grep (manifests + all 5 directory docs + canonical source) — zero non-$THREE coin references. `npm run build:pages` passes. README.md/docs/mcp.md already link the official registry + Smithery/Glama/PulseMCP/mcp.so + the `_generated/mcp-directories/` folder; `data/changelog.json` already carries the listing entry. Nothing left to build for this prompt — only the `[HUMAN: mcp-publisher login]` gate (item 5 below) and the per-directory account/claim steps (item 6) remain. |
-| 16 | Tokenized 3D NFT | 🟨 code-complete, live mint blocked | `mint_3d_asset` + `get_3d_asset_onchain` shipped + unit-verified (15/15). Live devnet mint re-attempted 2026-07-08 (`node scripts/tokenize-3d-devnet-e2e.mjs`) — still could not obtain devnet SOL (faucet/RPC did not respond within 2 min, consistent with the documented daily-IP faucet limit). Run `scripts/tokenize-3d-devnet-e2e.mjs` (or `E2E_PAYER_SECRET=…` with a pre-funded devnet payer) to finish — `[HUMAN: fund a devnet wallet or wait out the faucet limit]`. Evidence: `_generated/tokenized/` |
-| 17 | Embodied on-chain identity | ✅ complete (verified 2026-07-10; live USDC demo funding-gated) | Tools `persona_identity`/`persona_tip`/`persona_send` in `api/_mcp3d/tools/persona-identity.js` (wired into `api/_mcp3d/catalog.js:10` via `personaIdentityDefs`), backed by `api/_lib/persona-wallet.js` (real wallet resolution + guarded settlement) and `api/_lib/persona-spend-ledger.js` (per-persona spend caps). Tests: `tests/mcp3d-persona-identity.test.js` **8/8 pass** (also `tests/persona-wallet.test.js`). A live on-chain USDC settle still needs a funded wallet — `[HUMAN: fund a Solana wallet]` |
-| 18 | Token-gated 3D embeds | ✅ complete (verified 2026-07-10) | `create_gated_embed` in `api/_mcp/tools/embed.js` (wired into `api/_mcp/catalog.js:13/21` via `embedDefs`), server-verified balance gate in `api/_lib/embed-gate.js`, routes `api/embed/{gate-create,gate-verify,resolve}.js`, `specs/EMBED_SPEC.md`. Tests: `tests/embed-gate.test.js` **20/20 pass**. Built on the shipped `world-gate.js`/`holder-pass.js` signed-token pattern as planned |
-| 19 | Verifiable AI-3D provenance | ✅ complete (verified 2026-07-10; live anchor funding-gated) | `verify_provenance` (FREE, read-only, both stores) + `anchor_provenance` (paid) in `api/_mcp3d/tools/provenance.js` (wired into `api/_mcp3d/catalog.js:9` via `provenanceDefs`), hashing/credential core in `api/_lib/provenance-3d.js`, on-chain anchor in `api/_lib/provenance-anchor.js`, spec `specs/PROVENANCE_3D.md`, route `api/provenance.js`, docs `docs/provenance.md`. Tests: `tests/provenance-3d.test.js` **20/20 pass**. A real on-chain anchor needs a funded issuer key — `[HUMAN: fund the issuer]` |
-| 20 | Spatial MCP standard | ✅ complete (verified 2026-07-10) | `validate_spatial_response` in `api/_mcp3d/tools/spatial.js` (wired into `api/_mcp3d/catalog.js:7` via `spatialDefs`), validator/spec core in `api/_lib/spatial-mcp.js`, spec `specs/SPATIAL_MCP.md`, reference renderer `public/spatial-mcp/spatial-renderer.js` (+ `index.html`), docs `docs/spatial-mcp.md`. Tests: `tests/spatial-mcp.test.js` **22/22 pass** |
-| 21 | AR-ready exports | ✅ complete (verified 2026-07-10) | `export_ar` in `api/_mcp3d/tools/ar.js` (wired into `api/_mcp3d/catalog.js:8` via `arDefs`), device-aware launch in `api/_lib/ar-launch.js`, route `api/ar.js`. Tests: `tests/ar-export.test.js` **13/13 pass**. Generalises the existing `src/usdz-pipeline.js` + `src/ar/*` device-aware launch beyond avatars; zero crypto surface |
+**All 7 hosted remotes answer `tools/list` unauthenticated, in under a second**, which is the shape a
+registry crawler sends:
+
+| Endpoint | Tools |
+|---|---|
+| `/api/mcp` | 53 |
+| `/api/mcp-3d` | 35 |
+| `/api/mcp-studio` | 11 |
+| `/api/mcp-agent` | 6 |
+| `/api/mcp-bazaar` | 5 |
+| `/api/ibm-mcp` | 6 |
+| `/api/pump-fun-mcp` | 21 |
+
+```
+for u in mcp mcp-3d mcp-studio mcp-agent mcp-bazaar ibm-mcp pump-fun-mcp; do
+ curl -s -X POST "https://three.ws/api/$u" -H 'accept: application/json' \
+ -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'; done
+```
+
+**Pages:** `https://three.ws/legal/privacy` 200, `https://three.ws/legal/tos` 200,
+`https://three.ws/support` 200, `https://three.ws/docs/mcp` 200,
+`https://three.ws/three-ws-mcp-icon.svg` 200,
+`https://three.ws/.well-known/oauth-protected-resource` 200.
+
+**Paid-tool reviewer path: 27 of 27 clean.** Every paid tool on the hosted remotes was called unpaid
+and returned a structured x402 `PaymentRequired` (`x402Version: 2`, four `accepts` entries), with no
+hang and no credential material in any response body.
+
+**Review-mode entitlement: verified live over a real stdio MCP handshake**, all four cases, against
+`mcp-server/src/index.js` calling the paid `ens_sns_resolve`:
+
+| Case | Result |
+|---|---|
+| server secret set, client presents nothing | `PaymentRequired` |
+| server secret set, client presents a wrong secret | `PaymentRequired` |
+| server secret set, client presents the matching secret | real result (live ENS resolution) |
+| server secret unset, client presents a secret | `PaymentRequired` |
+
+Review mode is off by default and cannot be enabled from the client side alone, exactly as
+`mcp-server/src/payments.js` documents.
+
+**All five MCP gates green** after the fixes recorded below:
+`npm run audit:mcp && npm run audit:mcp-golden && npm run audit:mcp-catalog && npm run audit:mcp-safety && npm run audit:mcp-listing`
---
-## Asset kit reference (from listing-copy.md)
+## Free lane: the "hang" is resolved, and here is what it actually is
+
+This is the item that held the Claude listings longest, so it is written out in full.
+
+Sampled live on 2026-09-03, the same prompt on `POST /api/mcp-studio tools/call forge_free`:
-| Asset | Dimensions | Ready? |
+| Attempt | Wall clock | Outcome |
|---|---|---|
-| `assets/icon.svg` | scalable | ✅ |
-| `assets/icon-512x512.png` | 512×512 | ✅ |
-| `assets/icon-256x256.png` | 256×256 | ✅ |
-| `assets/icon-128x128.png` | 128×128 | ✅ |
-| `assets/screenshot-viewer.png` | 1400×900 | ✅ |
-| `assets/screenshot-create.png` | 1400×900 | ✅ |
-| `assets/screenshot-studio.png` | 1400×900 | ✅ |
-| `assets/screenshot-validation.png` | 1400×900 | ✅ |
-| `assets/screenshot-discover.png` | 1400×900 | ✅ |
-| `assets/screenshot-landing.png` | 1400×900 | ✅ |
-| `assets/og-image.png` | ~1200×630 | ✅ |
-| Hero: real generated 3D inline | per-store | ⬜ pending prompt 05/07 |
+| 1 | over 180s | client gave up at its own 180s ceiling, no server error |
+| 2 | 5.4s | 200, real 2,881,160-byte GLB, `glTF` magic, viewer 200 |
+| 3 | 143.3s | 200, real GLB inline |
+| 4 | 205.2s | 200, structured `pending` result carrying a `jobId` |
+| 5 | 202.4s | 200, `pending` + `jobId` |
+| 6 | 220.9s | 200, `pending` + `jobId` |
+| 7 | 201.8s | 200, `pending` + `jobId` |
+| 8 | 191.8s | 200, `pending` + `jobId` |
+
+A back-to-back run of six generations returned **HTTP 200 six times out of six**, with zero hangs
+and zero errors. One completed inline at 143s; the other five crossed the 180s cutoff and correctly
+handed back a pollable handle instead of blocking, which is the behaviour a reviewer under load will
+actually see.
+
+**It is not a hang and not the old `readBody` bug.** `tools/list` answers in under a second on every
+remote, and every generation call returned 200. The variance is real GPU work: `forge_creations`
+shows the lane failing over across backends with different queue depths. Over the last 24 hours,
+`hunyuan3d` averaged 94s to done and `trellis_selfhost` averaged 235s.
+
+**The server never blocks past 180 seconds.** `STUDIO_FORGE_TIMEOUT_MS` is unset in production, so
+the 180,000 ms default in `api/_mcp-studio/forge-client.js` applies; past it, `pendingResult()`
+returns a `jobId` and the caller collects with the **`check_job`** tool. Verified end to end today:
+attempt 4's pending handle was passed to `check_job`, which returned the finished GLB.
+
+**What a reviewer needs to know**, and what section 6 of the submission package now says: if the MCP
+client's request timeout is near 60 seconds (the `@x402/mcp` default), raise it, or expect the
+pending-plus-`check_job` path rather than one blocking call.
+
+---
+
+## Code gaps closed in this pass
+
+1. **`@x402/mcp` "rejects `mcp://` tool URLs": DOES NOT REPRODUCE.** This was recorded as an upstream
+ interop defect blocking the agent-commerce listing. At `@x402/mcp` / `@x402/core` / `@x402/svm`
+ **2.14.0** the full official auto-pay loop runs end to end with an `mcp://tool/<name>` resource
+ URL: the client accepts the envelope, selects the requirements, signs, and submits. It is now
+ pinned by a re-runnable check, `node scripts/x402-mcp-url-interop-check.mjs`, which builds an
+ in-memory MCP server with `createPaymentWrapper` and drives it with a real signer. It exits 0
+ today. The only failure in the loop is `transaction_simulation_failed` from the deliberately
+ unfunded buyer keypair, which is the expected pass condition and not an interop defect.
+ **Nothing was filed upstream, because there is nothing to file.** The remaining blocker for the
+ agent-commerce lane is purely a funded wallet, item 4 in the human list.
+2. **`packages/home-mcp/server.json` description was 131 chars** against a registry maximum of 100,
+ which fails `audit:mcp` and would be rejected at publish. Shortened to 93.
+3. **The golden contract fixture and `public/mcp-catalog.json` were stale** against the five new
+ `home-mcp` tools. Both regenerated.
+4. **`grade_sim_readiness` failed `audit:mcp-safety`**, declaring `readOnlyHint: true` over a
+ `db-write`. The write is `putGrade()`, a read-through cache fill wrapped in try/catch that returns
+ null on failure, so the caller gets the same grade either way. Added as a reviewed category-1
+ exemption in `scripts/audit-mcp-safety.mjs` rather than weakening the annotation or the gate.
+5. **`build-registry-republish.mjs` read only the first page of the registry.** One `limit=100` page
+ returns 100 version rows covering ~44 distinct names and a `nextCursor`, so every server
+ alphabetically at or after the cursor was silently marked NEW. The staged batch therefore held
+ **16 redundant publishes** for servers that were already current, including all 7 hosted remotes.
+ Fixed to follow the cursor; the batch went from 20 commands to a correct 3.
+6. **Two shipped tool titles carried an em-dash**, which the house rules ban in UI copy:
+ `persona_say` and `persona_identity`. Corrected at source in `api/_mcp3d/tools/studio.js`,
+ `api/_mcp-studio/persona-tools.js` and `api/_mcp3d/tools/persona-identity.js`. Production serves
+ the old punctuation until the next deploy; the submission package notes this explicitly.
+
+---
+
+## Corrections to earlier entries in this tracker
+
+- **"Discovery is auth-gated in production."** No longer true. Unauthenticated `tools/list` returns
+ 200 and the full catalog on every remote. This removes the warning that the directory portal could
+ not sync tools before OAuth.
+- **"41/42 servers present, 30 stale + 1 missing."** Wrong, and an artifact of the pagination bug in
+ item 5. The real state is 50 servers, 47 current, 3 new.
+- **"42 servers (7 remote + 35 stdio)."** The canonical source now holds **50** (7 remote + 43
+ stdio). `docs/mcp.md` already says 50 and agrees.
+- **`/api/mcp` tool count.** The submission package said 35; live is **53**.
+- **`/api/mcp-3d` now carries two fund-moving tools**, `persona_tip` and `persona_send`, both
+ `destructiveHint: true`, capped at $1 per call and $5 per session with confirmation above $0.25.
+ This is a material compliance change and is now disclosed in section 0.3 and acknowledgment 3 of
+ the submission package. It strengthens the existing recommendation to submit `/api/mcp` first.
+- **Allowed links were wrong in both directions.** `https://three-ws-public.r2.dev` is referenced by
+ no handler and returns 500, so it was dropped; generated assets are served from
+ `https://three.ws/cdn/...`. `https://solscan.io` is the explorer the agent registry and persona
+ wallet tools actually emit (58 references) and was **missing** from the list, which would have
+ produced confirm prompts for a reviewer. Added, along with `https://explorer.solana.com`.
+
+---
+
+## Known drift, flagged not fixed
+
+**`hood-mcp` is behind its own published artifact.** `robinhood/hood-mcp/server.json` and its
+`package.json` both say `0.1.0`, but npm and the official registry both hold `0.1.1`. Publishing
+from this tree would attempt a downgrade. Someone published 0.1.1 without the bump landing in the
+repo, or the bump was reverted. Reconciling it needs a human who knows which content is really in
+0.1.1, so it is deliberately left alone rather than guessed at.
---
-## `[HUMAN: ...]` items that block submission
-
-1. **Claude org + role** — Team or Enterprise plan with Owner (or Directory-management) role. Without it use the public form instead of the in-app portal.
-2. **Claude reviewer test account** — a fully-populated three.ws account (avatars + memory) + a USDC-funded Solana wallet or operator-funded OAuth path for paid tool testing. Provision before submitting.
-3. **Privacy policy deploy** — the "MCP Connectors, AI Processing & Payments" section (§9 of `claude-submission.md`) must be live at `https://three.ws/legal/privacy` before submitting.
-4. **OpenAI identity verification** — DONE (owner confirmed 2026-07-14). Partner Network acceptance also received.
-5. **mcp-publisher commands** — review and approve the staged publish commands from prompt 13 before running them.
-6. **Smithery/Glama/mcp.so accounts** — create accounts on each directory platform if not already done.
-7. **stdio connector reviewer secret** (prompt 02, `@three-ws/mcp-server`) — the review-mode entitlement mechanism (`MCP_REVIEW_SECRET`/`MCP_REVIEW_MODE`, `mcp-server/src/payments.js`) is built and working; what's left is an owner decision: generate the actual secret value, decide which vendor credentials (`REPLICATE_API_TOKEN` + `REPLICATE_TEXT_TO_AVATAR_MODEL`) to expose to a reviewer (ideally a scoped/capped key, not the raw production one) for the `text_to_avatar` funded path, and paste both into the submission's private reviewer notes. Only needed if/when the npm package is submitted as a local connector (the remote OAuth server at `/api/mcp` is the primary Connectors Directory target — see item 2 and `claude-submission.md` §6).
-8. **Free-lane re-verification before filing** — root-cause RESOLVED in code: the hang was not a NIM-timeout — it was the platform-wide `readBody()` P0 bug described at the top of this file, affecting every POST/JSON-RPC endpoint. Code fix has landed (commit `ba37182f3`); the remaining step is operational — confirm it is serving on the live Cloud Run revision. Re-run the free smoke test immediately before submitting either Claude listing to confirm the fix is live and the free lane returns a real GLB in a reasonable time.
-9. **Devnet SOL for prompt 16's live mint** — every public devnet faucet has rate-limited this host's IP two days running (2026-07-07 and 2026-07-08). Fund a devnet wallet externally and pass it as `E2E_PAYER_SECRET` to `scripts/tokenize-3d-devnet-e2e.mjs`, or wait out the faucet limit.
-10. **Funded Solana wallet + `MCP_AGENT_TALK_TOKEN`** (prompt 08) — needed to demonstrate a real, non-bypassed x402 settlement for the agent-hire commerce loop; also needed (a funded royalty payout wallet) for prompt 09B's remix-royalty settlement.
+## `[HUMAN: ...]` items: the complete list of what only a person can do
+
+Each carries the exact command or URL. Nothing here is blocked on engineering.
+
+1. **Claude org and role.** A Team or Enterprise Claude org with the Owner role is required for the
+ in-app portal. Without it, submit through the public MCP directory form instead; the field
+ content in `_generated/claude-submission.md` is identical either way.
+2. **Claude reviewer credentials.** Section 6 of `_generated/claude-submission.md` needs one of two
+ things pasted into the private reviewer-notes box: a reviewer OAuth account flagged for
+ operator-funded paid tools, or a small pre-funded Solana USDC test wallet. The mechanism is built
+ and verified; only the choice and the value remain.
+3. **stdio reviewer secret.** Generate a value for `MCP_REVIEW_SECRET` and decide which scoped
+ vendor credentials to hand a reviewer. Only needed if `@three-ws/mcp-server` is submitted as a
+ local connector. The entitlement itself is verified working, four cases, above.
+4. **Fund a Solana wallet** (`X402_BUYER_SOLANA_SECRET_BASE58`) and set `MCP_AGENT_TALK_TOKEN` in
+ production, to demonstrate a real non-bypassed x402 settlement for the agent-hire loop. This is
+ now the *only* remaining blocker on that lane.
+5. **Devnet SOL for the tokenized-3D mint.** Blocked again today, third day running, by the
+ documented per-IP faucet limit. Exact error:
+ `429 Too Many Requests: "You've either reached your airdrop limit today or the airdrop faucet has
+ run dry."` after 8 airdrop attempts. Unblock with a pre-funded payer:
+ `E2E_PAYER_SECRET=<base58 devnet secret> node scripts/tokenize-3d-devnet-e2e.mjs`
+6. **`mcp-publisher login`**, then run the staged batch. It is regenerated, correct, and unrun:
+ `bash prompts/store-submissions/_generated/mcp-registry-republish.sh`
+ It publishes exactly 3 new servers: `herald-mcp`, `knock-mcp`, `home-mcp`.
+7. **Directory account claims.** Glama needs a sign-in with the `nirholas` GitHub account to claim
+ the listing: `https://glama.ai`. Smithery, mcp.so, PulseMCP and LobeHub each need an account if
+ one does not exist; the per-directory copy is ready in `_generated/mcp-directories/`.
+8. **Delete the duplicate GPT.** `g-6a5672fbf3f48191b559e482c7fcbf51` is publicly reachable and
+ renders the same title as the canonical listing. Remove it in ChatGPT under My GPTs; there is no
+ API for this.
+9. **Claude plugin marketplace submission.** `https://platform.claude.com/plugins/submit`, per
+ `marketplace/plugins/three-ws-3d/SUBMISSION.md`.
+10. **OpenAI App Directory final submit**, in the partner portal, once B3 is cleared by a deploy.
+11. **Deploy** to pick up the two em-dash title corrections and the OpenAI B3 scorer fix. Deploys are
+ owner-gated: `npm run deploy:gcp:full`.
diff --git a/prompts/store-submissions/_generated/build-mcp-listing-source.mjs b/prompts/store-submissions/_generated/build-mcp-listing-source.mjs
deleted file mode 100644
index 72378db9b..000000000
--- a/prompts/store-submissions/_generated/build-mcp-listing-source.mjs
+++ /dev/null
@@ -1,160 +0,0 @@
-// Build prompts/store-submissions/_generated/mcp-listing-source.json — the ONE
-// canonical metadata source every third-party MCP directory listing derives
-// from, so copy never drifts across Smithery / Glama / mcp.so / PulseMCP /
-// LobeHub. Shared, factual fields (name, title, description, version, repo,
-// website, connect snippet, tools) are read live from the server*.json
-// manifests. Curated fields (tagline, category, tags, examplePrompts) live in
-// the OVERLAY below and are the only thing a human edits by hand.
-//
-// Run: node prompts/store-submissions/_generated/build-mcp-listing-source.mjs
-import { readFileSync, writeFileSync, readdirSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const HERE = dirname(fileURLToPath(import.meta.url));
-const ROOT = resolve(HERE, '../../..');
-
-// ---- Curated overlay: keyed by manifest `name`. Everything else is derived. ----
-// category ∈ 3d | avatars | payments | agent-economy | market-data | trading |
-// identity | ai-models | account | gaming | learning
-const OVERLAY = {
- 'io.github.nirholas/three.ws': { category: '3d', tags: ['3d', 'avatars', 'gltf', 'solana', 'agents'], tagline: 'Render 3D avatars, validate glTF/GLB, and read on-chain agent data — the flagship three.ws server.', examplePrompts: ['Render the avatar for agent alice as an embeddable 3D viewer.', 'Validate and optimize this GLB and report its triangle count.', 'Search public three.ws avatars for a cyberpunk knight.'] },
- 'io.github.nirholas/threews-3d-studio': { category: '3d', tags: ['text-to-3d', 'image-to-3d', 'rigging', 'glb', 'x402'], tagline: 'Turn text or an image into an animation-ready GLB: generate, auto-rig, retexture, optimize.', examplePrompts: ['Generate a 3D model of a brass steampunk owl and rig it for animation.', 'Turn these three reference photos into a textured GLB.', 'Auto-rig this GLB so I can animate it.'] },
- 'io.github.nirholas/threews-3d-studio-free': { category: '3d', tags: ['text-to-3d', 'free', 'avatars', 'rigging', 'nvidia-nim'], tagline: 'Free text/image → 3D. Five tools, no auth, no payment — forge meshes and rigged avatars on the house.', examplePrompts: ['Free: forge a 3D model of a mushroom house from text.', 'Free: make a rigged 3D avatar of an astronaut in one step.', 'Free: auto-rig this GLB for animation.'] },
- 'io.github.nirholas/threews-agent': { category: 'payments', tags: ['x402', 'wallet', 'usdc', 'agent-payments', 'spend-caps'], tagline: 'Give your agent an x402 wallet: discover, pay for, and earn from services in USDC, bounded by spend caps.', examplePrompts: ['What is my agent wallet balance?', 'Find an x402 image-generation service and pay for one call, capped at $0.10.', 'Monetize my endpoint so other agents can pay to use it.'] },
- 'io.github.nirholas/threews-x402-bazaar': { category: 'agent-economy', tags: ['x402', 'discovery', 'marketplace', 'agents', 'usdc'], tagline: 'Discover and price paid agent services across the live x402 facilitator network.', examplePrompts: ['Search the x402 bazaar for crypto price APIs and show their per-call price.', 'Inspect the payment requirements of this x402 endpoint.', 'List the cheapest 3D-generation services on the bazaar.'] },
- 'io.github.nirholas/threews-pumpfun': { category: 'market-data', tags: ['pumpfun', 'solana', 'tokens', 'free', 'read-only'], tagline: 'Free, read-only pump.fun + Solana token discovery and on-chain analysis.', examplePrompts: ['Show details and the bonding curve for this pump.fun mint.', 'Who are the top holders of this Solana token?', 'List the newest pump.fun launches.'] },
- 'io.github.nirholas/ibm-x402-mcp-remote': { category: 'ai-models', tags: ['ibm', 'granite', 'x402', 'usdc', 'llm'], tagline: 'Pay-per-use IBM Granite AI via x402: chat, code, embeddings, forecasting. USDC on Base or Solana.', examplePrompts: ['Use IBM Granite to review this function for bugs (pay per call).', 'Get Granite embeddings for these three sentences.', 'Forecast next week from this time series with Granite.'] },
- 'io.github.nirholas/ibm-x402-mcp': { category: 'ai-models', tags: ['ibm', 'granite', 'x402', 'usdc', 'llm'], tagline: 'x402 pay-per-use IBM Granite AI over stdio: chat, code, embeddings, analysis, forecasting — pay USDC per call.', examplePrompts: ['Ask Granite to refactor this function (pay per call).', 'Get Granite embeddings for these documents.', 'Analyze the sentiment of these reviews with Granite.'] },
- 'io.github.nirholas/3d-agent-mcp': { category: '3d', tags: ['text-to-3d', 'rigging', 'reputation', 'market-intel', 'free-and-paid'], tagline: 'Full three.ws 3D + agent toolkit: free and paid text-to-3D, rigging, agent reputation, market intel.', examplePrompts: ['Forge a free 3D model of a katana from text.', 'Generate a rigged avatar of a fox samurai.', "Look up this agent's ERC-8004 reputation."] },
- 'io.github.nirholas/threews-avatar': { category: 'avatars', tags: ['avatars', 'embed', '3d', 'chat-ui', 'gltf'], tagline: 'Drop a live, interactive 3D avatar into any agent chat, or get an embed snippet.', examplePrompts: ['Render a live 3D avatar for agent nova in this chat.', 'Give me an embed code for this avatar.', 'Fetch the GLB and metadata for this avatar id.'] },
- 'io.github.nirholas/3D-AI-Agent-Avatar': { category: 'avatars', tags: ['avatars', 'glb', 'solana', 'voice', 'pumpfun'], tagline: 'Turn any GLB into a riggable 3D AI agent with a Solana wallet, a voice, and pump.fun powers.', examplePrompts: ['Inspect and validate this GLB, then thumbnail it.', 'Optimize this avatar GLB for the web.', 'Give this avatar a Solana wallet and a voice.'] },
- 'io.github.nirholas/scene-mcp': { category: '3d', tags: ['3d', 'scene', 'diorama', 'text-to-scene', 'gallery'], tagline: 'Speak a placed 3D diorama into being from one sentence, then browse the saved scene gallery.', examplePrompts: ['Compose a 3D scene: a campfire ringed by three tents at dusk.', 'Show me the scene I just made.', 'List the latest community scenes.'] },
- 'io.github.nirholas/assistant-widget': { category: '3d', tags: ['3d', 'avatar', 'assistant', 'chatbot', 'widget', 'embed'], tagline: 'Generate a paste-ready 3D avatar assistant widget for any website, a floating chatbot plus speak mode.', examplePrompts: ['Build a 3D assistant widget named Aria with an ocean background for my site.', 'What avatars and backgrounds can the assistant widget use?', 'Give me the embed snippet for a left-positioned chat-only assistant.'] },
- 'io.github.nirholas/loom-mcp': { category: '3d', tags: ['3d', 'gallery', 'community', 'creations', 'viewer'], tagline: 'Browse the community 3D-creation gallery, fetch a creation with its viewer URL, and contribute your own.', examplePrompts: ['Show the newest creations in the Loom gallery.', 'Fetch this creation and give me its viewer link.', 'Submit my GLB to the Loom gallery.'] },
- 'io.github.nirholas/audio-mcp': { category: 'ai-models', tags: ['tts', 'stt', 'lipsync', 'mocap', 'audio'], tagline: 'Text-to-speech, speech-to-text, audio-to-face lipsync, and motion-capture clips for 3D agents.', examplePrompts: ['Convert this text to speech for my avatar.', 'Transcribe this audio clip.', 'Generate audio-to-face lipsync from this voice line.'] },
- 'io.github.nirholas/vision-mcp': { category: 'ai-models', tags: ['vision', 'image', 'analysis', 'captioning', 'ai'], tagline: 'Image understanding for AI agents — analyze and describe any image via the three.ws pipeline.', examplePrompts: ['Describe what is in this image.', 'Analyze this screenshot and list the UI elements.', 'What breed of dog is in this photo?'] },
- 'io.github.nirholas/brain-mcp': { category: 'ai-models', tags: ['llm', 'router', 'multi-provider', 'chat', 'ai'], tagline: 'List LLM providers and run chat completions through the three.ws multi-provider router.', examplePrompts: ['List the available LLM providers.', 'Run this prompt through the cheapest available model.', 'Compare two providers on the same prompt.'] },
- 'io.github.nirholas/ibm-watsonx': { category: 'ai-models', tags: ['ibm', 'watsonx', 'granite', 'embeddings', 'llm'], tagline: 'IBM watsonx.ai on your own account: chat, text generation, embeddings, and tokenization.', examplePrompts: ['Chat with Granite on my watsonx.ai account.', 'Get watsonx embeddings for these documents.', 'Tokenize this text with watsonx.'] },
- 'io.github.nirholas/alibaba-cloud': { category: 'ai-models', tags: ['alibaba', 'qwen', 'dashscope', 'embeddings', 'llm'], tagline: 'Alibaba Cloud DashScope: Qwen chat, embeddings, and model discovery on your own account.', examplePrompts: ['Chat with Qwen on my DashScope account.', 'Get Qwen embeddings for these sentences.', 'List available DashScope models.'] },
- 'io.github.nirholas/x402-mcp': { category: 'payments', tags: ['x402', 'wallet', 'usdc', 'self-custodial', 'payments'], tagline: 'Self-custodial x402 wallet for AI agents: find, inspect, and pay any service in USDC or $THREE from your own key.', examplePrompts: ['Find x402 services that generate images.', 'Inspect the price of this x402 endpoint before paying.', 'Pay and call this x402 endpoint with a $0.05 cap.'] },
- 'io.github.nirholas/x402-bridge': { category: 'payments', tags: ['x402', 'bridge', 'auto-pay', 'spend-caps', 'usdc'], tagline: 'An auto-paying bridge that pays any x402 endpoint on the open web, with Bazaar discovery and spend caps.', examplePrompts: ['Pay this x402 URL and return the response, capped at $0.10 total.', 'Discover a weather x402 API and call it.', 'Set a per-call spend cap and pay this endpoint.'] },
- 'io.github.nirholas/agentcore-payments-mcp': { category: 'payments', tags: ['x402', 'sessions', 'budget', 'allowlist', 'payments'], tagline: 'Governed x402 payment sessions: pay any endpoint with a budget, allowlist, and per-tx caps — no key handling.', examplePrompts: ['Open a $2 payment session allowlisted to this host.', 'Pay this endpoint using my open session.', 'Show my active payment sessions and remaining budget.'] },
- 'io.github.nirholas/three-token-mcp': { category: 'payments', tags: ['three', 'solana', 'burn', 'token', 'defi'], tagline: 'Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token.', examplePrompts: ['What is the current $THREE price?', 'Check my $THREE balance.', 'Burn 1000 $THREE from my wallet.'] },
- 'io.github.nirholas/billing-mcp': { category: 'account', tags: ['billing', 'usage', 'invoices', 'receipts', 'quotas'], tagline: "An agent's account economics — plan quotas, metered usage, invoices, receipts, and earnings.", examplePrompts: ['Show my billing summary for this month.', 'Export my usage history as CSV.', 'Fetch the receipt for my last invoice.'] },
- 'io.github.nirholas/autopilot-mcp': { category: 'agent-economy', tags: ['autopilot', 'agents', 'spend-caps', 'proposals', 'automation'], tagline: 'Set autopilot scopes and a daily SOL spend cap, then propose, execute, and undo agent actions.', examplePrompts: ['Set my autopilot daily cap to 0.5 SOL and enable trade scope.', 'Generate action proposals for my agent.', 'Execute proposal #3, then undo it.'] },
- 'io.github.nirholas/portfolio-mcp': { category: 'trading', tags: ['portfolio', 'pnl', 'balances', 'transfers', 'solana'], tagline: "An agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers.", examplePrompts: ['What is my portfolio value and PnL?', 'Show my live token balances.', 'Send 0.1 SOL to this address.'] },
- 'io.github.nirholas/provenance-mcp': { category: 'identity', tags: ['provenance', 'audit', 'signed', 'on-chain', 'agents'], tagline: 'Append-only, signed, on-chain-verifiable agent action log — record and audit what agents did.', examplePrompts: ['Record this action to my provenance log.', "List my agent's recent actions.", 'Verify this logged action is untampered.'] },
- 'io.github.nirholas/copy-mcp': { category: 'trading', tags: ['copy-trading', 'follow', 'sizing', 'guards', 'solana'], tagline: 'Manage copy-trade follows — follow leaders, tune sizing and guard rules, and track fees owed.', examplePrompts: ['Follow this leader wallet with 2% sizing.', 'List my copy-trade subscriptions.', 'Update the stop-loss guard on this follow.'] },
- 'io.github.nirholas/signals-mcp': { category: 'market-data', tags: ['signals', 'feeds', 'edge', 'publishers', 'subscriptions'], tagline: 'Discover signal feeds ranked by proven edge, rank publishers, and subscribe + track results.', examplePrompts: ['List signal feeds ranked by proven edge.', 'Subscribe to this signal feed.', 'Show the mirror leaderboard of top publishers.'] },
- 'io.github.nirholas/alerts-mcp': { category: 'market-data', tags: ['alerts', 'pumpfun', 'rules', 'webhook', 'telegram'], tagline: 'Create, update, and delete pump.fun alert rules and read fired-alert history across channels.', examplePrompts: ['Alert me when any token crosses $1M market cap.', 'List my active alert rules.', 'Show alerts that fired in the last day.'] },
- 'io.github.nirholas/intel-mcp': { category: 'market-data', tags: ['smart-money', 'wallet-intel', 'signals', 'kol', 'solana'], tagline: 'Coin smart-money scores, wallet reputation, signal feeds, and KOL leaderboards.', examplePrompts: ['Score the smart money behind this coin.', 'Give me the reputation profile of this wallet.', 'Show the KOL leaderboard.'] },
- 'io.github.nirholas/kol-mcp': { category: 'market-data', tags: ['kol', 'wallet', 'pnl', 'trades', 'solana'], tagline: "Per-wallet KOL deep dive — a tracked trader's portfolio P&L and their trades on a given mint.", examplePrompts: ["Show this KOL wallet's portfolio and P&L.", "List this wallet's trades on this mint.", 'How did this trader perform this month?'] },
- 'io.github.nirholas/activity-mcp': { category: 'market-data', tags: ['trending', 'leaderboard', 'three', 'activity', 'discovery'], tagline: 'Trending agents and coins, the $THREE holder leaderboard, and the site-wide activity ticker.', examplePrompts: ['What agents are trending on three.ws right now?', 'Show the $THREE holder leaderboard.', 'Give me the latest platform activity.'] },
- 'io.github.nirholas/pumpfun-solana-mcp': { category: 'market-data', tags: ['pumpfun', 'solana', 'sns', 'analysis', 'free'], tagline: 'Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots.', examplePrompts: ['Analyze this pump.fun token and its holders.', 'Resolve this .sol name to a wallet.', 'Snapshot this token as a 3D object.'] },
- 'io.github.nirholas/vanity-mcp': { category: 'market-data', tags: ['vanity', 'solana', 'addresses', 'market', 'bounties'], tagline: 'Read the three.ws vanity-address market: quote difficulty and USDC price, browse the board.', examplePrompts: ['Quote the difficulty and price for a wallet ending in THREE.', 'Browse the vanity-address board.', 'Appraise the rarity of this vanity address.'] },
- 'io.github.nirholas/agent-sniper': { category: 'trading', tags: ['pumpfun', 'sniper', 'solana', 'self-custodial', 'strategies'], tagline: 'Self-custodial pump.fun sniper: arm strategies, snipe, and manage positions. Simulates by default.', examplePrompts: ['Arm a snipe strategy for new launches by this dev (simulate).', 'Fire a manual buy on this mint for 0.05 SOL.', 'Show my open sniper positions.'] },
- 'io.github.nirholas/naming-mcp': { category: 'identity', tags: ['sns', 'naming', 'sol', 'identity', 'resolve'], tagline: 'On-chain identity for AI agents: resolve .sol names, reverse-lookup wallets, check handle availability.', examplePrompts: ['Resolve alice.sol to a wallet address.', 'Reverse-lookup the .sol name for this wallet.', 'Is nova.threews.sol available?'] },
- 'io.github.nirholas/marketplace-mcp': { category: 'agent-economy', tags: ['marketplace', 'agents', 'skills', 'discovery', 'read-only'], tagline: 'Browse and discover the public three.ws agent marketplace and skills catalog. Read-only.', examplePrompts: ['Browse trading agents on the three.ws marketplace.', 'Show details for this agent.', 'List the available agent skill categories.'] },
- 'io.github.nirholas/agenc-mcp': { category: 'agent-economy', tags: ['agenc', 'tasks', 'registry', 'coordination', 'on-chain'], tagline: 'Browse the AgenC on-chain task marketplace, query the agent registry, and link identities.', examplePrompts: ['List open tasks on the AgenC marketplace.', 'Get the status of this AgenC task.', 'Look up this agent in the AgenC registry.'] },
- 'io.github.nirholas/agora-mcp': { category: 'agent-economy', tags: ['agora', 'economy', 'bounties', 'work', 'three'], tagline: 'Join the Agora agent economy over MCP: browse the board, register, claim on-chain work, and post bounties.', examplePrompts: ['Show the Agora job board.', 'Register my agent as an Agora citizen.', 'Claim this bounty and mark it complete.'] },
- 'io.github.nirholas/clash-mcp': { category: 'gaming', tags: ['game', 'clash', 'factions', 'leaderboard', 'three'], tagline: 'Play three.ws Coin Clash — read the faction battle board and leaderboard, enlist, and rally.', examplePrompts: ['Show the current Coin Clash battle state.', 'Enlist me in the strongest faction.', 'Rally my faction with a boost.'] },
- 'io.github.nirholas/tutor-mcp': { category: 'learning', tags: ['tutor', 'learning', 'ledger', 'invoice', 'pay-as-you-learn'], tagline: "Read a Pay-As-You-Learn tutoring session's itemized tab and close it for an attested invoice.", examplePrompts: ['Show the itemized tab for my tutoring session.', 'Close this session and give me the invoice.', 'How much have I spent this session?'] },
- 'io.github.nirholas/notifications-mcp': { category: 'account', tags: ['notifications', 'inbox', 'web-push', 'preferences', 'agents'], tagline: "An agent's inbox — read notifications, mark them read, manage delivery preferences, and register Web Push devices.", examplePrompts: ['Show my unread notifications.', 'Mark all notifications as read.', 'Turn off Telegram delivery and keep Web Push.'] },
-};
-
-// ---- Derive the rest from the manifests ----
-function findManifests() {
- const out = [];
- // root-level server*.json
- for (const f of readdirSync(ROOT)) {
- if (/^server[^/]*\.json$/.test(f)) out.push(join(ROOT, f));
- }
- // mcp-server, mcp-bridge, packages/*
- for (const d of ['mcp-server', 'mcp-bridge']) out.push(join(ROOT, d, 'server.json'));
- for (const p of readdirSync(join(ROOT, 'packages'))) {
- const f = join(ROOT, 'packages', p, 'server.json');
- try { readFileSync(f); out.push(f); } catch { /* no manifest */ }
- }
- return [...new Set(out)].filter((f) => { try { readFileSync(f); return true; } catch { return false; } });
-}
-
-const REMOTE_NPM = new Set(); // dedupe
-const servers = [];
-for (const f of findManifests()) {
- const j = JSON.parse(readFileSync(f, 'utf8'));
- const o = OVERLAY[j.name];
- if (!o) { console.warn('NO OVERLAY for', j.name, '(' + f.replace(ROOT + '/', '') + ')'); }
- const remote = (j.remotes || [])[0];
- const pkg = (j.packages || [])[0];
- let connect, type;
- if (remote) {
- type = 'remote';
- connect = remote.url;
- } else if (pkg) {
- type = 'stdio';
- const args = (pkg.packageArguments || []).map((a) => a.value).filter(Boolean).join(' ');
- connect = `npx -y ${pkg.identifier}${args ? ' ' + args : ''}`;
- }
- const requiredEnv = ((pkg && pkg.environmentVariables) || []).filter((e) => e.isRequired).map((e) => e.name);
- servers.push({
- name: j.name,
- title: j.title,
- type,
- transport: remote ? (remote.type || 'streamable-http') : 'stdio',
- connect,
- npmPackage: pkg ? pkg.identifier : null,
- version: j.version,
- description: j.description,
- tagline: o?.tagline || j.description,
- category: o?.category || 'agents',
- tags: o?.tags || [],
- examplePrompts: o?.examplePrompts || [],
- requiredEnv,
- websiteUrl: j.websiteUrl || 'https://three.ws',
- repository: j.repository?.url || 'https://github.com/nirholas/three.ws',
- registryUrl: `https://registry.modelcontextprotocol.io/?q=${encodeURIComponent(j.name)}`,
- icon: 'https://three.ws/three-ws-mcp-icon.svg',
- });
-}
-
-servers.sort((a, b) => (a.type === b.type ? a.name.localeCompare(b.name) : a.type === 'remote' ? -1 : 1));
-
-const doc = {
- $comment: 'CANONICAL SOURCE OF TRUTH for every three.ws MCP directory listing. Regenerate with build-mcp-listing-source.mjs — do NOT hand-edit this JSON; edit the OVERLAY in that script. Factual fields (name/title/description/version/connect/tags-from-manifest) are read live from server*.json so listings can never drift from the manifests.',
- generatedBy: 'prompts/store-submissions/_generated/build-mcp-listing-source.mjs',
- publisher: {
- name: 'three.ws',
- namespace: 'io.github.nirholas',
- website: 'https://three.ws',
- repository: 'https://github.com/nirholas/three.ws',
- contactEmail: '[email protected]',
- officialRegistrySearch: 'https://registry.modelcontextprotocol.io/?q=io.github.nirholas',
- promotedCoin: '$THREE (Solana: FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump)',
- icon: 'https://three.ws/three-ws-mcp-icon.svg',
- },
- fieldConsumers: {
- name: 'Official registry name; Glama/PulseMCP match this to the registry entry.',
- title: 'Display name on Smithery, mcp.so, LobeHub cards.',
- tagline: 'One-line summary for Smithery/mcp.so/LobeHub card subtitle.',
- description: 'Long description body on every directory.',
- category: 'Smithery + LobeHub category; mcp.so tag group.',
- tags: 'Smithery/Glama/mcp.so/LobeHub keyword tags.',
- connect: 'Install/connect snippet — remote URL for Smithery URL-publish; `npx` for stdio config JSON.',
- examplePrompts: 'LobeHub + mcp.so "example usage"; Smithery README examples.',
- icon: 'Card/avatar image on all directories.',
- },
- counts: {
- total: servers.length,
- remote: servers.filter((s) => s.type === 'remote').length,
- stdio: servers.filter((s) => s.type === 'stdio').length,
- },
- servers,
-};
-
-const outPath = join(HERE, 'mcp-listing-source.json');
-writeFileSync(outPath, JSON.stringify(doc, null, 2) + '\n');
-console.log(`Wrote ${outPath}`);
-console.log(` ${doc.counts.total} servers (${doc.counts.remote} remote, ${doc.counts.stdio} stdio)`);
-const missing = servers.filter((s) => !OVERLAY[s.name]);
-if (missing.length) console.log(' MISSING OVERLAY:', missing.map((s) => s.name).join(', '));
diff --git a/prompts/store-submissions/_generated/claude-reviewer-guide.md b/prompts/store-submissions/_generated/claude-reviewer-guide.md
index b0603a735..c4e35bd5a 100644
--- a/prompts/store-submissions/_generated/claude-reviewer-guide.md
+++ b/prompts/store-submissions/_generated/claude-reviewer-guide.md
@@ -1,8 +1,10 @@
# Claude Connectors — reviewer setup & verification guide
**Connector:** three.ws 3D Agent — `io.github.nirholas/3d-agent-mcp`
-**Package:** npm `@three-ws/mcp-server` (v1.2.0+) · **Transport:** stdio (MCP 2025-06-18)
-**Surface:** 17 tools — **1 free** (`forge_free`) + **16 paid** (x402 USDC on Solana mainnet, `exact` scheme).
+**Package:** npm `@three-ws/mcp-server` (v1.2.2+) · **Transport:** stdio (MCP 2025-06-18)
+**Surface:** 25 tools, measured live 2026-09-03 by `npm run audit:mcp-reviewer`: **5 free**
+(`forge_free`, `vanity_premium`, `crypto_news`, `crypto_news_digest`, `crypto_news_archive`) +
+**20 paid** (x402 USDC on Solana mainnet, `exact` scheme).
This guide lets someone with **zero prior context** verify the whole server: connect it, run
the free path, exercise the paid tools for real, and understand why the paid tools answer
@@ -114,7 +116,7 @@ payment you get a structured **`PaymentRequired`** — this is the correct, expe
Every priced tool also states its price in its own description (e.g. *"Paid: $0.15 USDC"*) and
in `tools/list` under `pricing`/`extensions.bazaar`. Prices range from **$0.0005**
(`ens_sns_resolve`) to **$0.45** (`forge_avatar`). See
-`claude-tool-call-evidence.md` for the full per-tool table (16/16 verified clean).
+`claude-tool-call-evidence.md` for the full per-tool table (20/20 verified clean on 2026-09-03).
---
@@ -184,19 +186,22 @@ correct behavior across the whole surface.
| Category | Tools | Unpaid | Paid / review-mode result |
|---|---|---|---|
-| **Free 3D** | `forge_free` | *n/a — always free* | real GLB URL + viewer link |
-| **3D generation** | `text_to_avatar`, `mesh_forge`, `rig_mesh`, `forge_avatar` | clean `PaymentRequired` | GLB / rigged-GLB URL + `preview`/`poseStudioUrl` |
+| **Free 3D** | `forge_free` | *n/a, always free* | real GLB URL + viewer link |
+| **Free news** | `crypto_news`, `crypto_news_digest`, `crypto_news_archive` | *n/a, always free* | recent headlines / a digest / an archive search |
+| **Free catalog** | `vanity_premium` | *n/a, always free* | the premium vanity listings and their prices |
+| **3D generation** | `text_to_avatar`, `mesh_forge`, `rig_mesh`, `forge_avatar`, `refine_model`, `restyle_material` | clean `PaymentRequired` | GLB / rigged-GLB URL + `preview`/`poseStudioUrl` |
| **Pose** | `get_pose_seed` | clean `PaymentRequired` | preset id + seed + `previewUrl` on three.ws/pose |
| **Names** | `ens_sns_resolve` | clean `PaymentRequired` | resolved ENS/SNS address(es) |
| **Market data** | `pump_snapshot`, `sentiment_pulse`, `aixbt_intel`, `aixbt_projects` | clean `PaymentRequired` | live token/market/sentiment JSON |
| **Agents / reputation** | `agent_reputation`, `agent_delegate_action`, `agenc_list_tasks`, `agenc_get_task`, `agenc_get_agent` | clean `PaymentRequired` | on-chain reputation / AgenC task + agent reads |
+| **Agent commerce** | `agent_hire_discover`, `agent_hire` | clean `PaymentRequired` | a reputation-ranked shortlist, then a delegated result with its settlement reference |
| **Solana utility** | `vanity_grinder` | clean `PaymentRequired` | a vanity Solana keypair/seed phrase (treat result as a secret) |
---
## 7. Verification checklist
-- [ ] `claude mcp add 3d-agent -- npx -y @three-ws/mcp-server` connects; `tools/list` shows 17 tools.
+- [ ] `claude mcp add 3d-agent -- npx -y @three-ws/mcp-server` connects; `tools/list` shows 25 tools.
- [ ] `forge_free` returns a real GLB URL; `preview` opens in a browser.
- [ ] Any paid tool, no payment → clean `PaymentRequired` (price + USDC-on-Solana + `payTo`), not a crash.
- [ ] Re-add with `MCP_REVIEW_SECRET`/`MCP_REVIEW_MODE` (token from private notes); `get_pose_seed` returns real data; `text_to_avatar` returns a real GLB (credentialed reviewer instance).
diff --git a/prompts/store-submissions/_generated/claude-tool-call-evidence.md b/prompts/store-submissions/_generated/claude-tool-call-evidence.md
index fa467565f..59832714b 100644
--- a/prompts/store-submissions/_generated/claude-tool-call-evidence.md
+++ b/prompts/store-submissions/_generated/claude-tool-call-evidence.md
@@ -2,7 +2,9 @@
**Connector:** `io.github.nirholas/3d-agent-mcp` — npm `@three-ws/[email protected]`, stdio transport.
**Captured:** 2026-06-25 (UTC), against production `https://three.ws` for the free lane; payment challenges captured from the shipped tool surface with the built-in default payout.
-**Surface:** 17 tools — **1 free** (`forge_free`) + **16 paid** (x402 USDC on Solana mainnet, `exact` scheme).
+**Surface (2026-06-25 capture):** 17 tools, 1 free + 16 paid. **Live surface as of 2026-09-03:**
+25 tools, 5 free + 20 paid; see the re-verification at the end of this file, which supersedes the
+counts in the tables below.
Methodology: every tool was driven once. Free tool → real generation. Paid tools were
called with **no x402 payment and no review entitlement** — each must return a clean
@@ -219,3 +221,51 @@ a code defect — flagging for owner awareness, not blocking submission. If tigh
is wanted later, the fix is architectural (move the paid-tool-bypass decision to something the
caller cannot self-supply, e.g. an OAuth-gated remote transport instead of stdio-local env
vars) and is out of scope for this prompt.
+
+
+---
+
+## 2026-09-03 re-verification (submission close-out)
+
+Method changed: the transcripts above were hand-driven and went stale the moment a tool
+landed. The sweep is now one command, `npm run audit:mcp-reviewer`
+([scripts/audit-mcp-reviewer-path.mjs](../../../scripts/audit-mcp-reviewer-path.mjs)), which
+spawns the published stdio server, calls every tool unpaid with schema-valid arguments, and
+fails on any challenge that is malformed, unexplained, or missing a payout field.
+
+### A. Every paid tool still answers a clean challenge, and there are four more of them
+
+`npm run audit:mcp-reviewer` on 2026-09-03: **20 of 20 paid tools returned a clean
+`PaymentRequired`**, 4 free tools ran, 1 free tool (`forge_free`) was skipped as a
+long-running generation covered by its own smoke test. Zero crashes, zero stack traces, zero
+unsubstituted payout placeholders.
+
+The four paid tools missing from the 16-row table above are `refine_model` ($0.25),
+`restyle_material` ($0.05), `agent_hire` ($0.05) and `agent_hire_discover` ($0.01); every
+price in that table still matches what the server quotes today.
+
+A note for anyone re-running this by hand: `rig_mesh`, `refine_model`, `restyle_material` and
+`pump_snapshot` constrain their inputs (a `format: uri` GLB URL, a 32-character base58 mint).
+Call them with a placeholder that fails those bounds and the MCP SDK answers `-32602` before
+the payment wrapper ever runs, and the tool reads as free. The audit script carries valid
+sample values so that cannot happen silently.
+
+### B. The reviewer entitlement works, and only with the right secret
+
+The same run mints a fresh random `MCP_REVIEW_SECRET`, starts the server with it, and calls
+`get_pose_seed` with a matching `MCP_REVIEW_MODE`: the real handler ran and returned real data
+with no charge. A third run with a deliberately mismatched `MCP_REVIEW_MODE` still got the
+paywall, so the entitlement is a gate rather than a flag. The architectural caveat in §B of the
+2026-07-08 section (a stdio caller can supply both halves itself) is unchanged and still not a
+blocker.
+
+### C. The free lane completes, but slowly
+
+A live `POST https://three.ws/api/mcp-studio tools/call forge_free` with
+`{"prompt":"a small ceramic teapot"}` returned **HTTP 200 after 147 seconds** with a real
+3,674,712-byte GLB (`glTF` magic, `model/gltf-binary`, served from `/cdn/forge/anon/`), and the
+emitted `/viewer?src=` link returned 200. So the 2026-07-08 hang is gone and the lane is
+genuinely end-to-end, but 147s is far longer than the 16.1s measured on 2026-07-15 and longer
+than most reviewer clients will wait. Re-run it immediately before filing and, if it is still
+this slow, expect the reviewer to need the guide's "this can take a couple of minutes" framing
+rather than a live demo.
diff --git a/prompts/store-submissions/_generated/mcp-directories/glama.md b/prompts/store-submissions/_generated/mcp-directories/glama.md
index e49ac4bf3..e115dca7d 100644
--- a/prompts/store-submissions/_generated/mcp-directories/glama.md
+++ b/prompts/store-submissions/_generated/mcp-directories/glama.md
@@ -37,13 +37,13 @@ Glama **ingests the official MCP registry automatically**, so publishing `server
| Server | Name (registry) | Connect | What it does |
|---|---|---|---|
-| **three.ws Avatars & Agents** | `io.github.nirholas/three.ws` | `https://three.ws/api/mcp` | Render 3D avatars, validate glTF/GLB, and read on-chain agent data — the flagship three.ws server. |
+| **three.ws Avatars & Agents** | `io.github.nirholas/three.ws` | `https://three.ws/api/mcp` | Render 3D avatars, validate glTF/GLB, and read on-chain agent data. The flagship three.ws server. |
| **three.ws 3D Studio** | `io.github.nirholas/threews-3d-studio` | `https://three.ws/api/mcp-3d` | Turn text or an image into an animation-ready GLB: generate, auto-rig, retexture, optimize. |
-| **three.ws 3D Studio (free)** | `io.github.nirholas/threews-3d-studio-free` | `https://three.ws/api/mcp-studio` | Free text/image → 3D. Five tools, no auth, no payment — forge meshes and rigged avatars on the house. |
+| **three.ws 3D Studio (free)** | `io.github.nirholas/threews-3d-studio-free` | `https://three.ws/api/mcp-studio` | Free text/image → 3D. Five tools, no auth, no payment: forge meshes and rigged avatars on the house. |
| **three.ws Agent Wallet** | `io.github.nirholas/threews-agent` | `https://three.ws/api/mcp-agent` | Give your agent an x402 wallet: discover, pay for, and earn from services in USDC, bounded by spend caps. |
| **three.ws x402 Bazaar** | `io.github.nirholas/threews-x402-bazaar` | `https://three.ws/api/mcp-bazaar` | Discover and price paid agent services across the live x402 facilitator network. |
| **x402 Wallet** | `io.github.nirholas/x402-mcp` | `npx -y @three-ws/x402-mcp` | Self-custodial x402 wallet for AI agents: find, inspect, and pay any service in USDC or $THREE from your own key. |
-| **$THREE Token** | `io.github.nirholas/three-token-mcp` | `npx -y @three-ws/three-token-mcp` | Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token. |
+| **$THREE Token** | `io.github.nirholas/three-token-mcp` | `npx -y @three-ws/three-token-mcp` | Price, hold, and burn $THREE on Solana. The first MCP server whose actions burn a token. |
| **pump.fun Solana Data** | `io.github.nirholas/pumpfun-solana-mcp` | `npx -y @three-ws/pumpfun-mcp` | Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots. |
| **IBM Granite x402 Remote** | `io.github.nirholas/ibm-x402-mcp-remote` | `https://three.ws/api/ibm-mcp` | Pay-per-use IBM Granite AI via x402: chat, code, embeddings, forecasting. USDC on Base or Solana. |
diff --git a/prompts/store-submissions/_generated/mcp-directories/lobehub.md b/prompts/store-submissions/_generated/mcp-directories/lobehub.md
index 579dddf0c..5559d9e86 100644
--- a/prompts/store-submissions/_generated/mcp-directories/lobehub.md
+++ b/prompts/store-submissions/_generated/mcp-directories/lobehub.md
@@ -27,13 +27,13 @@ LobeHub runs **two** systems — MCP servers go through the **MCP Marketplace**,
| Server | Name (registry) | Connect | What it does |
|---|---|---|---|
-| **three.ws Avatars & Agents** | `io.github.nirholas/three.ws` | `https://three.ws/api/mcp` | Render 3D avatars, validate glTF/GLB, and read on-chain agent data — the flagship three.ws server. |
+| **three.ws Avatars & Agents** | `io.github.nirholas/three.ws` | `https://three.ws/api/mcp` | Render 3D avatars, validate glTF/GLB, and read on-chain agent data. The flagship three.ws server. |
| **three.ws 3D Studio** | `io.github.nirholas/threews-3d-studio` | `https://three.ws/api/mcp-3d` | Turn text or an image into an animation-ready GLB: generate, auto-rig, retexture, optimize. |
-| **three.ws 3D Studio (free)** | `io.github.nirholas/threews-3d-studio-free` | `https://three.ws/api/mcp-studio` | Free text/image → 3D. Five tools, no auth, no payment — forge meshes and rigged avatars on the house. |
+| **three.ws 3D Studio (free)** | `io.github.nirholas/threews-3d-studio-free` | `https://three.ws/api/mcp-studio` | Free text/image → 3D. Five tools, no auth, no payment: forge meshes and rigged avatars on the house. |
| **three.ws Agent Wallet** | `io.github.nirholas/threews-agent` | `https://three.ws/api/mcp-agent` | Give your agent an x402 wallet: discover, pay for, and earn from services in USDC, bounded by spend caps. |
| **three.ws x402 Bazaar** | `io.github.nirholas/threews-x402-bazaar` | `https://three.ws/api/mcp-bazaar` | Discover and price paid agent services across the live x402 facilitator network. |
| **x402 Wallet** | `io.github.nirholas/x402-mcp` | `npx -y @three-ws/x402-mcp` | Self-custodial x402 wallet for AI agents: find, inspect, and pay any service in USDC or $THREE from your own key. |
-| **$THREE Token** | `io.github.nirholas/three-token-mcp` | `npx -y @three-ws/three-token-mcp` | Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token. |
+| **$THREE Token** | `io.github.nirholas/three-token-mcp` | `npx -y @three-ws/three-token-mcp` | Price, hold, and burn $THREE on Solana. The first MCP server whose actions burn a token. |
| **pump.fun Solana Data** | `io.github.nirholas/pumpfun-solana-mcp` | `npx -y @three-ws/pumpfun-mcp` | Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots. |
| **IBM Granite x402 Remote** | `io.github.nirholas/ibm-x402-mcp-remote` | `https://three.ws/api/ibm-mcp` | Pay-per-use IBM Granite AI via x402: chat, code, embeddings, forecasting. USDC on Base or Solana. |
diff --git a/prompts/store-submissions/_generated/mcp-directories/mcp-so.md b/prompts/store-submissions/_generated/mcp-directories/mcp-so.md
index 350dc802a..54340a38b 100644
--- a/prompts/store-submissions/_generated/mcp-directories/mcp-so.md
+++ b/prompts/store-submissions/_generated/mcp-directories/mcp-so.md
@@ -25,13 +25,13 @@ Fields mcp.so expects per server: **name, GitHub repo, description, website, tra
| Server | Name (registry) | Connect | What it does |
|---|---|---|---|
-| **three.ws Avatars & Agents** | `io.github.nirholas/three.ws` | `https://three.ws/api/mcp` | Render 3D avatars, validate glTF/GLB, and read on-chain agent data — the flagship three.ws server. |
+| **three.ws Avatars & Agents** | `io.github.nirholas/three.ws` | `https://three.ws/api/mcp` | Render 3D avatars, validate glTF/GLB, and read on-chain agent data. The flagship three.ws server. |
| **three.ws 3D Studio** | `io.github.nirholas/threews-3d-studio` | `https://three.ws/api/mcp-3d` | Turn text or an image into an animation-ready GLB: generate, auto-rig, retexture, optimize. |
-| **three.ws 3D Studio (free)** | `io.github.nirholas/threews-3d-studio-free` | `https://three.ws/api/mcp-studio` | Free text/image → 3D. Five tools, no auth, no payment — forge meshes and rigged avatars on the house. |
+| **three.ws 3D Studio (free)** | `io.github.nirholas/threews-3d-studio-free` | `https://three.ws/api/mcp-studio` | Free text/image → 3D. Five tools, no auth, no payment: forge meshes and rigged avatars on the house. |
| **three.ws Agent Wallet** | `io.github.nirholas/threews-agent` | `https://three.ws/api/mcp-agent` | Give your agent an x402 wallet: discover, pay for, and earn from services in USDC, bounded by spend caps. |
| **three.ws x402 Bazaar** | `io.github.nirholas/threews-x402-bazaar` | `https://three.ws/api/mcp-bazaar` | Discover and price paid agent services across the live x402 facilitator network. |
| **x402 Wallet** | `io.github.nirholas/x402-mcp` | `npx -y @three-ws/x402-mcp` | Self-custodial x402 wallet for AI agents: find, inspect, and pay any service in USDC or $THREE from your own key. |
-| **$THREE Token** | `io.github.nirholas/three-token-mcp` | `npx -y @three-ws/three-token-mcp` | Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token. |
+| **$THREE Token** | `io.github.nirholas/three-token-mcp` | `npx -y @three-ws/three-token-mcp` | Price, hold, and burn $THREE on Solana. The first MCP server whose actions burn a token. |
| **pump.fun Solana Data** | `io.github.nirholas/pumpfun-solana-mcp` | `npx -y @three-ws/pumpfun-mcp` | Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots. |
| **IBM Granite x402 Remote** | `io.github.nirholas/ibm-x402-mcp-remote` | `https://three.ws/api/ibm-mcp` | Pay-per-use IBM Granite AI via x402: chat, code, embeddings, forecasting. USDC on Base or Solana. |
diff --git a/prompts/store-submissions/_generated/mcp-directories/pulsemcp.md b/prompts/store-submissions/_generated/mcp-directories/pulsemcp.md
index 4e9317541..ffaa81f55 100644
--- a/prompts/store-submissions/_generated/mcp-directories/pulsemcp.md
+++ b/prompts/store-submissions/_generated/mcp-directories/pulsemcp.md
@@ -25,13 +25,13 @@ Because PulseMCP is registry-driven, the highest-leverage action is keeping the
| Server | Name (registry) | Connect | What it does |
|---|---|---|---|
-| **three.ws Avatars & Agents** | `io.github.nirholas/three.ws` | `https://three.ws/api/mcp` | Render 3D avatars, validate glTF/GLB, and read on-chain agent data — the flagship three.ws server. |
+| **three.ws Avatars & Agents** | `io.github.nirholas/three.ws` | `https://three.ws/api/mcp` | Render 3D avatars, validate glTF/GLB, and read on-chain agent data. The flagship three.ws server. |
| **three.ws 3D Studio** | `io.github.nirholas/threews-3d-studio` | `https://three.ws/api/mcp-3d` | Turn text or an image into an animation-ready GLB: generate, auto-rig, retexture, optimize. |
-| **three.ws 3D Studio (free)** | `io.github.nirholas/threews-3d-studio-free` | `https://three.ws/api/mcp-studio` | Free text/image → 3D. Five tools, no auth, no payment — forge meshes and rigged avatars on the house. |
+| **three.ws 3D Studio (free)** | `io.github.nirholas/threews-3d-studio-free` | `https://three.ws/api/mcp-studio` | Free text/image → 3D. Five tools, no auth, no payment: forge meshes and rigged avatars on the house. |
| **three.ws Agent Wallet** | `io.github.nirholas/threews-agent` | `https://three.ws/api/mcp-agent` | Give your agent an x402 wallet: discover, pay for, and earn from services in USDC, bounded by spend caps. |
| **three.ws x402 Bazaar** | `io.github.nirholas/threews-x402-bazaar` | `https://three.ws/api/mcp-bazaar` | Discover and price paid agent services across the live x402 facilitator network. |
| **x402 Wallet** | `io.github.nirholas/x402-mcp` | `npx -y @three-ws/x402-mcp` | Self-custodial x402 wallet for AI agents: find, inspect, and pay any service in USDC or $THREE from your own key. |
-| **$THREE Token** | `io.github.nirholas/three-token-mcp` | `npx -y @three-ws/three-token-mcp` | Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token. |
+| **$THREE Token** | `io.github.nirholas/three-token-mcp` | `npx -y @three-ws/three-token-mcp` | Price, hold, and burn $THREE on Solana. The first MCP server whose actions burn a token. |
| **pump.fun Solana Data** | `io.github.nirholas/pumpfun-solana-mcp` | `npx -y @three-ws/pumpfun-mcp` | Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots. |
| **IBM Granite x402 Remote** | `io.github.nirholas/ibm-x402-mcp-remote` | `https://three.ws/api/ibm-mcp` | Pay-per-use IBM Granite AI via x402: chat, code, embeddings, forecasting. USDC on Base or Solana. |
diff --git a/prompts/store-submissions/_generated/mcp-directories/smithery.md b/prompts/store-submissions/_generated/mcp-directories/smithery.md
index 64abaed93..7d0924d98 100644
--- a/prompts/store-submissions/_generated/mcp-directories/smithery.md
+++ b/prompts/store-submissions/_generated/mcp-directories/smithery.md
@@ -28,13 +28,13 @@ Smithery is publisher-driven — publish by **URL** (hosted remote) or **MCPB bu
| Server | Name (registry) | Connect | What it does |
|---|---|---|---|
-| **three.ws Avatars & Agents** | `io.github.nirholas/three.ws` | `https://three.ws/api/mcp` | Render 3D avatars, validate glTF/GLB, and read on-chain agent data — the flagship three.ws server. |
+| **three.ws Avatars & Agents** | `io.github.nirholas/three.ws` | `https://three.ws/api/mcp` | Render 3D avatars, validate glTF/GLB, and read on-chain agent data. The flagship three.ws server. |
| **three.ws 3D Studio** | `io.github.nirholas/threews-3d-studio` | `https://three.ws/api/mcp-3d` | Turn text or an image into an animation-ready GLB: generate, auto-rig, retexture, optimize. |
-| **three.ws 3D Studio (free)** | `io.github.nirholas/threews-3d-studio-free` | `https://three.ws/api/mcp-studio` | Free text/image → 3D. Five tools, no auth, no payment — forge meshes and rigged avatars on the house. |
+| **three.ws 3D Studio (free)** | `io.github.nirholas/threews-3d-studio-free` | `https://three.ws/api/mcp-studio` | Free text/image → 3D. Five tools, no auth, no payment: forge meshes and rigged avatars on the house. |
| **three.ws Agent Wallet** | `io.github.nirholas/threews-agent` | `https://three.ws/api/mcp-agent` | Give your agent an x402 wallet: discover, pay for, and earn from services in USDC, bounded by spend caps. |
| **three.ws x402 Bazaar** | `io.github.nirholas/threews-x402-bazaar` | `https://three.ws/api/mcp-bazaar` | Discover and price paid agent services across the live x402 facilitator network. |
| **x402 Wallet** | `io.github.nirholas/x402-mcp` | `npx -y @three-ws/x402-mcp` | Self-custodial x402 wallet for AI agents: find, inspect, and pay any service in USDC or $THREE from your own key. |
-| **$THREE Token** | `io.github.nirholas/three-token-mcp` | `npx -y @three-ws/three-token-mcp` | Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token. |
+| **$THREE Token** | `io.github.nirholas/three-token-mcp` | `npx -y @three-ws/three-token-mcp` | Price, hold, and burn $THREE on Solana. The first MCP server whose actions burn a token. |
| **pump.fun Solana Data** | `io.github.nirholas/pumpfun-solana-mcp` | `npx -y @three-ws/pumpfun-mcp` | Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots. |
| **IBM Granite x402 Remote** | `io.github.nirholas/ibm-x402-mcp-remote` | `https://three.ws/api/ibm-mcp` | Pay-per-use IBM Granite AI via x402: chat, code, embeddings, forecasting. USDC on Base or Solana. |
@@ -45,7 +45,7 @@ Smithery is publisher-driven — publish by **URL** (hosted remote) or **MCPB bu
- **Registry name:** `io.github.nirholas/three.ws`
- **Type:** Remote (Streamable HTTP) — publish by URL
- **Connect:** `https://three.ws/api/mcp`
-- **Tagline:** Render 3D avatars, validate glTF/GLB, and read on-chain agent data — the flagship three.ws server.
+- **Tagline:** Render 3D avatars, validate glTF/GLB, and read on-chain agent data. The flagship three.ws server.
- **Category:** 3d · **Tags:** 3d, avatars, gltf, solana, agents
- **Description:** 3D avatars, embeds, glTF tools, agent memory, and on-chain agent identity from three.ws.
- **Example prompts:**
@@ -71,7 +71,7 @@ Smithery is publisher-driven — publish by **URL** (hosted remote) or **MCPB bu
- **Registry name:** `io.github.nirholas/threews-3d-studio-free`
- **Type:** Remote (Streamable HTTP) — publish by URL
- **Connect:** `https://three.ws/api/mcp-studio`
-- **Tagline:** Free text/image → 3D. Five tools, no auth, no payment — forge meshes and rigged avatars on the house.
+- **Tagline:** Free text/image → 3D. Five tools, no auth, no payment: forge meshes and rigged avatars on the house.
- **Category:** 3d · **Tags:** text-to-3d, free, avatars, rigging, nvidia-nim
- **Description:** Free text/image → 3D: generate, rig, avatar-ify, and refine GLB models. No auth, no payment.
- **Example prompts:**
@@ -123,7 +123,7 @@ Smithery is publisher-driven — publish by **URL** (hosted remote) or **MCPB bu
- **Registry name:** `io.github.nirholas/three-token-mcp`
- **Type:** Local (stdio) — publish as MCPB bundle or npm
- **Connect:** `npx -y @three-ws/three-token-mcp`
-- **Tagline:** Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token.
+- **Tagline:** Price, hold, and burn $THREE on Solana. The first MCP server whose actions burn a token.
- **Category:** payments · **Tags:** three, solana, burn, token, defi
- **Description:** Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token.
- **Example prompts:**
diff --git a/prompts/store-submissions/_generated/mcp-listing-source.json b/prompts/store-submissions/_generated/mcp-listing-source.json
index d8f55c120..dccd97d2f 100644
--- a/prompts/store-submissions/_generated/mcp-listing-source.json
+++ b/prompts/store-submissions/_generated/mcp-listing-source.json
@@ -18,7 +18,7 @@
"description": "Long description body on every directory.",
"category": "Smithery + LobeHub category; mcp.so tag group.",
"tags": "Smithery/Glama/mcp.so/LobeHub keyword tags.",
- "connect": "Install/connect snippet — remote URL for Smithery URL-publish; `npx` for stdio config JSON.",
+ "connect": "Install/connect snippet: remote URL for Smithery URL-publish; `npx` for stdio config JSON.",
"examplePrompts": "LobeHub + mcp.so \"example usage\"; Smithery README examples.",
"icon": "Card/avatar image on all directories."
},
@@ -182,7 +182,7 @@
"npmPackage": "@three-ws/agentcore-payments-mcp",
"version": "0.1.4",
"description": "Governed x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key.",
- "tagline": "Governed x402 payment sessions: pay any endpoint with a budget, allowlist, and per-tx caps — no key handling.",
+ "tagline": "Governed x402 payment sessions: pay any endpoint with a budget, allowlist, and per-tx caps, with no key handling.",
"category": "payments",
"tags": [
"x402",
@@ -392,7 +392,7 @@
"npmPackage": "@three-ws/billing-mcp",
"version": "0.1.2",
"description": "An agent's account economics — plan quotas, metered usage, invoices, receipts, and earnings.",
- "tagline": "An agent's account economics — plan quotas, metered usage, invoices, receipts, and earnings.",
+ "tagline": "An agent's account economics: plan quotas, metered usage, invoices, receipts, and earnings.",
"category": "account",
"tags": [
"billing",
@@ -452,7 +452,7 @@
"npmPackage": "@three-ws/clash-mcp",
"version": "0.1.2",
"description": "Play three.ws Coin Clash — read the faction battle board and leaderboard, enlist, and rally.",
- "tagline": "Play three.ws Coin Clash — read the faction battle board and leaderboard, enlist, and rally.",
+ "tagline": "Play three.ws Coin Clash: read the faction battle board and leaderboard, enlist, and rally.",
"category": "gaming",
"tags": [
"game",
@@ -500,7 +500,7 @@
"npmPackage": "@three-ws/copy-mcp",
"version": "0.1.2",
"description": "Manage copy-trade follows — follow leaders, tune sizing and guard rules, and track fees owed.",
- "tagline": "Manage copy-trade follows — follow leaders, tune sizing and guard rules, and track fees owed.",
+ "tagline": "Manage copy-trade follows: follow leaders, tune sizing and guard rules, and track fees owed.",
"category": "trading",
"tags": [
"copy-trading",
@@ -654,7 +654,7 @@
"npmPackage": "@three-ws/ibm-x402-mcp",
"version": "1.1.3",
"description": "x402 pay-per-use IBM Granite AI: chat, code, embeddings, analysis, forecasting. Pay USDC per call.",
- "tagline": "x402 pay-per-use IBM Granite AI over stdio: chat, code, embeddings, analysis, forecasting — pay USDC per call.",
+ "tagline": "x402 pay-per-use IBM Granite AI over stdio: chat, code, embeddings, analysis, forecasting, paying USDC per call.",
"category": "ai-models",
"tags": [
"ibm",
@@ -773,7 +773,7 @@
"npmPackage": "@three-ws/kol-mcp",
"version": "0.1.1",
"description": "Per-wallet KOL deep dive — a tracked trader's portfolio P&L and its trades on a given mint.",
- "tagline": "Per-wallet KOL deep dive — a tracked trader's portfolio P&L and their trades on a given mint.",
+ "tagline": "Per-wallet KOL deep dive: a tracked trader's portfolio P&L and their trades on a given mint.",
"category": "market-data",
"tags": [
"kol",
@@ -918,7 +918,7 @@
"npmPackage": "@three-ws/notifications-mcp",
"version": "0.1.3",
"description": "Read the inbox, mark items read, manage delivery preferences, and register Web Push devices.",
- "tagline": "An agent's inbox — read notifications, mark them read, manage delivery preferences, and register Web Push devices.",
+ "tagline": "An agent's inbox: read notifications, mark them read, manage delivery preferences, and register Web Push devices.",
"category": "account",
"tags": [
"notifications",
@@ -978,7 +978,7 @@
"npmPackage": "@three-ws/portfolio-mcp",
"version": "0.1.1",
"description": "An agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers.",
- "tagline": "An agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers.",
+ "tagline": "An agent's trading state: portfolio value, PnL, live balances, trade feed, and signed transfers.",
"category": "trading",
"tags": [
"portfolio",
@@ -1009,7 +1009,7 @@
"npmPackage": "@three-ws/provenance-mcp",
"version": "0.1.2",
"description": "Append-only, signed, on-chain-verifiable agent action log — record and audit what agents did.",
- "tagline": "Append-only, signed, on-chain-verifiable agent action log — record and audit what agents did.",
+ "tagline": "Append-only, signed, on-chain-verifiable agent action log: record and audit what agents did.",
"category": "identity",
"tags": [
"provenance",
@@ -1127,7 +1127,7 @@
"npmPackage": "@three-ws/three-token-mcp",
"version": "1.1.2",
"description": "Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token.",
- "tagline": "Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token.",
+ "tagline": "Price, hold, and burn $THREE on Solana. The first MCP server whose actions burn a token.",
"category": "payments",
"tags": [
"three",
@@ -1156,7 +1156,7 @@
"npmPackage": null,
"version": "1.0.1",
"description": "3D avatars, embeds, glTF tools, agent memory, and on-chain agent identity from three.ws.",
- "tagline": "Render 3D avatars, validate glTF/GLB, and read on-chain agent data — the flagship three.ws server.",
+ "tagline": "Render 3D avatars, validate glTF/GLB, and read on-chain agent data. The flagship three.ws server.",
"category": "3d",
"tags": [
"3d",
@@ -1214,7 +1214,7 @@
"npmPackage": null,
"version": "1.0.1",
"description": "Free text/image → 3D: generate, rig, avatar-ify, and refine GLB models. No auth, no payment.",
- "tagline": "Free text/image → 3D. Five tools, no auth, no payment — forge meshes and rigged avatars on the house.",
+ "tagline": "Free text/image → 3D. Five tools, no auth, no payment: forge meshes and rigged avatars on the house.",
"category": "3d",
"tags": [
"text-to-3d",
@@ -1417,7 +1417,7 @@
"npmPackage": "@three-ws/vision-mcp",
"version": "0.1.1",
"description": "Image understanding for AI agents — analyze and describe any image via the three.ws pipeline.",
- "tagline": "Image understanding for AI agents — analyze and describe any image via the three.ws pipeline.",
+ "tagline": "Image understanding for AI agents: analyze and describe any image via the three.ws pipeline.",
"category": "ai-models",
"tags": [
"vision",
diff --git a/public/studio/studio.js b/public/studio/studio.js
index e2873a3a1..7f9ce79d9 100644
--- a/public/studio/studio.js
+++ b/public/studio/studio.js
@@ -845,7 +845,7 @@ function mountAgentChatExtras(wrap) {
wrap.appendChild(
boolField(
'responsive',
- 'Responsive width — fills its container instead of a fixed size',
+ 'Responsive width: fills its container instead of a fixed size',
state.config.responsive === true,
),
);
@@ -1638,8 +1638,8 @@ function selectByModelUrl(url) {
// anything left to ask for.
toast(
URL_BAKED_TYPES.has(state.type)
- ? 'Using your hosted model — the embed snippet points straight at this URL'
- : 'Previewing this model — pick or save an avatar from your library to publish',
+ ? 'Using your hosted model: the embed snippet points straight at this URL'
+ : 'Previewing this model: pick or save an avatar from your library to publish',
'info',
);
}
diff --git a/scripts/audit-links.mjs b/scripts/audit-links.mjs
index ec7ad0389..c24af5f85 100644
--- a/scripts/audit-links.mjs
+++ b/scripts/audit-links.mjs
@@ -616,7 +616,7 @@ if (AS_JSON) {
console.log(JSON.stringify(report, null, 2));
} else {
const line = (s = '') => console.log(s);
- line(`Link audit — scanned ${findings.scanned} files`);
+ line(`Link audit: scanned ${findings.scanned} files`);
line('');
line(`Broken internal links : ${findings.brokenInternal.length}`);
for (const b of findings.brokenInternal.slice(0, 60)) line(` ✗ ${b.value} (${b.kind}) — ${b.file}:${b.line}`);
diff --git a/scripts/build-mcp-listing-source.mjs b/scripts/build-mcp-listing-source.mjs
index f35689115..90563b909 100644
--- a/scripts/build-mcp-listing-source.mjs
+++ b/scripts/build-mcp-listing-source.mjs
@@ -46,7 +46,7 @@ const FIELD_CONSUMERS = {
description: 'Long description body on every directory.',
category: 'Smithery + LobeHub category; mcp.so tag group.',
tags: 'Smithery/Glama/mcp.so/LobeHub keyword tags.',
- connect: 'Install/connect snippet — remote URL for Smithery URL-publish; `npx` for stdio config JSON.',
+ connect: 'Install/connect snippet: remote URL for Smithery URL-publish; `npx` for stdio config JSON.',
examplePrompts: 'LobeHub + mcp.so "example usage"; Smithery README examples.',
icon: 'Card/avatar image on all directories.',
};
@@ -125,7 +125,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/three.ws": {
- tagline: "Render 3D avatars, validate glTF/GLB, and read on-chain agent data — the flagship three.ws server.",
+ tagline: "Render 3D avatars, validate glTF/GLB, and read on-chain agent data. The flagship three.ws server.",
category: "3d",
tags: ["3d","avatars","gltf","solana","agents"],
examplePrompts: [
@@ -145,7 +145,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/threews-3d-studio-free": {
- tagline: "Free text/image → 3D. Five tools, no auth, no payment — forge meshes and rigged avatars on the house.",
+ tagline: "Free text/image → 3D. Five tools, no auth, no payment: forge meshes and rigged avatars on the house.",
category: "3d",
tags: ["text-to-3d","free","avatars","rigging","nvidia-nim"],
examplePrompts: [
@@ -235,7 +235,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/agentcore-payments-mcp": {
- tagline: "Governed x402 payment sessions: pay any endpoint with a budget, allowlist, and per-tx caps — no key handling.",
+ tagline: "Governed x402 payment sessions: pay any endpoint with a budget, allowlist, and per-tx caps, with no key handling.",
category: "payments",
tags: ["x402","sessions","budget","allowlist","payments"],
examplePrompts: [
@@ -305,7 +305,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/billing-mcp": {
- tagline: "An agent's account economics — plan quotas, metered usage, invoices, receipts, and earnings.",
+ tagline: "An agent's account economics: plan quotas, metered usage, invoices, receipts, and earnings.",
category: "account",
tags: ["billing","usage","invoices","receipts","quotas"],
examplePrompts: [
@@ -325,7 +325,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/clash-mcp": {
- tagline: "Play three.ws Coin Clash — read the faction battle board and leaderboard, enlist, and rally.",
+ tagline: "Play three.ws Coin Clash: read the faction battle board and leaderboard, enlist, and rally.",
category: "gaming",
tags: ["game","clash","factions","leaderboard","three"],
examplePrompts: [
@@ -342,7 +342,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/copy-mcp": {
- tagline: "Manage copy-trade follows — follow leaders, tune sizing and guard rules, and track fees owed.",
+ tagline: "Manage copy-trade follows: follow leaders, tune sizing and guard rules, and track fees owed.",
category: "trading",
tags: ["copy-trading","follow","sizing","guards","solana"],
examplePrompts: [
@@ -362,7 +362,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/ibm-x402-mcp": {
- tagline: "x402 pay-per-use IBM Granite AI over stdio: chat, code, embeddings, analysis, forecasting — pay USDC per call.",
+ tagline: "x402 pay-per-use IBM Granite AI over stdio: chat, code, embeddings, analysis, forecasting, paying USDC per call.",
category: "ai-models",
tags: ["ibm","granite","x402","usdc","llm"],
examplePrompts: [
@@ -382,7 +382,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/kol-mcp": {
- tagline: "Per-wallet KOL deep dive — a tracked trader's portfolio P&L and their trades on a given mint.",
+ tagline: "Per-wallet KOL deep dive: a tracked trader's portfolio P&L and their trades on a given mint.",
category: "market-data",
tags: ["kol","wallet","pnl","trades","solana"],
examplePrompts: [
@@ -422,7 +422,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/notifications-mcp": {
- tagline: "An agent's inbox — read notifications, mark them read, manage delivery preferences, and register Web Push devices.",
+ tagline: "An agent's inbox: read notifications, mark them read, manage delivery preferences, and register Web Push devices.",
category: "account",
tags: ["notifications","inbox","web-push","preferences","agents"],
examplePrompts: [
@@ -432,7 +432,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/portfolio-mcp": {
- tagline: "An agent's trading state — portfolio value, PnL, live balances, trade feed, and signed transfers.",
+ tagline: "An agent's trading state: portfolio value, PnL, live balances, trade feed, and signed transfers.",
category: "trading",
tags: ["portfolio","pnl","balances","transfers","solana"],
examplePrompts: [
@@ -442,7 +442,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/provenance-mcp": {
- tagline: "Append-only, signed, on-chain-verifiable agent action log — record and audit what agents did.",
+ tagline: "Append-only, signed, on-chain-verifiable agent action log: record and audit what agents did.",
category: "identity",
tags: ["provenance","audit","signed","on-chain","agents"],
examplePrompts: [
@@ -482,7 +482,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/three-token-mcp": {
- tagline: "Price, hold, and burn $THREE on Solana — the first MCP server whose actions burn a token.",
+ tagline: "Price, hold, and burn $THREE on Solana. The first MCP server whose actions burn a token.",
category: "payments",
tags: ["three","solana","burn","token","defi"],
examplePrompts: [
@@ -522,7 +522,7 @@ const OVERLAY = {
],
},
"io.github.nirholas/vision-mcp": {
- tagline: "Image understanding for AI agents — analyze and describe any image via the three.ws pipeline.",
+ tagline: "Image understanding for AI agents: analyze and describe any image via the three.ws pipeline.",
category: "ai-models",
tags: ["vision","image","analysis","captioning","ai"],
examplePrompts: [
@@ -642,7 +642,7 @@ const rendered = `${JSON.stringify(doc, null, 2)}\n`;
if (missingCopy.length) {
for (const name of missingCopy) {
- console.error(`[mcp-listing-source] no curated listing copy for ${name} — add it to OVERLAY`);
+ console.error(`[mcp-listing-source] no curated listing copy for ${name}. Add it to OVERLAY`);
}
process.exit(1);
}
@@ -650,7 +650,7 @@ if (missingCopy.length) {
if (CHECK) {
const current = existsSync(OUT) ? readFileSync(OUT, 'utf8') : '';
if (current !== rendered) {
- console.error('[mcp-listing-source] out of date — run node scripts/build-mcp-listing-source.mjs');
+ console.error('[mcp-listing-source] out of date. Run node scripts/build-mcp-listing-source.mjs');
process.exit(1);
}
console.log(`[mcp-listing-source] up to date: ${doc.counts.total} servers (${doc.counts.remote} remote, ${doc.counts.stdio} stdio)`);
diff --git a/scripts/check-merge-conflicts.mjs b/scripts/check-merge-conflicts.mjs
index e969a44ae..0d3c5067b 100644
--- a/scripts/check-merge-conflicts.mjs
+++ b/scripts/check-merge-conflicts.mjs
@@ -77,7 +77,7 @@ const closed = filesWithMarker(CLOSE);
const conflicted = [...opened].filter((f) => basename(f) !== self).sort();
if (!conflicted.length) {
- console.log('check:conflicts — no unresolved merge-conflict markers in tracked files');
+ console.log('check:conflicts: no unresolved merge-conflict markers in tracked files');
process.exit(0);
}
diff --git a/scripts/test-gate.mjs b/scripts/test-gate.mjs
index c9fad2dba..47596cdcc 100644
--- a/scripts/test-gate.mjs
+++ b/scripts/test-gate.mjs
@@ -90,6 +90,6 @@ try {
});
console.log('[test-gate] ✓ all critical-path tests passed');
} catch {
- console.error('[test-gate] ✗ critical-path tests failed — blocking deploy');
+ console.error('[test-gate] ✗ critical-path tests failed, blocking deploy');
process.exit(1);
}
diff --git a/scripts/verify-routes.mjs b/scripts/verify-routes.mjs
index 07a864881..f886c8fdf 100644
--- a/scripts/verify-routes.mjs
+++ b/scripts/verify-routes.mjs
@@ -268,7 +268,7 @@ async function live() {
}
// ───────────────────────── report ─────────────────────────
-console.log(`Route verify — ${catalog.length} catalog pages, ${mainRoutes.length} main routes, ${postRoutes.length} post-filesystem routes.`);
+console.log(`Route verify: ${catalog.length} catalog pages, ${mainRoutes.length} main routes, ${postRoutes.length} post-filesystem routes.`);
console.log(` modeled dist files: ${served.size} · canonical-covered: ${covered} · literal page routes checked for shadows: ${litChecked}`);
console.log(` filesystem boundary (handle:filesystem) present: ${fsIdx !== -1 ? 'yes' : 'NO'}`);
diff --git a/src/copy-panel.js b/src/copy-panel.js
index a1844f0a3..3b2292031 100644
--- a/src/copy-panel.js
+++ b/src/copy-panel.js
@@ -18,17 +18,28 @@
*/
import { escapeHtml } from './trader-format.js';
+import { apiFetch } from './api.js';
const BASE58_RE = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
const $ = (sel, root) => root.querySelector(sel);
+/**
+ * Every call this panel makes goes through the shared client, which is the only
+ * place a single-use CSRF token is minted. A raw fetch() here sent no
+ * x-csrf-token, so every mutation from a trader profile (start copying, save
+ * settings, pause, resume) came back 403 csrf_missing: exactly the drift
+ * src/api.js exists to prevent.
+ *
+ * allowAnonymous keeps the 401 as a Response instead of a redirect, because a
+ * signed-out visitor gets this panel's own sign-in CTA rather than being thrown
+ * off the trader profile they were reading.
+ */
async function api(path, opts = {}) {
- const res = await fetch(path, {
- credentials: 'include',
+ return apiFetch(path, {
+ allowAnonymous: true,
headers: { accept: 'application/json', ...(opts.body ? { 'content-type': 'application/json' } : {}) },
...opts,
});
- return res;
}
export async function mountCopyPanel(el, { leaderAgentId, leaderName, network = 'mainnet' }) {
@@ -158,7 +169,7 @@ function renderActive(el, { existing, leaderName, leaderAgentId, network, drip =
const data = await r.json().catch(() => ({}));
showErr(errEl, data.error_description || 'Could not change this subscription.');
} catch {
- showErr(errEl, 'Network error — try again.');
+ showErr(errEl, 'Network error. Try again.');
}
btn.disabled = false;
btn.textContent = label;
@@ -307,7 +318,7 @@ function renderForm(el, { leaderAgentId, leaderName, network, prefill, drip = nu
btn.disabled = false;
btn.textContent = prefill ? 'Save copy settings' : 'Start copying';
// A leader who has not earned a copyable record is not an error the
- // copier can retry — show exactly what is still missing instead.
+ // copier can retry: show exactly what is still missing instead.
if (data.error === 'leader_not_copyable' && Array.isArray(data.eligibility?.unmet)) {
return showEligibility(errEl, leaderName, data.eligibility);
}
@@ -318,7 +329,7 @@ function renderForm(el, { leaderAgentId, leaderName, network, prefill, drip = nu
mountCopyPanel(el, { leaderAgentId, leaderName, network });
} catch {
btn.disabled = false; btn.textContent = prefill ? 'Save copy settings' : 'Start copying';
- showErr(errEl, 'Network error — try again.');
+ showErr(errEl, 'Network error. Try again.');
}
});
}
@@ -327,7 +338,7 @@ function showErr(el, msg) { el.textContent = msg; el.hidden = false; }
/**
* The copyable-bar refusal, as a checklist. A leader clears this by trading, so
- * the useful answer is which criteria are short and by how much — not "denied".
+ * the useful answer is which criteria are short and by how much, not "denied".
*/
function showEligibility(el, leaderName, eligibility) {
const items = eligibility.unmet
diff --git a/tests/avatar-sculpt-brush.test.js b/tests/avatar-sculpt-brush.test.js
index 2b367dd91..0e25d39d9 100644
--- a/tests/avatar-sculpt-brush.test.js
+++ b/tests/avatar-sculpt-brush.test.js
@@ -1,5 +1,5 @@
/**
- * Free sculpt — src/avatar-sculpt-brush.js, src/avatar-sculpt-doc.js and
+ * Free sculpt: src/avatar-sculpt-brush.js, src/avatar-sculpt-doc.js and
* api/_lib/bake-sculpt.js.
*
* The guarantee under test is the round trip. A brush stroke has to survive:
diff --git a/tests/bake-proportions.test.js b/tests/bake-proportions.test.js
index 00427ac6a..d6cc3f59b 100644
--- a/tests/bake-proportions.test.js
+++ b/tests/bake-proportions.test.js
@@ -1,5 +1,5 @@
/**
- * Server-side proportions baker — api/_lib/bake-proportions.js.
+ * Server-side proportions baker: api/_lib/bake-proportions.js.
*
* The contract this file exists to protect is PARITY. Two code paths write a
* user's build into a GLB and they must agree exactly: