three.ws Assistant Widget
three.ws Assistant Widget is an MCP server that generates a paste-ready embed for a floating 3D avatar chatbot on any website. It has 226 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @three-ws/assistant-mcp. It works with Claude Desktop, Claude Code, Cursor and VS Code.
- Web & browsing
- Apache-2.0
- Actively maintained
Install three.ws Assistant Widget
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"three-ws-assistant-widget": {
"command": "npx",
"args": [
"-y",
"@three-ws/assistant-mcp"
],
"env": {
"THREE_WS_BASE": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env THREE_WS_BASE=your-value --transport stdio three-ws-assistant-widget -- npx -y @three-ws/assistant-mcpCursor
{
"mcpServers": {
"three-ws-assistant-widget": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/assistant-mcp"
],
"env": {
"THREE_WS_BASE": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"servers": {
"three-ws-assistant-widget": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/assistant-mcp"
],
"env": {
"THREE_WS_BASE": "your-value"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
THREE_WS_BASE | No | Origin used in the generated embed URLs (script src, frame URL, builder link). Override only when targeting a preview or self-hosted three.ws deployment. |
Tools (12)
Parsed from the Tools section of the README; check the repository for the current list.
build_assistant_widgetread-only
list_assistant_optionsread-only
avataravatar id, /avatars/.glb path, or GLB URL
agenta three.ws agent id (alternative to avatar)
backgroundtransparent \
modechat \
greetingstring (≤ 200)
contextstring (≤ 500), what the assistant should know about the site
accent#hex
positionright \
voiceboolean, start with voice on/off
badgeboolean, show the three.ws attribution badge
About three.ws Assistant Widget
Generate a paste-ready three.ws assistant widget, a floating 3D avatar chatbot for any website, from any AI agent. A Model Context Protocol server that lets any AI assistant build a paste-ready embed for the three.ws assistant widget over stdio. Describe how you want the assistant to look and behave and buildassistantwidget returns a ready-to-paste tag, a standalone frame URL for embedding, and an equivalent ThreeAssistant.init({...}) JavaScript-API snippet, a floating 3D avatar chatbot that…
- animation
- avatar
- gltf
- llm
- mcp
- webgl
- 3d-generation
- ai-agents
- digital-human
- generative-ai
Similar MCP servers
More web & browsing MCP servers
Browser Use
browser-use/browser-use
Control a real Chrome browser to complete any task: fill forms, extract data, book flights.
OfficialWeb & browsingPythonScrapling MCP Server
D4Vinci/Scrapling
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass.
Web & browsingPythonChrome DevTools MCP
ChromeDevTools/chrome-devtools-mcp
MCP server for Chrome DevTools.
Web & browsingTypeScriptBytedance Browser
bytedance/UI-TARS-desktop
MCP server for browser use access.
Web & browsingTypeScriptBytedance Commands
bytedance/UI-TARS-desktop
An MCP server to run arbitrary commands.
Web & browsingTypeScriptBytedance Search
bytedance/UI-TARS-desktop
MCP server for web search operations.
Web & browsingTypeScript
What is three.ws Assistant Widget?
three.ws Assistant Widget is an MCP server that generates a paste-ready embed for a floating 3D avatar chatbot on any website. It has 226 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @three-ws/assistant-mcp. It works with Claude Desktop, Claude Code, Cursor and VS Code. The source code is at github.com/nirholas/three.ws.
How do I install the three.ws Assistant Widget MCP server?
Add the command npx -y @three-ws/assistant-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is three.ws Assistant Widget free?
The server is open source under the Apache-2.0 license, so running it is free. It does not declare any required API key.
Is three.ws Assistant Widget actively maintained?
The most recent commit was on Oct 7, 2026. The latest release is v1.5.2, published Sep 30, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.