three-ws MCP server
Commit Nov 11, 2026Connects MCP clients to three.ws to provide AI assistants with 3D generation, agent wallets, and Solana token data.
Also known as nirholas/three-ws, three-ws-gh
- Stars
- 5
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 11, 2026
- License
- Apache-2.0
What is three-ws MCP?
three-ws connects MCP clients to three.ws to provide AI assistants with 3D generation, agent wallets, and Solana token data.
Summary generated from the project's README
About three-ws MCP server
Connecting AI assistants to 3D generation, agent wallets, and Solana token data is what this server enables. It acts as a bridge between MCP clients and the three.ws platform, allowing users to expand the capabilities of their models through specialized tools. Developers can use it to provide assistants with text-to-3D, image-to-3D, and rigged avatar generation, alongside access to agent balances and financial data.
Setup is handled via a single command using the npx @three-ws/cli tool, which works with local clients like Claude Desktop, Cursor, Windsurf, VS Code, and Gemini CLI. It also supports cloud-based connections for Grok Bot by providing specific connector fields. Authentication is managed through a browser OAuth flow or an API key, and credentials are kept secure in a local JSON file. The server includes a doctor command to troubleshoot configuration issues or expired sessions.
What you can do with it
- 1Generate 3D assetsAsk your AI assistant to create a rigged avatar or a 3D model from a text description.
- 2Manage AI agent walletsCheck the status and balances of your autonomous agents and their associated Solana wallets.
- 3Deploy to Grok BotConfigure a cloud connector for Grok Bot to use 3D studio tools without local file writing.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablenirholas/three-ws is public and reachablegithub.com/nirholas/three-ws ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/nirholas/three-ws ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubthree-ws
Connect any MCP client to 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, IBM Bob, Codex, Gemini CLI, Hermes), prints the connector fields for Grok Bot, and verifies each one with a live tools/list.
npx @three-ws/cli 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 and every tool is in the catalog.
Using one client that supports remote connectors? three.ws/connect adds three.ws to Claude, Cursor or VS Code in one click, with no terminal.
One command per client
npx @three-ws/cli --claude # also --cursor --codex --vscode --windsurf --gemini --bob --hermes
Signs in, writes the servers, verifies them, and installs the three.ws skill for Claude Code, with no prompts. The config gets a three-ws proxy launcher, never a token: credentials stay in ~/.config/three-ws/credentials.json (mode 600). Running it again changes nothing. Then: claude "launch my agent".
Hosted installers: curl -fsSL https://three.ws/cli/install | sh and curl -fsSL https://three.ws/cli/claude | sh. Every script ships with a .sha256 checksum and an ed25519 .sig; download, read and verify before running: three.ws/docs/cli#verify-before-you-run.
npx @three-ws/cli doctor # bad config, expired sign-in, unreachable server, with the fix for each
npx @three-ws/cli agent status # agents, wallets and balances
npx @three-ws/cli team # your teams; `team status <id>` for one
Clean-container check
tests/container/run.sh packs this package and, for each client, starts a fresh node:22 container, runs the hosted installer against a local stand-in platform, and asserts the config is written without a key, a second run changes nothing, doctor passes and the credential file is mode 600. Needs Docker.
bash packages/three-ws-cli/tests/container/run.sh
Common commands
npx @three-ws/cli setup --clients cursor,vscode --yes # specific clients, no prompts
npx @three-ws/cli setup --project # project-scoped config in this directory
npx @three-ws/cli login --device # sign in over SSH
npx @three-ws/cli link BCDF-GHJK # link this terminal with a code from /dashboard/account
npx @three-ws/cli mcp list --available # every server and its name
npx @three-ws/cli tools --server three-ws-main --enable financial
npx @three-ws/cli status
npx @three-ws/cli create "Nova" --description "A deep-space guide." # an agent with its own Solana wallet
npx @three-ws/cli launch --agent <id> --name Nova --symbol NOVA # prefilled, you sign on three.ws/launch
Grok Bot
Grok Bot's MCP configuration lives in xAI's cloud, so there is no file to write. setup handles the rest: it picks the Grok connector (https://three.ws/api/mcp-grok), copies the URL to your clipboard when a clipboard tool exists, prints the exact fields for Grok Bot's custom MCP connector, and runs a real tools/list against the public URL to prove it answers from outside.
npx @three-ws/cli setup --client grok-bot # free 3D studio, no account, no key
npx @three-ws/cli setup --client grok-bot --connector-key # also mint a key so Grok Bot can use your agents
npx @three-ws/cli setup --clients cursor,grok-bot --yes # local clients and Grok Bot in one run
Grok Bot (cloud connector, nothing to write locally)
Name three-ws
Transport Streamable HTTP
Server URL https://three.ws/api/mcp-grok
Authentication None
--connector-key signs you in, mints one key with the connector preset (read, generate and edit agents, never spend), stores it in the credential file, and reuses it on later runs. Paste it as a Bot secret. --no-copy skips the clipboard. A localhost origin is flagged, because Grok Bot connects from xAI's cloud. Full walkthrough: three.ws/docs/grok.
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. 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:
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.
License
Apache-2.0
Support the project
If three-ws saves you time, star it on GitHub. Stars are how other developers and AI agents find the repositories worth trusting, and they cost you one click.
Know someone who would use it? Post on X · Share on Bluesky · Share on LinkedIn · Submit to Hacker News · Share on Reddit
Built for AI agents too
Coding agents and LLM tooling can read this repo directly: AGENTS.md, llms.txt, llms-full.txt. Point an agent at https://github.com/nirholas/three-ws and it has the context it needs.
More from the same author
- All repositories by nirholas: the full catalog, grouped by topic
- three.ws: the platform for 3D AI agents with Solana wallets, a skill marketplace and x402 payments
- Questions or ideas: open an issue or start a discussion
Contributors
Star history
three-ws MCP questions
Which MCP clients can I connect to three.ws?
You can connect Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, IBM Bob, Codex, Gemini CLI, and Hermes.
How do I sign in to the service?
Sign-in is typically a browser OAuth flow, but you can also use a device code via the --device flag or an API key.
What capabilities do the three.ws MCP servers provide?
The servers enable 3D generation (text/image to 3D, rigged avatars), agent management with wallets, paid services, and Solana token data.