Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

feat(mcp): add /connect so Claude, ChatGPT, Cursor and VS Code users can add three.ws in two clicks, and document the CLI every 401 points at

nirholas1ee0a06c366d
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d93d0b69a..3b09f014f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
## 2026-09-29
+- **Connect three.ws to Claude, ChatGPT, Cursor & VS Code** (`/connect`): Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.
- **Copy Coach: your first copy trade, the careful way** (`/copy-coach`): A guided first copy trade for someone who has never copied one. See a real verified win next to the full record behind it, ghost-copy a leader with fake money, then make one tiny, server-capped copy you sign yourself. The coach answers from the real numbers on the page and never promises returns.
- **Daily Trading Quests** (`/quests`): Five trading quests that reset every UTC midnight: make three trades, fork a verified trade, ghost-copy a new agent, act on a copy intent, and let your agent close a winner. Scored from on-chain proof, rewarded with XP, levels and badges.
- **Docs · Copy Coach** (`/docs/copy-coach`): How the Copy Coach takes a first-timer from a real win and its full record, through a fake-money ghost copy, to one tiny server-capped copy they sign themselves: the starter caps, the confirmation card, the grounded coach answers, and the API.
@@ -13,6 +14,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
- **Docs · Live trade rooms** (`/docs/trade-rooms`): How live trade rooms work: the trader's 3D avatar reacting to each real fill, the board and ticker tape, spectator presence, the receipt, Fork, ghost-copy and copy on every trade, the list view and frame budget, and the rooms, room and SSE stream APIs.
- **Docs · Sentiment Scout** (`/docs/sentiment-scout`): Momentum with receipts: how the Sentiment Scout ranks pump.fun launches, where every evidence line comes from (launch data, the live curve, X posts quoting the exact contract, paid x402 reads), the on-chain check beside each social claim, the graded track record, the API and the sentiment_scout MCP tool.
- **Docs · Syndicates** (`/docs/syndicates`): How copy-trading syndicates work: founding around copyable leaders, joining with your own wallet and caps, how the group curve and rival standing are computed from real copies, and the full API.
+- **Docs · three-ws CLI** (`/docs/cli`): Connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes to three.ws in one command: npx three-ws setup signs you in, writes every client's MCP config and verifies each server with a live tools/list.
- **Live Trade Rooms: watch pump.fun traders trade live in 3D** (`/trade-rooms`): Step into a trader's 3D room and watch their real pump.fun buys and sells land as they fill: the avatar reacts, every trade carries its receipt, P&L and Solscan tx, and one tap forks the trade or ghost-copies the trader. Quiet rooms show the latest real trades and which rooms are live now.
- **Syndicates: copy-trade as a team** (`/syndicates`): Named teams of copiers who follow the same verified pump.fun trader agents together. Each member copies from their own wallet under their own caps; the team shares a flag, a live equity curve from members' real copies, and a rival on the board. No pooled funds, no custody.
- **3D Studio in ChatGPT finishes every model, however long it takes**: ChatGPT stops waiting on a tool after one minute, and a detailed 3D model takes one to four. The 3D Studio plugin now answers inside that minute and the inline viewer finishes the job itself: it shows a live timer, drops the model in the moment it is ready, rigs an avatar's skeleton on its own when that step is still to come, and keeps a refined model's version history so you can flip back to the original. Inspecting an existing model now shows it in the viewer too, avatars always come out as a full body ready to pose even when the prompt helper is unavailable, and busy periods no longer let one ChatGPT user's generations use up everyone else's. (`/docs/mcp-studio`) `[improvement, fix]`
diff --git a/STRUCTURE.md b/STRUCTURE.md
index 182f1229f..e64e2a354 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -223,7 +223,7 @@ bottom.
| On-chain agent invocation | [contracts/agent-invocation/](contracts/agent-invocation) | In-repo | Anchor program: verifiable agent-to-agent skill invocation events. SDK: [agent-protocol-sdk/](agent-protocol-sdk) |
| Escrowed knocks (pay-per-reply) | [contracts/knock-escrow/](contracts/knock-escrow) | In-repo | Anchor program making a knock's payment conditional instead of final: `knock` parks the price in a vault owned by the knock's own PDA, and only three things can happen to it. `answer` pays the owner minus a fee capped at 10% in the program itself, `refuse` refunds the sender in full and takes no fee, and `reclaim` refunds the sender once the reply window closes and can be called by anyone. Each `KnockRecord` snapshots the fee that was in force when it was made, so an authority cannot reprice money already in escrow, and it stores only the SHA-256 of the message and the reply, never their text. The trust-me version of this settles straight to the owner at [api/knock/](api/knock) (row above); this is the version that works between strangers. Both sides are reachable from a browser: senders escrow and crank their own refund from the door page, owners open their on-chain door, answer for payment or refuse for a refund from [/knock](pages/knock.html), all signed by their own wallet ([src/knock/escrow-checkout.js](src/knock/escrow-checkout.js)). Docs: [contracts/knock-escrow/README.md](contracts/knock-escrow/README.md), [docs/knock.md](docs/knock.md). Tests: [tests/knock-escrow-program.test.js](tests/knock-escrow-program.test.js), [tests/knock-escrow-pda.test.js](tests/knock-escrow-pda.test.js), [tests/api-knock-escrowed.test.js](tests/api-knock-escrowed.test.js), [tests/api-knock-escrow-sync.test.js](tests/api-knock-escrow-sync.test.js) |
| Cross-chain SDKs | [sdk/](sdk), [solana-agent-sdk/](solana-agent-sdk), [agent-payments-sdk/](agent-payments-sdk), [agent-protocol-sdk/](agent-protocol-sdk) | Published | Cross-chain agent SDKs |
-| MCP integration | [mcp-server/](mcp-server), [mcp-bridge/](mcp-bridge), [packages/*-mcp/](packages) | 43 npm servers + 7 hosted remote (50 total, incl. the free `/api/mcp-studio` 3D Studio, whose ChatGPT plugin surface [api/mcp-chatgpt.js](api/mcp-chatgpt.js) `→ /api/mcp-chatgpt` serves the eight 3D tools and the model viewer without the persona tools or any `frameDomains`; both doors share [api/_mcp-studio/handler.js](api/_mcp-studio/handler.js), and `SURFACES` in [api/_mcp-studio/dispatch.js](api/_mcp-studio/dispatch.js) defines what each advertises), all in the [MCP registry](https://registry.modelcontextprotocol.io/?q=io.github.nirholas). Canonical metadata: [prompts/store-submissions/_generated/mcp-listing-source.json](prompts/store-submissions/_generated/mcp-listing-source.json), generated from the manifests by [scripts/build-mcp-listing-source.mjs](scripts/build-mcp-listing-source.mjs) (`npm run audit:mcp-listing` fails when it drifts) | Model Context Protocol surface, full server list in [docs/mcp.md](docs/mcp.md). Searchable index of every tool: [pages/mcp-tools.html](pages/mcp-tools.html) `→ /mcp-tools`, rendered from the generated [public/mcp-catalog.json](public/mcp-catalog.json) ([scripts/build-mcp-catalog.mjs](scripts/build-mcp-catalog.mjs), `npm run build:mcp-catalog`, staleness gated by `npm run audit:mcp-catalog`). Tool safety annotations are verified against each handler by [scripts/audit-mcp-safety.mjs](scripts/audit-mcp-safety.mjs) (`npm run audit:mcp-safety`, rules in [scripts/lib/mcp-safety-check.mjs](scripts/lib/mcp-safety-check.mjs), guarded-file list shared with the golden snapshot via [scripts/lib/mcp-tool-sources.mjs](scripts/lib/mcp-tool-sources.mjs)); docs [docs/mcp-safety.md](docs/mcp-safety.md) `→ /docs/mcp-safety`. Trust policy: [api/mcp-policy.js](api/mcp-policy.js) `-> GET /api/mcp-policy` turns those verified labels into a ready-to-paste client allowlist (profiles strict/balanced/open x formats claude/vscode/json), surfaced by the builder panel on `/mcp-tools`. Connector-review readiness (every paid stdio tool answers a clean x402 challenge, and the reviewer entitlement lifts it): [scripts/audit-mcp-reviewer-path.mjs](scripts/audit-mcp-reviewer-path.mjs), `npm run audit:mcp-reviewer`. Tests: [tests/mcp-safety-audit.test.js](tests/mcp-safety-audit.test.js), [tests/mcp-catalog.test.js](tests/mcp-catalog.test.js), [tests/api/mcp-policy.test.js](tests/api/mcp-policy.test.js) |
+| MCP integration | [mcp-server/](mcp-server), [mcp-bridge/](mcp-bridge), [packages/*-mcp/](packages) | 43 npm servers + 7 hosted remote (50 total, incl. the free `/api/mcp-studio` 3D Studio, whose ChatGPT plugin surface [api/mcp-chatgpt.js](api/mcp-chatgpt.js) `→ /api/mcp-chatgpt` serves the eight 3D tools and the model viewer without the persona tools or any `frameDomains`; both doors share [api/_mcp-studio/handler.js](api/_mcp-studio/handler.js), and `SURFACES` in [api/_mcp-studio/dispatch.js](api/_mcp-studio/dispatch.js) defines what each advertises), all in the [MCP registry](https://registry.modelcontextprotocol.io/?q=io.github.nirholas). Canonical metadata: [prompts/store-submissions/_generated/mcp-listing-source.json](prompts/store-submissions/_generated/mcp-listing-source.json), generated from the manifests by [scripts/build-mcp-listing-source.mjs](scripts/build-mcp-listing-source.mjs) (`npm run audit:mcp-listing` fails when it drifts) | Model Context Protocol surface, full server list in [docs/mcp.md](docs/mcp.md). One-click client setup: [pages/connect.html](pages/connect.html) `→ /connect` (Claude, Cursor and VS Code install links plus ChatGPT, Claude Code and generic steps, built live from [public/.well-known/mcp.json](public/.well-known/mcp.json) with tool counts from the catalog; config names match the CLI's `slugForPath`). CLI: [packages/three-ws-cli/](packages/three-ws-cli) (`npx three-ws setup`), docs [docs/cli.md](docs/cli.md) `→ /docs/cli`. Searchable index of every tool: [pages/mcp-tools.html](pages/mcp-tools.html) `→ /mcp-tools`, rendered from the generated [public/mcp-catalog.json](public/mcp-catalog.json) ([scripts/build-mcp-catalog.mjs](scripts/build-mcp-catalog.mjs), `npm run build:mcp-catalog`, staleness gated by `npm run audit:mcp-catalog`). Tool safety annotations are verified against each handler by [scripts/audit-mcp-safety.mjs](scripts/audit-mcp-safety.mjs) (`npm run audit:mcp-safety`, rules in [scripts/lib/mcp-safety-check.mjs](scripts/lib/mcp-safety-check.mjs), guarded-file list shared with the golden snapshot via [scripts/lib/mcp-tool-sources.mjs](scripts/lib/mcp-tool-sources.mjs)); docs [docs/mcp-safety.md](docs/mcp-safety.md) `→ /docs/mcp-safety`. Trust policy: [api/mcp-policy.js](api/mcp-policy.js) `-> GET /api/mcp-policy` turns those verified labels into a ready-to-paste client allowlist (profiles strict/balanced/open x formats claude/vscode/json), surfaced by the builder panel on `/mcp-tools`. Connector-review readiness (every paid stdio tool answers a clean x402 challenge, and the reviewer entitlement lifts it): [scripts/audit-mcp-reviewer-path.mjs](scripts/audit-mcp-reviewer-path.mjs), `npm run audit:mcp-reviewer`. Tests: [tests/mcp-safety-audit.test.js](tests/mcp-safety-audit.test.js), [tests/mcp-catalog.test.js](tests/mcp-catalog.test.js), [tests/api/mcp-policy.test.js](tests/api/mcp-policy.test.js) |
| Awesome 3D Agents (curated list) | Source [data/awesome.json](data/awesome.json), generator [scripts/build-awesome.mjs](scripts/build-awesome.mjs) (`npm run build:awesome`, drift-gated by `npm run check:awesome`, publishable mirror via `npm run awesome:standalone`), outputs [awesome/README.md](awesome/README.md) + [public/awesome.json](public/awesome.json), page [pages/awesome.html](pages/awesome.html) `-> /awesome`, link checker [scripts/check-awesome-links.mjs](scripts/check-awesome-links.mjs) (`npm run awesome:links`) | Live | An awesome-list of everything needed to give an AI agent a body: text-to-3D, capture and splatting, avatars, rigging, motion, lipsync and voice, web renderers, asset pipelines, physics and networking, agent frameworks, datasets, free assets, learning. One JSON source produces both the GitHub-facing list and the searchable page, so they cannot disagree. Every url is fetched and classified (ok / moved / bot-filtered / broken) before it ships; the checker stays out of the deploy path so a third-party outage cannot redden someone else's build. The README is written to pass `npx awesome-lint`: badge on the heading line, no License section, no Contributing entry in the contents, and every description capitalised and ended with a period, all enforced by the generator and by [tests/awesome-list.test.js](tests/awesome-list.test.js). Its last two lint rules read GitHub repository topics, which a list inside a product repo cannot satisfy, so `--standalone` emits a ready-to-publish mirror repo (readme, contributing, code of conduct, license) outside this checkout. Contributing: [awesome/CONTRIBUTING.md](awesome/CONTRIBUTING.md) |
| Agent Skills pack | [.agents/skills/](.agents/skills) (canonical) → manifest [.agents/skills/SKILLS.md](.agents/skills/SKILLS.md), [.agents/skills/skills-pack.json](.agents/skills/skills-pack.json); published 3D subset [public/skills/3d-studio/](public/skills/3d-studio) `→ /skills/3d-studio/` | In-repo; bundled in the `three-ws-core` [plugin](.claude-plugin/marketplace.json); 3D subset live on the site | Portable `SKILL.md` folders (Agent Skills open standard) for any Claude surface, in five categories: 3d/creative (cross-platform-safe), platform/agents (create an agent, author and sell its skills, hire other agents, connect a client to the MCP servers), wallet/payments, intel/trading, ops/production. Counts live in the generated manifest, never here. The 3d/creative ones are also published as a public, downloadable bundle at `/skills/3d-studio/` (`three-ws-3d-skills.zip`), which is what an OpenAI Plugin Directory submission uploads on its Skills tab; a skill referencing a tool [api/_mcp-studio/](api/_mcp-studio) does not declare is dropped rather than shipped as a dead path. Regenerate manifest: `npm run build:skills-pack` (drift gate `npm run check:skills-pack`); regenerate the published bundle: `npm run build:openai-skills` (drift gate `npm run check:openai-skills`, wired into `npm run gate`). Docs: [docs/agent-skills.md](docs/agent-skills.md) |
| Standalone skill repos | [scripts/build-standalone-skill-repos.mjs](scripts/build-standalone-skill-repos.mjs) → `.data/standalone-repos/<repo>/` (gitignored) | Generated on demand; publishing is owner-gated | Assembles the three.ws-origin skills into small, publishable repos so an external user installs with one `/plugin marketplace add nirholas/<repo>` instead of cloning this monorepo: `three-ws-skills` (everything), `three-ws-3d-skills` (the crypto-free 3d/creative subset), `three-ws-agent-economy-skills` (wallet/payments + platform/agents). Each output is a complete one-plugin marketplace (`.claude-plugin/{marketplace,plugin}.json`, `skills/`, generated `README.md` with every trigger, `LICENSE`). Built from the same `collectSkills()` the manifest uses, so a copy cannot drift; nothing is committed here. `npm run build:skill-repos`, validate with `npm run check:skill-repos` (wired into `npm run gate`). Docs: [docs/agent-skills.md](docs/agent-skills.md) |
diff --git a/data/pages.json b/data/pages.json
index 33959fe61..c4beb7751 100644
--- a/data/pages.json
+++ b/data/pages.json
@@ -3902,6 +3902,14 @@
"description": "A priced door to a person: open one at /knock/<username>, set what a single message from a stranger costs, and have your 3D companion deliver what gets through in person. The free and x402 lanes, the refuse-before-charging rule, receipts, the SDK and CLI, and the MCP server.",
"added": "2026-08-28"
},
+ {
+ "path": "/docs/cli",
+ "title": "Docs · three-ws CLI",
+ "description": "Connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes to three.ws in one command: npx three-ws setup signs you in, writes every client's MCP config and verifies each server with a live tools/list.",
+ "priority": 0.6,
+ "changefreq": "monthly",
+ "added": "2026-09-29"
+ },
{
"path": "/docs/mcp",
"title": "Docs · MCP",
@@ -5578,6 +5586,14 @@
"changefreq": "monthly",
"added": "2026-07-30"
},
+ {
+ "path": "/connect",
+ "title": "Connect three.ws to Claude, ChatGPT, Cursor & VS Code",
+ "description": "Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.",
+ "priority": 0.8,
+ "changefreq": "weekly",
+ "added": "2026-09-29"
+ },
{
"path": "/mcp-tools",
"title": "MCP Tool Catalog",
diff --git a/docs/cli.md b/docs/cli.md
new file mode 100644
index 000000000..32de4313e
--- /dev/null
+++ b/docs/cli.md
@@ -0,0 +1,132 @@
+# three-ws CLI
+
+`three-ws` connects any MCP client to three.ws in one command. It signs you in, writes the hosted three.ws MCP servers into every client it finds on your machine (Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI, Hermes), and then proves each one works with a live `tools/list` call.
+
+If you only use one client and it supports remote connectors, the [connect page](/connect) is faster: one click adds three.ws to Claude, Cursor or VS Code, with no terminal. Use the CLI when you want several clients configured at once, per-project config, an API key instead of a browser sign-in, or control over which tools each client may call.
+
+Requires Node.js 20.12 or newer.
+
+## Quick start
+
+```bash
+npx three-ws setup
+```
+
+Setup walks through three steps:
+
+1. **Sign in.** A browser opens on three.ws. Approve the permissions and the terminal picks up the token. If you are already signed in, setup asks whether to keep that account.
+2. **Pick servers and clients.** The server list is read live from [/.well-known/mcp.json](/.well-known/mcp.json), and the clients are the ones detected on this machine. Keyless servers (3D Studio free, pump.fun) are always offered because they need no account.
+3. **Write and verify.** Each client's config file is updated in place (other entries are left alone), then every server is called with `tools/list` so you see a tool count, not a guess.
+
+Restart the client afterwards so it loads the new servers.
+
+## Sign-in options
+
+| Flag | What it does | Use it when |
+|---|---|---|
+| `--oauth` (default) | Browser sign-in with PKCE. Tokens refresh automatically. | Your own machine. |
+| `--device` | Prints a code you approve in any browser, on any device. Yields an API key. | Over SSH, or on a machine with no browser. |
+| `--key [sk_live_...]` | Uses an API key from [Dashboard → API](/dashboard/api), or `THREE_WS_API_KEY`. | CI, servers, scripts. |
+| `--financial` | Also requests the scopes that let tools spend from your agent wallet, within its caps. | You want the assistant to pay for x402 services or trade. |
+
+Without `--financial`, tools that move funds are not granted, whatever the client asks for. Credentials are stored in `~/.config/three-ws/credentials.json` (or `$XDG_CONFIG_HOME/three-ws/`) with file mode 0600.
+
+## Setup options
+
+```bash
+# Only Cursor and VS Code, only the main server and the free 3D studio, no prompts
+npx three-ws setup --clients cursor,vscode --servers three-ws-main,three-ws-studio --yes
+
+# Project-scoped config: writes .mcp.json, .cursor/mcp.json, .vscode/mcp.json, .gemini/settings.json here
+npx three-ws setup --project
+
+# Print the config instead of writing any file
+npx three-ws setup --clients print
+```
+
+| Flag | Values |
+|---|---|
+| `--clients` | `claude-code`, `claude-desktop`, `cursor`, `windsurf`, `vscode`, `codex`, `gemini`, `hermes`, `print` |
+| `--servers` | Server names from `npx three-ws mcp list --available` |
+| `--packages` | Also add stdio `@three-ws/*-mcp` packages |
+| `--project` | Write project-scoped config in the current directory |
+| `--proxy` | Route every server through the local proxy, so your tool choices apply in every client |
+| `--yes` | Never prompt; take the defaults |
+
+### Where each client's config lives
+
+| Client | User config | `--project` config |
+|---|---|---|
+| Claude Code | `~/.claude.json` | `.mcp.json` |
+| Claude Desktop | `Claude/claude_desktop_config.json` in your app-data folder | |
+| Cursor | `~/.cursor/mcp.json` | `.cursor/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` | |
+| VS Code | `Code/User/mcp.json` in your app-data folder | `.vscode/mcp.json` |
+| Codex | `$CODEX_HOME/config.toml` (default `~/.codex`) | |
+| Gemini CLI | `~/.gemini/settings.json` | `.gemini/settings.json` |
+| Hermes | `$HERMES_HOME/config.yaml` (default `~/.hermes`) | |
+
+### Server names
+
+Every client stores a server under the same name, which is also what `--servers`, `mcp add` and `mcp remove` take. The [connect page](/connect) uses the same names, so adding a server both ways never creates a duplicate.
+
+| Name | Endpoint | Account |
+|---|---|---|
+| `three-ws-main` | `https://three.ws/api/mcp` | Sign-in |
+| `three-ws-3d` | `https://three.ws/api/mcp-3d` | Sign-in or x402 |
+| `three-ws-studio` | `https://three.ws/api/mcp-studio` | None |
+| `three-ws-agent` | `https://three.ws/api/mcp-agent` | Sign-in |
+| `three-ws-bazaar` | `https://three.ws/api/mcp-bazaar` | Sign-in or x402 |
+| `three-ws-pump-fun` | `https://three.ws/api/pump-fun-mcp` | None for reads |
+| `three-ws-ibm` | `https://three.ws/api/ibm-mcp` | Sign-in or x402 |
+
+`npx three-ws mcp list --available` prints the live list, which is the source of truth if this table and the directory ever disagree.
+
+## Choosing which tools a client may call
+
+Every tool is labelled read, write or financial ([the catalog](/mcp-tools) shows which is which). By default read and write tools are on and financial tools are off.
+
+```bash
+# See and change the tool selection interactively
+npx three-ws tools
+
+# Turn financial tools on for the main server only
+npx three-ws tools --server three-ws-main --enable financial
+
+# Back to the default
+npx three-ws tools --server three-ws-main --reset
+```
+
+The selection is enforced whichever way you signed in. With a browser sign-in, servers that need an account run through the local proxy (`three-ws proxy`), which also keeps your token fresh: `tools/list` returns only enabled tools, and a call to a disabled one is answered by the proxy with an error explaining how to enable it, without reaching the server. With an API key, the selection travels to the server in the `X-Three-Tools` header, and clients that support a tool allowlist get one written too. `--proxy` routes every server through the proxy regardless.
+
+## All commands
+
+| Command | What it does |
+|---|---|
+| `setup` | Sign in, write servers into clients, verify with `tools/list` |
+| `login` / `logout` | Sign in or switch accounts; `logout` also revokes the OAuth refresh token |
+| `status` / `whoami` | Account, plan, wallet balance, token expiry and every configured client |
+| `mcp list` | Servers configured in each client (`--available` lists every server) |
+| `mcp add <server>` / `mcp remove <server>` | Add or remove one server without prompts |
+| `tools` | Choose which tool tiers or tools each server exposes |
+| `skills <list\|search\|show\|import\|installed>` | Browse and import community agent skills |
+| `proxy <url>` | A stdio bridge to a hosted server; setup writes it into client configs when `--proxy` is used |
+| `fund --amount <usdc> --agent <id>` | Move USDC from an agent wallet into credits. Prints the transfer and asks before sending |
+| `provider use three-ws` / `provider show` | Point this machine's model clients at three.ws inference, billed to your credits |
+| `usage` | Credits, burn rate, days left and recent top-ups |
+| `ask "<prompt>"` | One completion through the active provider |
+
+Global flags: `--json` for machine-readable output, `--origin <url>` (or `THREE_WS_ORIGIN`) to talk to another deployment, `--no-color`.
+
+## Troubleshooting
+
+- **A server returns 401.** The token is missing or expired. Run `npx three-ws login`, or `npx three-ws status` to see what the CLI has stored. Every 401 from a three.ws MCP server includes this hint in its body.
+- **A client does not show the tools.** Restart it; most clients read their MCP config only at startup. `npx three-ws mcp list` confirms the entry was written.
+- **Signing in over SSH.** Use `npx three-ws login --device` and approve the code from any browser.
+- **Revoking access.** Every signed-in client and CLI session is listed under [Dashboard → Settings → Connected apps](/dashboard/settings).
+
+## Related
+
+- [Connect page](/connect): one-click setup for Claude, ChatGPT, Cursor, VS Code and Claude Code
+- [MCP docs](/docs/mcp): the servers, their auth, and how to test locally
+- [MCP tool catalog](/mcp-tools): every tool, its price and its safety label
diff --git a/docs/mcp.md b/docs/mcp.md
index b640097e1..3d3afc8c3 100644
--- a/docs/mcp.md
+++ b/docs/mcp.md
@@ -4,6 +4,8 @@ Model Context Protocol (MCP) lets Claude and other MCP-compatible AI systems int
This document covers the MCP server's tools, authentication, client configuration, and how to test locally.
+**Just want it connected?** [three.ws/connect](/connect) adds three.ws to Claude, ChatGPT, Cursor, VS Code or Claude Code in two clicks, and [`npx three-ws setup`](/docs/cli) configures every client on your machine at once.
+
---
## What is MCP?
diff --git a/docs/nav.json b/docs/nav.json
index 155a8ce6d..a735a57b5 100644
--- a/docs/nav.json
+++ b/docs/nav.json
@@ -954,6 +954,10 @@
"label": "MCP tools catalog",
"path": "mcp-tools"
},
+ {
+ "label": "CLI (npx three-ws)",
+ "path": "cli"
+ },
{
"label": "MCP tool safety",
"path": "mcp-safety"
diff --git a/packages/three-ws-cli/README.md b/packages/three-ws-cli/README.md
new file mode 100644
index 000000000..8807f5c86
--- /dev/null
+++ b/packages/three-ws-cli/README.md
@@ -0,0 +1,51 @@
+# three-ws
+
+Connect any MCP client to [three.ws](https://three.ws) in one command. `three-ws` signs you in, writes the hosted three.ws MCP servers into every client it finds (Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI, Hermes), and verifies each one with a live `tools/list`.
+
+```bash
+npx three-ws setup
+```
+
+Requires Node.js 20.12 or newer.
+
+## What you get
+
+The three.ws MCP servers give your assistant 3D generation (text to 3D, image to 3D, rigged avatars), your agents and their wallets, x402 paid services, and Solana token data. The live list is at [three.ws/.well-known/mcp.json](https://three.ws/.well-known/mcp.json) and every tool is in the [catalog](https://three.ws/mcp-tools).
+
+Using one client that supports remote connectors? [three.ws/connect](https://three.ws/connect) adds three.ws to Claude, Cursor or VS Code in one click, with no terminal.
+
+## Common commands
+
+```bash
+npx three-ws setup --clients cursor,vscode --yes # specific clients, no prompts
+npx three-ws setup --project # project-scoped config in this directory
+npx three-ws login --device # sign in over SSH
+npx three-ws mcp list --available # every server and its name
+npx three-ws tools --server three-ws-main --enable financial
+npx three-ws status
+```
+
+Sign-in is a browser OAuth flow by default. `--device` approves a code from any browser, and `--key sk_live_...` (or `THREE_WS_API_KEY`) uses an API key from [Dashboard → API](https://three.ws/dashboard/api). Tools that move funds are off unless you sign in with `--financial` and enable them.
+
+## Programmatic use
+
+The package exports its building blocks (server directory, client detection, config writers, OAuth helpers) for tools that want to reuse them. List every hosted server and the name clients store it under:
+
+```js
+import { loadDirectory, hostedServers } from 'three-ws';
+
+const origin = 'https://three.ws';
+const directory = await loadDirectory(origin);
+for (const server of hostedServers(directory, origin)) console.log(server.slug, server.url);
+// three-ws-main https://three.ws/api/mcp
+// three-ws-studio https://three.ws/api/mcp-studio
+// ...
+```
+
+## Docs
+
+Full reference, client config paths and troubleshooting: [three.ws/docs/cli](https://three.ws/docs/cli).
+
+## License
+
+Apache-2.0
diff --git a/pages/connect.html b/pages/connect.html
new file mode 100644
index 000000000..7fb41b9a7
--- /dev/null
+++ b/pages/connect.html
@@ -0,0 +1,611 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <script>/* three.ws theme boot: no-flash */(function(){try{var m=localStorage.getItem('twx_theme');var l=m==='auto'?(window.matchMedia&&window.matchMedia('(prefers-color-scheme: light)').matches):m==='light';document.documentElement.setAttribute('data-theme',l?'light':'dark');}catch(e){document.documentElement.setAttribute('data-theme','dark');}})();</script>
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
+ <title>Connect three.ws to Claude, ChatGPT, Cursor &amp; VS Code · three.ws</title>
+ <meta name="description" content="Add three.ws to your AI client in two clicks. One connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools: 3D generation, agents, wallets and x402 payments. Sign in once, no API key to copy." />
+ <link rel="canonical" href="https://three.ws/connect" />
+ <link rel="icon" href="/favicon.ico" sizes="any" />
+ <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+ <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
+ <link rel="manifest" href="/manifest.webmanifest" />
+ <link rel="stylesheet" href="/style.css" />
+ <link rel="stylesheet" href="/nav.css" />
+ <link rel="stylesheet" href="/mobile.css" />
+ <meta property="og:type" content="website" />
+ <meta property="og:title" content="Connect three.ws to your AI client" />
+ <meta property="og:description" content="One URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools. Sign in once, no key to copy." />
+ <meta property="og:url" content="https://three.ws/connect" />
+ <meta property="og:image" content="https://three.ws/api/page-og?s=learn&amp;t=Connect+three.ws+to+your+AI&amp;d=One+URL+gives+Claude%2C+ChatGPT%2C+Cursor%2C+VS+Code+or+Claude+Code+the+three.ws+MCP+tools.+Sign+in+once%2C+no+key+to+copy.&amp;p=%2Fconnect" />
+ <meta name="twitter:card" content="summary_large_image" />
+ <meta name="twitter:title" content="Connect three.ws to your AI client" />
+ <meta name="twitter:description" content="One URL, two clicks: three.ws MCP tools in Claude, ChatGPT, Cursor, VS Code and Claude Code." />
+ <meta name="twitter:image" content="https://three.ws/api/page-og?s=learn&amp;t=Connect+three.ws+to+your+AI&amp;d=One+URL+gives+Claude%2C+ChatGPT%2C+Cursor%2C+VS+Code+or+Claude+Code+the+three.ws+MCP+tools.+Sign+in+once%2C+no+key+to+copy.&amp;p=%2Fconnect" />
+ <meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1" />
+ <meta property="og:locale" content="en_US" />
+ <meta property="og:image:alt" content="Connect three.ws to your AI client" />
+ <meta name="twitter:site" content="@trythreews" />
+ <style>
+ :root { --cn-maxw: 1080px; }
+ * { box-sizing: border-box; }
+ html, body { margin: 0; background: var(--bg-0); color: var(--ink); }
+ body { font-family: var(--font-body, 'Inter', system-ui, sans-serif); min-height: 100vh; }
+ .site-header { position: sticky; top: 0; z-index: 50; background: color-mix(in srgb, var(--bg-0) 82%, transparent); backdrop-filter: blur(10px); }
+ a { color: inherit; }
+ code, pre, kbd { font-family: var(--font-mono, ui-monospace, monospace); }
+
+ .cn-wrap { max-width: var(--cn-maxw); margin: 0 auto; padding: 0 18px 96px; }
+
+ /* ── hero ───────────────────────────────────────────────────────── */
+ .cn-hero { padding: 40px 0 10px; }
+ .cn-eyebrow { font-size: 0.74rem; text-transform: uppercase; letter-spacing: 0.08em; color: var(--accent); font-weight: 650; margin: 0 0 10px; }
+ .cn-hero h1 { font-size: clamp(1.8rem, 4.6vw, 2.8rem); line-height: 1.1; margin: 0 0 12px; letter-spacing: -0.025em; color: var(--ink-bright, var(--ink)); }
+ .cn-hero p { margin: 0; max-width: 64ch; color: var(--ink-dim); line-height: 1.6; font-size: 1.02rem; }
+ .cn-hero p a { text-decoration: underline; text-underline-offset: 3px; }
+ .cn-hero p a:hover { color: var(--ink-bright, var(--ink)); }
+
+ /* ── section chrome ─────────────────────────────────────────────── */
+ .cn-step { margin-top: 34px; }
+ .cn-step-head { display: flex; align-items: baseline; gap: 12px; margin: 0 0 12px; }
+ .cn-step-num {
+ flex: none; width: 26px; height: 26px; display: inline-grid; place-items: center; border-radius: 999px;
+ font-size: 0.8rem; font-weight: 700; color: var(--accent); border: 1px solid color-mix(in srgb, var(--accent) 55%, transparent);
+ transform: translateY(-2px);
+ }
+ .cn-step-head h2 { margin: 0; font-size: 1.15rem; letter-spacing: -0.01em; color: var(--ink-bright, var(--ink)); }
+ .cn-step-head p { margin: 2px 0 0; font-size: 0.88rem; color: var(--ink-dim); }
+
+ /* ── server picker ──────────────────────────────────────────────── */
+ .cn-servers { display: grid; grid-template-columns: repeat(auto-fill, minmax(230px, 1fr)); gap: 10px; }
+ .cn-server {
+ position: relative; display: flex; flex-direction: column; gap: 6px; text-align: left; font: inherit; cursor: pointer;
+ padding: 14px 15px 13px; color: var(--ink); background: var(--surface-1, rgba(255,255,255,0.03));
+ border: 1px solid var(--stroke); border-radius: var(--radius-md, 10px);
+ transition: border-color var(--duration-fast) var(--ease-standard), background var(--duration-fast) var(--ease-standard), transform var(--duration-instant, 80ms) var(--ease-standard);
+ }
+ .cn-server:hover { border-color: var(--stroke-strong); background: var(--surface-2, rgba(255,255,255,0.06)); }
+ .cn-server:active { transform: translateY(1px); }
+ .cn-server:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+ .cn-server[aria-checked="true"] { border-color: var(--accent); background: var(--accent-soft, var(--surface-3)); }
+ .cn-server-top { display: flex; align-items: center; justify-content: space-between; gap: 8px; }
+ .cn-server-name { font-weight: 650; font-size: 0.95rem; color: var(--ink-bright, var(--ink)); }
+ .cn-server-desc { font-size: 0.8rem; line-height: 1.45; color: var(--ink-dim); }
+ .cn-server-meta { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 2px; }
+ .cn-pill {
+ font-size: 0.7rem; font-weight: 600; letter-spacing: 0.02em; padding: 3px 8px; border-radius: 999px;
+ border: 1px solid var(--stroke); color: var(--ink-dim); font-variant-numeric: tabular-nums; white-space: nowrap;
+ }
+ .cn-pill[data-tone="free"] { color: var(--success); border-color: color-mix(in srgb, var(--success) 45%, transparent); }
+ .cn-pill[data-tone="oauth"] { color: var(--accent); border-color: color-mix(in srgb, var(--accent) 45%, transparent); }
+ .cn-pill[data-tone="x402"] { color: var(--wallet-accent, var(--warn)); border-color: color-mix(in srgb, var(--wallet-accent, var(--warn)) 45%, transparent); }
+ .cn-skel { height: 118px; border-radius: var(--radius-md, 10px); border: 1px solid var(--stroke); background: linear-gradient(90deg, var(--surface-1, rgba(255,255,255,0.03)) 0%, var(--surface-2, rgba(255,255,255,0.07)) 50%, var(--surface-1, rgba(255,255,255,0.03)) 100%); background-size: 200% 100%; animation: cn-shimmer 1.4s linear infinite; }
+ @keyframes cn-shimmer { from { background-position: 200% 0; } to { background-position: -200% 0; } }
+ .cn-note { margin: 10px 0 0; font-size: 0.84rem; color: var(--ink-dim); line-height: 1.55; }
+ .cn-note[data-tone="error"] { color: var(--danger); }
+ .cn-note button { font: inherit; color: inherit; background: none; border: 0; padding: 0; text-decoration: underline; text-underline-offset: 3px; cursor: pointer; }
+ .cn-note button:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; border-radius: 3px; }
+
+ /* ── URL box ────────────────────────────────────────────────────── */
+ .cn-url {
+ display: flex; align-items: stretch; gap: 0; margin-top: 16px;
+ border: 1px solid var(--stroke-strong); border-radius: var(--radius-md, 10px); overflow: hidden;
+ background: var(--surface-2, rgba(255,255,255,0.05));
+ }
+ .cn-url-label { flex: none; display: grid; place-items: center; padding: 0 12px; font-size: 0.72rem; font-weight: 650; text-transform: uppercase; letter-spacing: 0.06em; color: var(--ink-dim); border-right: 1px solid var(--stroke); }
+ .cn-url code { flex: 1; min-width: 0; padding: 13px 14px; font-size: 0.95rem; color: var(--ink-bright, var(--ink)); overflow-x: auto; white-space: nowrap; }
+
+ /* ── buttons ────────────────────────────────────────────────────── */
+ .cn-btn {
+ display: inline-flex; align-items: center; justify-content: center; gap: 8px; text-decoration: none;
+ font: inherit; font-size: 0.88rem; font-weight: 650; padding: 10px 16px; cursor: pointer;
+ color: var(--btn-secondary-fg, var(--ink)); background: var(--btn-secondary-bg, var(--surface-3));
+ border: 1px solid var(--btn-secondary-border, var(--stroke-strong)); border-radius: var(--radius-md, 10px);
+ transition: background var(--duration-fast) var(--ease-standard), transform var(--duration-instant, 80ms) var(--ease-standard), border-color var(--duration-fast) var(--ease-standard);
+ }
+ .cn-btn:hover { background: var(--btn-secondary-bg-hover, rgba(255,255,255,0.12)); }
+ .cn-btn:active { transform: translateY(1px); }
+ .cn-btn:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+ .cn-btn[data-variant="primary"] { color: var(--btn-primary-fg, #fff); background: var(--btn-primary-bg, var(--accent)); border-color: var(--btn-primary-border, transparent); }
+ .cn-btn[data-variant="primary"]:hover { background: var(--btn-primary-bg-hover, var(--accent)); }
+ .cn-btn[data-variant="primary"]:active { background: var(--btn-primary-bg-active, var(--accent)); }
+ .cn-btn svg { width: 16px; height: 16px; flex: none; }
+ .cn-url .cn-btn { border-radius: 0; border-width: 0 0 0 1px; }
+ .cn-btn[data-copied="true"] { color: var(--success); }
+
+ /* ── client tabs ────────────────────────────────────────────────── */
+ .cn-tabs { display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 14px; }
+ .cn-tab {
+ font: inherit; font-size: 0.86rem; font-weight: 600; padding: 7px 14px; cursor: pointer; color: var(--ink-dim);
+ background: transparent; border: 1px solid var(--stroke); border-radius: 999px;
+ transition: color var(--duration-fast) var(--ease-standard), border-color var(--duration-fast) var(--ease-standard), background var(--duration-fast) var(--ease-standard);
+ }
+ .cn-tab:hover { color: var(--ink); border-color: var(--stroke-strong); background: var(--surface-1, rgba(255,255,255,0.04)); }
+ .cn-tab:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+ .cn-tab[aria-selected="true"] { color: var(--ink-bright, var(--ink)); border-color: var(--accent); background: var(--accent-soft, var(--surface-3)); }
+ .cn-panel {
+ border: 1px solid var(--stroke); border-radius: var(--radius-lg, 14px); padding: 20px 20px 22px;
+ background: linear-gradient(180deg, var(--surface-2, rgba(255,255,255,0.05)), transparent 70%);
+ animation: cn-in var(--duration-base, 180ms) var(--ease-standard) both;
+ }
+ @keyframes cn-in { from { opacity: 0; transform: translateY(4px); } to { opacity: 1; transform: none; } }
+ .cn-panel[hidden] { display: none; }
+ .cn-panel-lede { margin: 0 0 14px; font-size: 0.92rem; line-height: 1.6; color: var(--ink-dim); max-width: 70ch; }
+ .cn-panel-lede strong { color: var(--ink-bright, var(--ink)); font-weight: 650; }
+ .cn-actions { display: flex; flex-wrap: wrap; gap: 8px; margin: 0 0 16px; }
+ .cn-list { margin: 0; padding: 0 0 0 20px; display: grid; gap: 8px; font-size: 0.9rem; line-height: 1.55; color: var(--ink); max-width: 72ch; }
+ .cn-list li::marker { color: var(--ink-dim); font-variant-numeric: tabular-nums; }
+ .cn-list kbd { font-size: 0.78rem; padding: 1px 6px; border: 1px solid var(--stroke); border-radius: 5px; background: var(--surface-1, rgba(255,255,255,0.04)); }
+ .cn-list code { font-size: 0.84rem; padding: 1px 5px; border-radius: 5px; background: var(--surface-1, rgba(255,255,255,0.05)); }
+ .cn-src { margin: 14px 0 0; font-size: 0.78rem; color: var(--ink-faint, var(--ink-dim)); }
+ .cn-src a { text-decoration: underline; text-underline-offset: 3px; }
+ .cn-src a:hover { color: var(--ink); }
+
+ .cn-snippet { position: relative; margin: 0 0 14px; }
+ .cn-snippet-head { display: flex; align-items: center; justify-content: space-between; gap: 8px; margin: 0 0 6px; font-size: 0.74rem; text-transform: uppercase; letter-spacing: 0.06em; color: var(--ink-dim); }
+ .cn-snippet-head .cn-btn { font-size: 0.76rem; padding: 4px 10px; text-transform: none; letter-spacing: 0; }
+ .cn-snippet pre {
+ margin: 0; padding: 13px 14px; font-size: 0.84rem; line-height: 1.55; overflow-x: auto;
+ color: var(--ink-bright, var(--ink)); background: var(--bg-1, rgba(0,0,0,0.3));
+ border: 1px solid var(--stroke); border-radius: var(--radius-md, 10px);
+ }
+
+ /* ── worth knowing ──────────────────────────────────────────────── */
+ .cn-facts { display: grid; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); gap: 10px; }
+ .cn-fact { padding: 15px 16px; border: 1px solid var(--stroke); border-radius: var(--radius-md, 10px); background: var(--surface-1, rgba(255,255,255,0.03)); }
+ .cn-fact h3 { margin: 0 0 6px; font-size: 0.92rem; color: var(--ink-bright, var(--ink)); }
+ .cn-fact p { margin: 0; font-size: 0.84rem; line-height: 1.55; color: var(--ink-dim); }
+ .cn-fact a { text-decoration: underline; text-underline-offset: 3px; }
+ .cn-fact a:hover { color: var(--ink); }
+
+ .cn-next { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 30px; }
+
+ @media (max-width: 640px) {
+ .cn-hero { padding-top: 26px; }
+ .cn-url { flex-wrap: wrap; }
+ .cn-url-label { display: none; }
+ .cn-url code { flex-basis: 100%; }
+ .cn-url .cn-btn { flex: 1; border-width: 1px 0 0 0; }
+ .cn-panel { padding: 16px 14px 18px; }
+ }
+ @media (prefers-reduced-motion: reduce) {
+ .cn-skel, .cn-panel { animation: none; }
+ .cn-server, .cn-btn, .cn-tab { transition: none; }
+ }
+ </style>
+ <script type="application/ld+json">{"@context":"https://schema.org","@type":"HowTo","name":"Connect three.ws to an AI client","description":"Add the three.ws MCP server to Claude, ChatGPT, Cursor, VS Code or Claude Code with one connector URL and a single sign-in.","url":"https://three.ws/connect","step":[{"@type":"HowToStep","name":"Pick a server","text":"Choose which hosted three.ws MCP server to connect. The default three.ws server carries the core tools."},{"@type":"HowToStep","name":"Add it to your client","text":"Use the one-click link for Claude, Cursor or VS Code, or paste the connector URL into ChatGPT or any MCP client."},{"@type":"HowToStep","name":"Sign in","text":"Your client opens three.ws sign-in. Approve the permissions and the tools appear. No API key to copy."}]}</script>
+</head>
+<body>
+ <header class="site-header"><div id="nav-container"></div></header>
+ <script src="/nav.js"></script>
+
+ <main class="cn-wrap" id="main">
+ <section class="cn-hero">
+ <p class="cn-eyebrow">Connector</p>
+ <h1>One URL. Your AI gets three.ws.</h1>
+ <p>
+ Add three.ws to Claude, ChatGPT, Cursor, VS Code or Claude Code and your assistant can generate 3D models and avatars,
+ run your agents, read their wallets and pay for services over x402. Sign in once in your browser: there is no API key
+ to copy. Every tool is listed in the <a href="/mcp-tools">MCP tool catalog</a>.
+ </p>
+ </section>
+
+ <section class="cn-step" aria-labelledby="cn-step1">
+ <div class="cn-step-head">
+ <span class="cn-step-num" aria-hidden="true">1</span>
+ <div>
+ <h2 id="cn-step1">Pick a server</h2>
+ <p>Start with <strong>three.ws</strong>. Add others later; each is its own connector.</p>
+ </div>
+ </div>
+ <div class="cn-servers" id="cn-servers" role="radiogroup" aria-label="Hosted MCP servers" aria-busy="true">
+ <div class="cn-skel" aria-hidden="true"></div>
+ <div class="cn-skel" aria-hidden="true"></div>
+ <div class="cn-skel" aria-hidden="true"></div>
+ </div>
+ <p class="cn-note" id="cn-servers-note" role="status" aria-live="polite"></p>
+
+ <div class="cn-url">
+ <span class="cn-url-label">URL</span>
+ <code id="cn-url">https://three.ws/api/mcp</code>
+ <button type="button" class="cn-btn" id="cn-copy-url" data-copy-target="cn-url">
+ <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="9" y="9" width="12" height="12" rx="2"/><path d="M5 15V5a2 2 0 0 1 2-2h10"/></svg>
+ <span>Copy URL</span>
+ </button>
+ </div>
+ </section>
+
+ <section class="cn-step" aria-labelledby="cn-step2">
+ <div class="cn-step-head">
+ <span class="cn-step-num" aria-hidden="true">2</span>
+ <div>
+ <h2 id="cn-step2">Add it to your client</h2>
+ <p>Links open your client with the server filled in. You still review it and confirm.</p>
+ </div>
+ </div>
+
+ <div class="cn-tabs" role="tablist" aria-label="AI clients">
+ <button type="button" class="cn-tab" role="tab" id="tab-claude" aria-controls="panel-claude" data-client="claude">Claude</button>
+ <button type="button" class="cn-tab" role="tab" id="tab-chatgpt" aria-controls="panel-chatgpt" data-client="chatgpt">ChatGPT</button>
+ <button type="button" class="cn-tab" role="tab" id="tab-claude-code" aria-controls="panel-claude-code" data-client="claude-code">Claude Code</button>
+ <button type="button" class="cn-tab" role="tab" id="tab-cursor" aria-controls="panel-cursor" data-client="cursor">Cursor</button>
+ <button type="button" class="cn-tab" role="tab" id="tab-vscode" aria-controls="panel-vscode" data-client="vscode">VS Code</button>
+ <button type="button" class="cn-tab" role="tab" id="tab-other" aria-controls="panel-other" data-client="other">Other clients</button>
+ </div>
+
+ <div class="cn-panel" role="tabpanel" id="panel-claude" aria-labelledby="tab-claude" tabindex="0">
+ <p class="cn-panel-lede">Works on claude.ai and the Claude desktop app, on every plan. Free accounts can add one custom connector. On Team and Enterprise, only owners can add one.</p>
+ <div class="cn-actions">
+ <a class="cn-btn" data-variant="primary" id="cn-claude-link" href="https://claude.ai/customize/connectors?modal=add-custom-connector&amp;connectorName=three.ws&amp;connectorUrl=https%3A%2F%2Fthree.ws%2Fapi%2Fmcp" target="_blank" rel="noopener">Open Claude with the URL filled in</a>
+ </div>
+ <ol class="cn-list">
+ <li>Click the button above, check the name and URL, then click <strong>Add</strong>. Adding it by hand instead: <strong>Customize → Connectors</strong> (Settings → Connectors on some accounts), <strong>Add custom connector</strong>, paste the URL.</li>
+ <li>Click <strong>Connect</strong> and sign in to three.ws. Read the permissions before you approve.</li>
+ <li>In a chat, open the <kbd>+</kbd> menu, then <strong>Connectors</strong>, and switch three.ws on for that conversation.</li>
+ </ol>
+ <p class="cn-src">Steps follow <a href="https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp" target="_blank" rel="noopener">Claude's own guide</a>. Its menus move: if these drift, <a href="https://github.com/nirholas/three.ws/issues" target="_blank" rel="noopener">tell us</a>.</p>
+ </div>
+
+ <div class="cn-panel" role="tabpanel" id="panel-chatgpt" aria-labelledby="tab-chatgpt" tabindex="0" hidden>
+ <p class="cn-panel-lede">ChatGPT adds custom MCP servers through <strong>Developer mode</strong>, on the plans where OpenAI offers it. There is no pre-filled link, so copy the URL first.</p>
+ <div class="cn-actions">
+ <button type="button" class="cn-btn" data-variant="primary" data-copy-target="cn-url">Copy the connector URL</button>
+ </div>
+ <ol class="cn-list">
+ <li>In <strong>Settings → Apps &amp; Connectors → Advanced settings</strong>, turn on <strong>Developer mode</strong>.</li>
+ <li>Back in <strong>Apps &amp; Connectors</strong>, click <strong>Create</strong>. Name it <code class="cn-name">three.ws</code>, paste the URL, choose <strong>OAuth</strong>, and create it.</li>
+ <li>Sign in to three.ws when ChatGPT asks, and approve the permissions.</li>
+ <li>In a new chat, open the <kbd>+</kbd> menu, choose <strong>Developer mode</strong>, and tick three.ws.</li>
+ </ol>
+ <p class="cn-src">Steps follow <a href="https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta" target="_blank" rel="noopener">OpenAI's developer mode guide</a>. Its labels change often: if these drift, <a href="https://github.com/nirholas/three.ws/issues" target="_blank" rel="noopener">tell us</a>.</p>
+ </div>
+
+ <div class="cn-panel" role="tabpanel" id="panel-claude-code" aria-labelledby="tab-claude-code" tabindex="0" hidden>
+ <p class="cn-panel-lede">One command adds the server. The first time a tool needs your account, Claude Code opens three.ws sign-in in your browser.</p>
+ <div class="cn-snippet">
+ <div class="cn-snippet-head"><span>Terminal</span><button type="button" class="cn-btn" data-copy-target="cn-cc-cmd">Copy</button></div>
+ <pre><code id="cn-cc-cmd">claude mcp add --transport http three-ws-main https://three.ws/api/mcp</code></pre>
+ </div>
+ <ol class="cn-list">
+ <li>Run the command. Add <code>--scope project</code> to share it with your team through <code>.mcp.json</code>.</li>
+ <li>In Claude Code, type <code>/mcp</code>, pick the server you just added and choose <strong>Authenticate</strong>.</li>
+ </ol>
+ </div>
+
+ <div class="cn-panel" role="tabpanel" id="panel-cursor" aria-labelledby="tab-cursor" tabindex="0" hidden>
+ <p class="cn-panel-lede">The button opens Cursor's install prompt with the server filled in. Cursor then runs the three.ws sign-in.</p>
+ <div class="cn-actions">
+ <a class="cn-btn" data-variant="primary" id="cn-cursor-link" href="cursor://anysphere.cursor-deeplink/mcp/install?name=three-ws-main&amp;config=eyJ1cmwiOiJodHRwczovL3RocmVlLndzL2FwaS9tY3AifQ%3D%3D">Add to Cursor</a>
+ </div>
+ <div class="cn-snippet">
+ <div class="cn-snippet-head"><span>Or add it to ~/.cursor/mcp.json</span><button type="button" class="cn-btn" data-copy-target="cn-cursor-json">Copy</button></div>
+ <pre><code id="cn-cursor-json">{
+ "mcpServers": {
+ "three-ws-main": { "url": "https://three.ws/api/mcp" }
+ }
+}</code></pre>
+ </div>
+ <p class="cn-src">Link format from <a href="https://cursor.com/docs/context/mcp/install-links" target="_blank" rel="noopener">Cursor's install-link docs</a>.</p>
+ </div>
+
+ <div class="cn-panel" role="tabpanel" id="panel-vscode" aria-labelledby="tab-vscode" tabindex="0" hidden>
+ <p class="cn-panel-lede">For GitHub Copilot agent mode in VS Code. The button opens VS Code's install prompt; the server signs you in on first use.</p>
+ <div class="cn-actions">
+ <a class="cn-btn" data-variant="primary" id="cn-vscode-link" href="vscode:mcp/install?%7B%22name%22%3A%22three-ws-main%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fthree.ws%2Fapi%2Fmcp%22%7D">Add to VS Code</a>
+ <a class="cn-btn" id="cn-vscode-insiders-link" href="vscode-insiders:mcp/install?%7B%22name%22%3A%22three-ws-main%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fthree.ws%2Fapi%2Fmcp%22%7D">VS Code Insiders</a>
+ </div>
+ <div class="cn-snippet">
+ <div class="cn-snippet-head"><span>Or add it to .vscode/mcp.json</span><button type="button" class="cn-btn" data-copy-target="cn-vscode-json">Copy</button></div>
+ <pre><code id="cn-vscode-json">{
+ "servers": {
+ "three-ws-main": { "type": "http", "url": "https://three.ws/api/mcp" }
+ }
+}</code></pre>
+ </div>
+ <p class="cn-src">Link format from <a href="https://code.visualstudio.com/api/extension-guides/ai/mcp" target="_blank" rel="noopener">VS Code's MCP developer guide</a>.</p>
+ </div>
+
+ <div class="cn-panel" role="tabpanel" id="panel-other" aria-labelledby="tab-other" tabindex="0" hidden>
+ <p class="cn-panel-lede">Any client that speaks <strong>Streamable HTTP</strong> MCP can connect. Clients with OAuth support sign you in automatically from the server's <code>WWW-Authenticate</code> header. Clients without it can send an API key from <a href="/dashboard/api">Dashboard → API</a> as <code>Authorization: Bearer</code>.</p>
+ <div class="cn-snippet">
+ <div class="cn-snippet-head"><span>mcp.json</span><button type="button" class="cn-btn" data-copy-target="cn-other-json">Copy</button></div>
+ <pre><code id="cn-other-json">{
+ "mcpServers": {
+ "three-ws-main": { "type": "http", "url": "https://three.ws/api/mcp" }
+ }
+}</code></pre>
+ </div>
+ <p class="cn-src">Every hosted server, with its auth and resources, is listed machine-readably at <a href="/.well-known/mcp.json">/.well-known/mcp.json</a>.</p>
+ </div>
+ </section>
+
+ <section class="cn-step" aria-labelledby="cn-step3">
+ <div class="cn-step-head">
+ <span class="cn-step-num" aria-hidden="true">3</span>
+ <div>
+ <h2 id="cn-step3">Worth knowing</h2>
+ </div>
+ </div>
+ <div class="cn-facts">
+ <div class="cn-fact">
+ <h3>You never copy a key</h3>
+ <p>Signing in gives your client its own token for your three.ws account, with the permissions you approved on the consent screen. Tools act on the agents and wallets of the account you sign in with.</p>
+ </div>
+ <div class="cn-fact">
+ <h3>Revoke it any time</h3>
+ <p>Every client you connect appears under <a href="/dashboard/settings">Dashboard → Settings → Connected apps</a>. Revoking one signs that client out immediately; your agents and balances are untouched.</p>
+ </div>
+ <div class="cn-fact">
+ <h3>Every tool is labelled</h3>
+ <p>Each tool declares whether it only reads, writes, or does something irreversible, so your client knows what to ask you about. The <a href="/mcp-tools">tool catalog</a> has a ready-made trust policy to paste in.</p>
+ </div>
+ <div class="cn-fact">
+ <h3>Try it without an account</h3>
+ <p>The <strong>3D Studio (free)</strong> server needs no sign-in: text to 3D, image to 3D and rigged avatars. Pick it above and connect in seconds.</p>
+ </div>
+ </div>
+ </section>
+
+ <nav class="cn-next" aria-label="Related">
+ <a class="cn-btn" href="/mcp-tools">Browse every tool</a>
+ <a class="cn-btn" href="/docs/mcp">MCP docs</a>
+ <a class="cn-btn" href="/docs/cli">Command-line setup</a>
+ </nav>
+ </main>
+
+ <script src="/brand.js" defer></script>
+ <script type="module">
+ const PROD_ORIGIN = 'https://three.ws';
+ const DEFAULT_ENDPOINT = `${PROD_ORIGIN}/api/mcp`;
+ const CLIENTS = ['claude', 'chatgpt', 'claude-code', 'cursor', 'vscode', 'other'];
+
+ const serversEl = document.getElementById('cn-servers');
+ const noteEl = document.getElementById('cn-servers-note');
+ const urlEl = document.getElementById('cn-url');
+
+ const state = { servers: [], selected: null };
+
+ // The config key each client stores the server under. Same rule as the
+ // three-ws CLI (packages/three-ws-cli/src/servers.js slugForPath), so a
+ // server added here and by `npx three-ws setup` never lands twice:
+ // /mcp -> three-ws, /api/mcp -> three-ws-main, /api/mcp-3d -> three-ws-3d.
+ function slugFor(server) {
+ const pathname = new URL(server.endpoint).pathname;
+ if (pathname === '/mcp') return 'three-ws';
+ if (pathname === '/api/mcp') return 'three-ws-main';
+ const rest = pathname.replace(/^\/(api\/)?/, '').split('-').filter((part) => part && part !== 'mcp').join('-');
+ return rest ? `three-ws-${rest}` : 'three-ws';
+ }
+ function displayName(server) {
+ return server.endpoint === DEFAULT_ENDPOINT ? 'three.ws' : `three.ws ${server.name}`;
+ }
+
+ function authPill(server) {
+ const auth = String(server.auth || '').toLowerCase();
+ if (auth === 'none' || auth.startsWith('none ')) return { text: 'No sign-in', tone: 'free' };
+ if (auth.startsWith('x402')) return { text: 'Pay per call', tone: 'x402' };
+ return { text: 'Sign in', tone: 'oauth' };
+ }
+
+ function renderServers() {
+ serversEl.replaceChildren();
+ for (const server of state.servers) {
+ const btn = document.createElement('button');
+ btn.type = 'button';
+ btn.className = 'cn-server';
+ btn.setAttribute('role', 'radio');
+ btn.dataset.endpoint = server.endpoint;
+ const checked = server === state.selected;
+ btn.setAttribute('aria-checked', String(checked));
+ btn.tabIndex = checked ? 0 : -1;
+
+ const top = document.createElement('span');
+ top.className = 'cn-server-top';
+ const name = document.createElement('span');
+ name.className = 'cn-server-name';
+ name.textContent = server.name;
+ top.append(name);
+
+ const desc = document.createElement('span');
+ desc.className = 'cn-server-desc';
+ desc.textContent = server.description;
+
+ const meta = document.createElement('span');
+ meta.className = 'cn-server-meta';
+ const pill = authPill(server);
+ const authEl = document.createElement('span');
+ authEl.className = 'cn-pill';
+ authEl.dataset.tone = pill.tone;
+ authEl.textContent = pill.text;
+ meta.append(authEl);
+ if (Number.isFinite(server.tools)) {
+ const tools = document.createElement('span');
+ tools.className = 'cn-pill';
+ tools.textContent = `${server.tools} tool${server.tools === 1 ? '' : 's'}`;
+ meta.append(tools);
+ }
+
+ btn.append(top, desc, meta);
+ btn.addEventListener('click', () => select(server, true));
+ serversEl.append(btn);
+ }
+ serversEl.setAttribute('aria-busy', 'false');
+ }
+
+ // Arrow keys move between servers, as a radiogroup should.
+ serversEl.addEventListener('keydown', (e) => {
+ if (!['ArrowRight', 'ArrowDown', 'ArrowLeft', 'ArrowUp', 'Home', 'End'].includes(e.key)) return;
+ const i = state.servers.indexOf(state.selected);
+ if (i < 0) return;
+ e.preventDefault();
+ const n = state.servers.length;
+ const next = e.key === 'Home' ? 0 : e.key === 'End' ? n - 1
+ : (e.key === 'ArrowRight' || e.key === 'ArrowDown') ? (i + 1) % n : (i - 1 + n) % n;
+ select(state.servers[next], true);
+ serversEl.querySelectorAll('.cn-server')[next]?.focus();
+ });
+
+ function b64(str) {
+ return btoa(String.fromCharCode(...new TextEncoder().encode(str)));
+ }
+
+ function applyServer(server) {
+ const url = server.endpoint;
+ const slug = slugFor(server);
+ const name = displayName(server);
+ urlEl.textContent = url;
+
+ const claude = new URL('https://claude.ai/customize/connectors');
+ claude.searchParams.set('modal', 'add-custom-connector');
+ claude.searchParams.set('connectorName', name);
+ claude.searchParams.set('connectorUrl', url);
+ document.getElementById('cn-claude-link').href = claude.toString();
+
+ document.getElementById('cn-cursor-link').href =
+ `cursor://anysphere.cursor-deeplink/mcp/install?name=${encodeURIComponent(slug)}&config=${encodeURIComponent(b64(JSON.stringify({ url })))}`;
+
+ const vsConfig = encodeURIComponent(JSON.stringify({ name: slug, type: 'http', url }));
+ document.getElementById('cn-vscode-link').href = `vscode:mcp/install?${vsConfig}`;
+ document.getElementById('cn-vscode-insiders-link').href = `vscode-insiders:mcp/install?${vsConfig}`;
+
+ document.getElementById('cn-cc-cmd').textContent = `claude mcp add --transport http ${slug} ${url}`;
+ document.getElementById('cn-cursor-json').textContent = JSON.stringify({ mcpServers: { [slug]: { url } } }, null, 2);
+ document.getElementById('cn-vscode-json').textContent = JSON.stringify({ servers: { [slug]: { type: 'http', url } } }, null, 2);
+ document.getElementById('cn-other-json').textContent = JSON.stringify({ mcpServers: { [slug]: { type: 'http', url } } }, null, 2);
+ for (const el of document.querySelectorAll('.cn-name')) el.textContent = name;
+ }
+
+ function select(server, updateUrl) {
+ state.selected = server;
+ for (const btn of serversEl.querySelectorAll('.cn-server')) {
+ const on = btn.dataset.endpoint === server.endpoint;
+ btn.setAttribute('aria-checked', String(on));
+ btn.tabIndex = on ? 0 : -1;
+ }
+ applyServer(server);
+ if (updateUrl) writeQuery();
+ }
+
+ // ── tabs ───────────────────────────────────────────────────────────
+ const tabs = [...document.querySelectorAll('.cn-tab')];
+ function showClient(client, updateUrl) {
+ for (const tab of tabs) {
+ const on = tab.dataset.client === client;
+ tab.setAttribute('aria-selected', String(on));
+ tab.tabIndex = on ? 0 : -1;
+ document.getElementById(tab.getAttribute('aria-controls')).hidden = !on;
+ }
+ if (updateUrl) writeQuery();
+ }
+ for (const tab of tabs) tab.addEventListener('click', () => showClient(tab.dataset.client, true));
+ document.querySelector('.cn-tabs').addEventListener('keydown', (e) => {
+ const i = tabs.findIndex((t) => t.getAttribute('aria-selected') === 'true');
+ let next = -1;
+ if (e.key === 'ArrowRight') next = (i + 1) % tabs.length;
+ else if (e.key === 'ArrowLeft') next = (i - 1 + tabs.length) % tabs.length;
+ else if (e.key === 'Home') next = 0;
+ else if (e.key === 'End') next = tabs.length - 1;
+ if (next < 0) return;
+ e.preventDefault();
+ showClient(tabs[next].dataset.client, true);
+ tabs[next].focus();
+ });
+
+ // ── shareable state: /connect?client=cursor&server=three-ws-3d-studio-free ──
+ function writeQuery() {
+ const q = new URLSearchParams(location.search);
+ const client = tabs.find((t) => t.getAttribute('aria-selected') === 'true')?.dataset.client;
+ if (client && client !== 'claude') q.set('client', client); else q.delete('client');
+ const slug = state.selected ? slugFor(state.selected) : 'three-ws-main';
+ if (slug !== 'three-ws-main') q.set('server', slug); else q.delete('server');
+ const qs = q.toString();
+ history.replaceState(null, '', `${location.pathname}${qs ? `?${qs}` : ''}${location.hash}`);
+ }
+ function detectClient() {
+ const asked = new URLSearchParams(location.search).get('client');
+ if (CLIENTS.includes(asked)) return asked;
+ return 'claude';
+ }
+
+ // ── copy buttons ───────────────────────────────────────────────────
+ document.addEventListener('click', async (e) => {
+ const btn = e.target.closest('[data-copy-target]');
+ if (!btn) return;
+ const text = document.getElementById(btn.dataset.copyTarget)?.textContent ?? '';
+ const label = btn.querySelector('span') || btn;
+ const original = label.textContent;
+ try {
+ await navigator.clipboard.writeText(text);
+ label.textContent = 'Copied';
+ btn.dataset.copied = 'true';
+ } catch {
+ label.textContent = 'Press Ctrl+C';
+ const range = document.createRange();
+ range.selectNodeContents(document.getElementById(btn.dataset.copyTarget));
+ const sel = getSelection();
+ sel.removeAllRanges();
+ sel.addRange(range);
+ }
+ setTimeout(() => { label.textContent = original; delete btn.dataset.copied; }, 1600);
+ });
+
+ // ── data ───────────────────────────────────────────────────────────
+ // The directory (/.well-known/mcp.json) names and describes each hosted
+ // server; the catalog (/mcp-catalog.json) is generated from tool source
+ // and supplies the live tool count. The directory is required, the count
+ // is a best-effort enhancement.
+ async function load() {
+ serversEl.setAttribute('aria-busy', 'true');
+ noteEl.textContent = '';
+ delete noteEl.dataset.tone;
+ try {
+ const [dirRes, catRes] = await Promise.allSettled([
+ fetch('/.well-known/mcp.json', { headers: { accept: 'application/json' } }),
+ fetch('/mcp-catalog.json', { headers: { accept: 'application/json' } }),
+ ]);
+ if (dirRes.status !== 'fulfilled' || !dirRes.value.ok) throw new Error('directory');
+ const dir = await dirRes.value.json();
+ const counts = new Map();
+ if (catRes.status === 'fulfilled' && catRes.value.ok) {
+ const cat = await catRes.value.json().catch(() => null);
+ for (const s of cat?.servers ?? []) {
+ if (s.transport === 'remote') counts.set(new URL(s.endpoint, PROD_ORIGIN).toString(), s.tools);
+ }
+ }
+ state.servers = (dir.servers ?? [])
+ .filter((s) => typeof s.endpoint === 'string' && s.endpoint.startsWith('https://'))
+ .map((s) => ({
+ name: s.name,
+ endpoint: s.endpoint,
+ auth: s.auth,
+ description: s.description,
+ tools: counts.get(s.endpoint),
+ }));
+ if (!state.servers.length) throw new Error('empty');
+ const asked = new URLSearchParams(location.search).get('server');
+ const initial = state.servers.find((s) => slugFor(s) === asked)
+ || state.servers.find((s) => s.endpoint === DEFAULT_ENDPOINT)
+ || state.servers[0];
+ state.selected = initial;
+ renderServers();
+ select(initial, false);
+ } catch {
+ serversEl.replaceChildren();
+ serversEl.setAttribute('aria-busy', 'false');
+ noteEl.dataset.tone = 'error';
+ noteEl.textContent = "Couldn't load the server list, so you're set up for the main three.ws server below, which works on its own. ";
+ const retry = document.createElement('button');
+ retry.type = 'button';
+ retry.textContent = 'Try loading the list again';
+ retry.addEventListener('click', load);
+ noteEl.append(retry);
+ }
+ }
+
+ showClient(detectClient(), false);
+ load();
+ </script>
+ <script type="module" src="/i18n.js"></script>
+</body>
+</html>
diff --git a/pages/mcp-tools.html b/pages/mcp-tools.html
index d1267d93b..2b3fdaac7 100644
--- a/pages/mcp-tools.html
+++ b/pages/mcp-tools.html
@@ -262,6 +262,7 @@
This page is generated from the source of every tool, so it cannot drift from what the servers actually serve.
The same data is machine-readable at <a href="/mcp-catalog.json"><code>/mcp-catalog.json</code></a>.
</p>
+ <p style="margin-top:10px"><a href="/connect">Connect three.ws to Claude, ChatGPT, Cursor or VS Code</a> in two clicks to use them.</p>
</div>
<dl class="mc-stats" id="mc-stats" aria-live="polite"></dl>
diff --git a/public/changelog-recent.json b/public/changelog-recent.json
index a55e88017..8b8d86d51 100644
--- a/public/changelog-recent.json
+++ b/public/changelog-recent.json
@@ -1,14 +1,24 @@
{
- "generated_at": "2026-09-29T19:55:19.816Z",
+ "generated_at": "2026-09-29T23:28:43.348Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
"url": "https://three.ws"
},
- "total": 3774,
+ "total": 3776,
"complete": false,
"full_feed": "/changelog.json",
"entries": [
+ {
+ "date": "2026-09-29",
+ "type": "launch",
+ "title": "Connect three.ws to Claude, ChatGPT, Cursor & VS Code",
+ "summary": "Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.",
+ "link": "/connect",
+ "tags": [
+ "launch"
+ ]
+ },
{
"date": "2026-09-29",
"type": "launch",
@@ -79,6 +89,16 @@
"launch"
]
},
+ {
+ "date": "2026-09-29",
+ "type": "launch",
+ "title": "Docs · three-ws CLI",
+ "summary": "Connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes to three.ws in one command: npx three-ws setup signs you in, writes every client's MCP config and verifies each server with a live tools/list.",
+ "link": "/docs/cli",
+ "tags": [
+ "launch"
+ ]
+ },
{
"date": "2026-09-29",
"type": "launch",
@@ -1573,28 +1593,6 @@
"improvement",
"fix"
]
- },
- {
- "date": "2026-09-09",
- "type": "update",
- "title": "Sign Mirror tells you why the camera did not start where you are actually looking",
- "summary": "On /sign-mirror, pressing \"Turn the camera on\" and being refused, or being on a device with no camera, put the explanation on the far side of the page: it appeared in the status strip over the 3D avatar, in the other column, while the box directly above the button you had just pressed carried on giving the same idle tip as before. The button snapped back to \"Turn the camera on\" with nothing visibly changed beside it, so a refused camera read as a button that simply did not work. Every camera and hand-tracker failure now lands in that box beside the button, in both the side-by-side and the stacked phone layout, and the box turns amber and solid-edged so a problem no longer looks like a coaching tip. The sentences themselves are unchanged and still say what to do next, naming the browser permission prompt, a camera busy in another app, a missing camera, or a hand tracker that could not be downloaded. Picking another letter clears the warning and returns the box to its normal hint.",
- "link": "/sign-mirror",
- "tags": [
- "fix",
- "improvement"
- ]
- },
- {
- "date": "2026-09-09",
- "type": "update",
- "title": "Signal Marketplace: publisher avatars appear, prices read like money, and a feed page no longer goes blank for signed-out readers",
- "summary": "A full audit of /signals, the directory of paid trading feeds ranked by proven edge. Four real defects came out of it. Every publisher without a profile picture showed an empty grey square: the generated fallback avatar is an image, and the card was assigning it to a CSS background, which browsers ignore, so it never painted. A publisher whose profile picture had gone missing showed the browser's broken-image icon; both now render as an image that quietly falls back to the generated avatar. Prices were printed as raw numbers, so a feed charging 12.345678 USDC advertised exactly that; amounts are now grouped and rounded the way money reads, while a genuine sub-cent price keeps its digits instead of rounding to zero. Subscriber counts skipped the same shortening every other number on the card uses and printed as 1234567. Worst of all, opening any live feed's own page while signed out crashed the render and left a blank panel where the sign-in prompt belongs, which is exactly the reader that panel exists to convert. Each card's screen-reader description now carries every number a sighted reader sees (rank, edge, hit rate, average ROI, signal counts, subscribers and price) instead of just the headline score, and the loading skeleton's shimmer now sweeps across the card rather than starting halfway off it.",
- "link": "/signals",
- "tags": [
- "fix",
- "improvement"
- ]
}
]
}
diff --git a/public/changelog.json b/public/changelog.json
index d1e24556e..1de0e5e4a 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,11 +1,21 @@
{
- "generated_at": "2026-09-29T19:55:19.795Z",
+ "generated_at": "2026-09-29T23:28:43.323Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
"url": "https://three.ws"
},
"entries": [
+ {
+ "date": "2026-09-29",
+ "type": "launch",
+ "title": "Connect three.ws to Claude, ChatGPT, Cursor & VS Code",
+ "summary": "Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.",
+ "link": "/connect",
+ "tags": [
+ "launch"
+ ]
+ },
{
"date": "2026-09-29",
"type": "launch",
@@ -76,6 +86,16 @@
"launch"
]
},
+ {
+ "date": "2026-09-29",
+ "type": "launch",
+ "title": "Docs · three-ws CLI",
+ "summary": "Connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes to three.ws in one command: npx three-ws setup signs you in, writes every client's MCP config and verifies each server with a live tools/list.",
+ "link": "/docs/cli",
+ "tags": [
+ "launch"
+ ]
+ },
{
"date": "2026-09-29",
"type": "launch",
diff --git a/public/changelog.xml b/public/changelog.xml
index 5b16d2bf4..ea1c4cd4e 100644
--- a/public/changelog.xml
+++ b/public/changelog.xml
@@ -6,6 +6,14 @@
<atom:link href="https://three.ws/changelog.xml" rel="self" type="application/rss+xml"/>
<description>What's new on three.ws: features, improvements, and releases, newest first.</description>
<language>en</language>
+ <item>
+ <title>Connect three.ws to Claude, ChatGPT, Cursor &amp; VS Code</title>
+ <link>https://three.ws/connect</link>
+ <guid isPermaLink="false">2026-09-29:Connect three.ws to Claude, ChatGPT, Cursor &amp; VS Code</guid>
+ <pubDate>Tue, 29 Sep 2026 12:00:00 GMT</pubDate>
+ <category>launch</category>
+ <description>Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.</description>
+ </item>
<item>
<title>Copy Coach: your first copy trade, the careful way</title>
<link>https://three.ws/copy-coach</link>
@@ -62,6 +70,14 @@
<category>launch</category>
<description>How copy-trading syndicates work: founding around copyable leaders, joining with your own wallet and caps, how the group curve and rival standing are computed from real copies, and the full API.</description>
</item>
+ <item>
+ <title>Docs · three-ws CLI</title>
+ <link>https://three.ws/docs/cli</link>
+ <guid isPermaLink="false">2026-09-29:Docs · three-ws CLI</guid>
+ <pubDate>Tue, 29 Sep 2026 12:00:00 GMT</pubDate>
+ <category>launch</category>
+ <description>Connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes to three.ws in one command: npx three-ws setup signs you in, writes every client's MCP config and verifies each server with a live tools/list.</description>
+ </item>
<item>
<title>Live Trade Rooms: watch pump.fun traders trade live in 3D</title>
<link>https://three.ws/trade-rooms</link>
diff --git a/public/features.json b/public/features.json
index 1266de789..a89542fa8 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-09-29T07:53:23.485Z",
+ "generated_at": "2026-09-29T23:28:43.307Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
@@ -4848,6 +4848,16 @@
"tags": [],
"showcase": false
},
+ {
+ "path": "/docs/cli",
+ "title": "Docs · three-ws CLI",
+ "description": "Connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes to three.ws in one command: npx three-ws setup signs you in, writes every client's MCP config and verifies each server with a live tools/list.",
+ "added": "2026-09-29",
+ "auth": null,
+ "indexable": true,
+ "tags": [],
+ "showcase": false
+ },
{
"path": "/docs/mcp",
"title": "Docs · MCP",
@@ -7198,6 +7208,16 @@
"tags": [],
"showcase": false
},
+ {
+ "path": "/connect",
+ "title": "Connect three.ws to Claude, ChatGPT, Cursor & VS Code",
+ "description": "Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.",
+ "added": "2026-09-29",
+ "auth": null,
+ "indexable": true,
+ "tags": [],
+ "showcase": false
+ },
{
"path": "/mcp-tools",
"title": "MCP Tool Catalog",
diff --git a/public/llms-full.txt b/public/llms-full.txt
index 6f7f587de..1064dd606 100644
--- a/public/llms-full.txt
+++ b/public/llms-full.txt
@@ -2957,6 +2957,12 @@ URL: https://three.ws/docs/knock
A priced door to a person: open one at /knock/<username>, set what a single message from a stranger costs, and have your 3D companion deliver what gets through in person. The free and x402 lanes, the refuse-before-charging rule, receipts, the SDK and CLI, and the MCP server.
+### Docs · three-ws CLI
+
+URL: https://three.ws/docs/cli
+
+Connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes to three.ws in one command: npx three-ws setup signs you in, writes every client's MCP config and verifies each server with a live tools/list.
+
### Docs · MCP
URL: https://three.ws/docs/mcp
@@ -4367,6 +4373,12 @@ URL: https://three.ws/docs/mcp-safety
What an MCP tool's safety annotations mean on three.ws and why you can trust them: read-only tools never change what you asked about, anything that spends is labelled as spending, and a build check verifies every hint against the tool's own code before it can ship.
+### Connect three.ws to Claude, ChatGPT, Cursor & VS Code
+
+URL: https://three.ws/connect
+
+Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.
+
### MCP Tool Catalog
URL: https://three.ws/mcp-tools
diff --git a/public/llms.txt b/public/llms.txt
index 1516563d2..dad7a0a87 100644
--- a/public/llms.txt
+++ b/public/llms.txt
@@ -509,6 +509,7 @@ Docs, tutorials, and reference.
- [Docs · <agent-3d>](https://three.ws/docs/web-component): Reference for the <agent-3d> custom element.
- [Docs · Companion](https://three.ws/docs/companion): The personal companion: connect your own Telegram bot, calendar, inbox, or phone, give your contacts a face and a voice, and have a 3D character deliver what matters in person. Bridges, triage rules, the SDK, the CLI, the MCP server, and the desktop app.
- [Docs · Knock](https://three.ws/docs/knock): A priced door to a person: open one at /knock/<username>, set what a single message from a stranger costs, and have your 3D companion deliver what gets through in person. The free and x402 lanes, the refuse-before-charging rule, receipts, the SDK and CLI, and the MCP server.
+- [Docs · three-ws CLI](https://three.ws/docs/cli): Connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes to three.ws in one command: npx three-ws setup signs you in, writes every client's MCP config and verifies each server with a live tools/list.
- [Docs · MCP](https://three.ws/docs/mcp): Expose your agent as an MCP server for Claude, ChatGPT, and other clients.
- [Docs · Solana Memo Media MCP](https://three.ws/docs/mcp-solana-memo-media): Decode validated image data embedded in Solana Memo transactions and return safe inline MCP images with provenance.
- [Docs · three.ws in VS Code](https://three.ws/docs/vscode): The VS Code extension that renders .glb and .gltf files in an editor tab, reports on them, generates and rigs new models on the free lane, and writes a pinned <agent-3d> embed.
@@ -744,6 +745,7 @@ Docs, tutorials, and reference.
- [Tutorial · Read the trading fleet](https://three.ws/tutorials/read-the-trading-fleet): Tell a working autonomous strategy from a lucky one: why realized profit is the only profit, how to read profit factor against win rate and drawdown, the sample size below which a rank means nothing, and how to spot a broken fleet that still shows a green light.
- [Docs · Live steps: documentation that runs](https://three.ws/docs/live-steps): Tutorial steps that perform a real request against the live three.ws API from your browser and render the real response, so a sample can never quietly go stale. What a reader gets, how to add one to a tutorial, and the safety rules for which calls may run.
- [Docs · MCP tool safety](https://three.ws/docs/mcp-safety): What an MCP tool's safety annotations mean on three.ws and why you can trust them: read-only tools never change what you asked about, anything that spends is labelled as spending, and a build check verifies every hint against the tool's own code before it can ship.
+- [Connect three.ws to Claude, ChatGPT, Cursor & VS Code](https://three.ws/connect): Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.
- [MCP Tool Catalog](https://three.ws/mcp-tools): Every MCP tool three.ws publishes, searchable in one place: what it does, which server hosts it, what it costs in USDC, and whether an AI client can run it unattended. Generated from the source of each tool, so it never drifts from what the servers serve.
- [Docs · The 10 SOL trading experiment](https://three.ws/docs/trading-experiment): The full risk policy behind the autonomous fleet: entry band, position sizing, taking initials at 2x, the moon-bag floor, trailing and hard stops, and how to read the decision journal.
- [Tutorial · Getting started (hosted)](https://three.ws/tutorials/getting-started): A five-minute, no-code tour: create an agent, pick a body, give it a personality, share the URL.
diff --git a/public/nav-data.js b/public/nav-data.js
index 5eff732bd..e4837afe5 100644
--- a/public/nav-data.js
+++ b/public/nav-data.js
@@ -817,11 +817,17 @@ export const NAV_GROUPS = [
href: '/avatar-sdk',
desc: 'npm · web component · React · GLB upload',
},
+ {
+ title: 'Connect to Claude & ChatGPT',
+ href: '/connect',
+ tier: 'advanced',
+ desc: 'One URL adds three.ws to Claude, ChatGPT, Cursor or VS Code',
+ },
{
title: 'MCP Tool Catalog',
href: '/mcp-tools',
tier: 'advanced',
- desc: 'All 270 AI tools: price, host server, and what runs unattended',
+ desc: 'Every AI tool: price, host server, and what runs unattended',
},
],
},
diff --git a/public/sitemap/index.html b/public/sitemap/index.html
index 9baacd186..fc84e0669 100644
--- a/public/sitemap/index.html
+++ b/public/sitemap/index.html
@@ -96,7 +96,7 @@
<main class="sm-wrap">
<div class="sm-hero">
<h1>Sitemap</h1>
- <p>All 962 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>
+ <p>All 964 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>
<div class="sm-formats">
<a href="/sitemap.xml"><code>sitemap.xml</code> · for search engines</a>
<a href="/llms.txt"><code>llms.txt</code> · for AI agents</a>
@@ -108,7 +108,7 @@
</div>
<div class="sm-filter">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m21 21-4.3-4.3"/></svg>
- <input id="sm-filter-input" type="search" placeholder="Filter 962 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />
+ <input id="sm-filter-input" type="search" placeholder="Filter 964 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />
<kbd id="sm-filter-kbd" aria-hidden="true">/</kbd>
</div>
<p class="sm-filter-count" role="status" aria-live="polite"><span id="sm-filter-count"></span><span id="sm-filter-hint" aria-hidden="true"></span></p>
@@ -148,6 +148,22 @@
<span class="sm-desc">Five trading quests that reset every UTC midnight: make three trades, fork a verified trade, ghost-copy a new agent, act on a copy intent, and let your agent close a winner. Scored from on-chain proof, rewarded with XP, levels and badges.</span>
</a>
</li>
+ <li>
+ <a href="/docs/cli">
+ <span class="sm-new-date">Sep 29, 2026</span>
+ <span class="sm-title">Docs · three-ws CLI</span>
+ <span class="sm-path">/docs/cli</span>
+ <span class="sm-desc">Connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes to three.ws in one command: npx three-ws setup signs you in, writes every client's MCP config and verifies each server with a live tools/list.</span>
+ </a>
+ </li>
+ <li>
+ <a href="/connect">
+ <span class="sm-new-date">Sep 29, 2026</span>
+ <span class="sm-title">Connect three.ws to Claude, ChatGPT, Cursor &amp; VS Code</span>
+ <span class="sm-path">/connect</span>
+ <span class="sm-desc">Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.</span>
+ </a>
+ </li>
<li>
<a href="/docs/syndicates">
<span class="sm-new-date">Sep 29, 2026</span>
@@ -172,22 +188,6 @@
<span class="sm-desc">How live trade rooms work: the trader's 3D avatar reacting to each real fill, the board and ticker tape, spectator presence, the receipt, Fork, ghost-copy and copy on every trade, the list view and frame budget, and the rooms, room and SSE stream APIs.</span>
</a>
</li>
- <li>
- <a href="/docs/sentiment-scout">
- <span class="sm-new-date">Sep 29, 2026</span>
- <span class="sm-title">Docs · Sentiment Scout</span>
- <span class="sm-path">/docs/sentiment-scout</span>
- <span class="sm-desc">Momentum with receipts: how the Sentiment Scout ranks pump.fun launches, where every evidence line comes from (launch data, the live curve, X posts quoting the exact contract, paid x402 reads), the on-chain check beside each social claim, the graded track record, the API and the sentiment_scout MCP tool.</span>
- </a>
- </li>
- <li>
- <a href="/docs/copy-coach">
- <span class="sm-new-date">Sep 29, 2026</span>
- <span class="sm-title">Docs · Copy Coach</span>
- <span class="sm-path">/docs/copy-coach</span>
- <span class="sm-desc">How the Copy Coach takes a first-timer from a real win and its full record, through a fake-money ghost copy, to one tiny server-capped copy they sign themselves: the starter caps, the confirmation card, the grounded coach answers, and the API.</span>
- </a>
- </li>
</ul>
</section>
<nav class="sm-toc" aria-label="Sections">
@@ -2646,7 +2646,7 @@
<section class="sm-section" id="learn">
<header>
- <h2>Learn<span class="sm-count" data-count>445</span></h2>
+ <h2>Learn<span class="sm-count" data-count>447</span></h2>
<p class="sm-section-desc">Docs, tutorials, and reference.</p>
</header>
<ul class="sm-list">
@@ -3616,6 +3616,13 @@
<span class="sm-desc">A priced door to a person: open one at /knock/&lt;username&gt;, set what a single message from a stranger costs, and have your 3D companion deliver what gets through in person. The free and x402 lanes, the refuse-before-charging rule, receipts, the SDK and CLI, and the MCP server.</span>
</a>
</li>
+ <li>
+ <a href="/docs/cli">
+ <span class="sm-title">Docs · three-ws CLI</span>
+ <span class="sm-path">/docs/cli</span>
+ <span class="sm-desc">Connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes to three.ws in one command: npx three-ws setup signs you in, writes every client's MCP config and verifies each server with a live tools/list.</span>
+ </a>
+ </li>
<li>
<a href="/docs/mcp">
<span class="sm-title">Docs · MCP</span>
@@ -5261,6 +5268,13 @@
<span class="sm-desc">What an MCP tool's safety annotations mean on three.ws and why you can trust them: read-only tools never change what you asked about, anything that spends is labelled as spending, and a build check verifies every hint against the tool's own code before it can ship.</span>
</a>
</li>
+ <li>
+ <a href="/connect">
+ <span class="sm-title">Connect three.ws to Claude, ChatGPT, Cursor &amp; VS Code</span>
+ <span class="sm-path">/connect</span>
+ <span class="sm-desc">Add three.ws to your AI client in two clicks: one connector URL gives Claude, ChatGPT, Cursor, VS Code or Claude Code the three.ws MCP tools for 3D generation, agents, wallets and x402 payments. Sign in once in your browser, with no API key to copy.</span>
+ </a>
+ </li>
<li>
<a href="/mcp-tools">
<span class="sm-title">MCP Tool Catalog</span>
diff --git a/scripts/audit-links.mjs b/scripts/audit-links.mjs
index 6ae108a2d..d3bf68e4d 100644
--- a/scripts/audit-links.mjs
+++ b/scripts/audit-links.mjs
@@ -212,7 +212,9 @@ function classifyTarget(value) {
const v = (value || '').trim();
if (STUB_VALUES.has(v.toLowerCase())) return { type: 'stub', value: v };
// javascript:void(0) is a stub; any other javascript: URL runs real code → scheme.
- if (/^(mailto:|tel:|sms:|data:|blob:|javascript:)/i.test(v)) return { type: 'scheme', value: v };
+ // cursor:, vscode: and vscode-insiders: are the editors' MCP install deep links
+ // (/connect): they open a local app, so there is nothing to resolve or probe.
+ if (/^(mailto:|tel:|sms:|data:|blob:|javascript:|cursor:|vscode:|vscode-insiders:)/i.test(v)) return { type: 'scheme', value: v };
// Dynamic FIRST — a template-literal/concatenated URL is not a concrete target,
// even when it starts with https:// (e.g. `https://solscan.io/tx/${sig}`).
if (v.includes('${') || /["'`]\s*\+/.test(v) || v.includes('+ ')) return { type: 'dynamic', value: v };
diff --git a/src/dashboard-next/pages/api.js b/src/dashboard-next/pages/api.js
index c1262cc63..f63c78890 100644
--- a/src/dashboard-next/pages/api.js
+++ b/src/dashboard-next/pages/api.js
@@ -410,6 +410,7 @@ function openConnectClaudeModal(state) {
<h2>Connect to Claude</h2>
<button type="button" class="dn-btn ghost" data-modal-close aria-label="Close">×</button>
</div>
+ <p class="dn-modal-body" style="margin-bottom:14px">No key needed for a connector: <a href="/connect">three.ws/connect</a> adds three.ws to Claude, ChatGPT, Cursor or VS Code with a browser sign-in. Use a key below for scripts, servers and clients without OAuth.</p>
${selected
? `<p class="dn-modal-body" style="margin-bottom:14px">Using key <strong>${esc(selected.name)}</strong> (<code>${esc(selected.prefix)}…</code>). Swap the prefix for your full secret — the one shown once at creation.</p>`
: `<div class="dn-warn-banner"><strong>No API key yet.</strong>These snippets use the <code>${esc(KEY_PLACEHOLDER)}</code> placeholder. Create a key first, then paste it in.</div>`}
diff --git a/vercel.json b/vercel.json
index 99079e434..7ef3ff63e 100644
--- a/vercel.json
+++ b/vercel.json
@@ -5911,6 +5911,10 @@
"src": "/mcp-tools/",
"dest": "/mcp-tools.html"
},
+ {
+ "src": "/connect/?",
+ "dest": "/connect.html"
+ },
{
"src": "/render-lab",
"dest": "/render-lab.html"
diff --git a/vite.config.js b/vite.config.js
index 15e15f364..4e4059610 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -691,6 +691,7 @@ const appConfig = {
'tour-builder': resolve(__dirname, 'pages/tour-builder.html'),
'agent-identities': resolve(__dirname, 'pages/agent-identities.html'),
'mcp-tools': resolve(__dirname, 'pages/mcp-tools.html'),
+ connect: resolve(__dirname, 'pages/connect.html'),
awesome: resolve(__dirname, 'pages/awesome.html'),
prompts: resolve(__dirname, 'pages/prompts.html'),
'render-lab': resolve(__dirname, 'pages/render-lab.html'),