# three.ws Assistant Widget

Generates embed snippets for an interactive 3D avatar chatbot directly in agent chat. Produces <script> tags, iframe links, and JavaScript snippets.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 249
- Author: nirholas
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nirholas/three.ws/tree/HEAD/packages/assistant-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/threews-assistant-widget

## What it does

The server provides two tools: `build_assistant_widget` and `list_assistant_options`. When given layout, voice, and theme choices, it outputs an embed tag for `<script>` tags, a direct URL for `<iframe>` elements, and code for `ThreeAssistant.init()`. The second tool exposes built-in 3D characters, color presets, and interaction modes.

All generation logic runs locally on your machine without outbound network calls or API keys. Input validation ensures that unsupported hex codes or oversized text inputs fall back to preset defaults rather than throwing errors. You can redirect the target endpoint by setting the `THREE_WS_BASE` environment variable.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `THREE_WS_BASE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --transport stdio assistant-mcp -- npx -y @three-ws/assistant-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add assistant-mcp --env THREE_WS_BASE=<THREE_WS_BASE> -- npx -y @three-ws/assistant-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "assistant-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/assistant-mcp"
            ],
            "env": {
                "THREE_WS_BASE": "<THREE_WS_BASE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "assistant-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/assistant-mcp"
            ],
            "env": {
                "THREE_WS_BASE": "<THREE_WS_BASE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> assistant-mcp npx -y @three-ws/assistant-mcp
```
Replace <…> with your own values

## When to use it
- generate `<script>` embed markup for a 3D corner assistant
- build standalone frame URLs for `<iframe>` integrations
- inspect available character models and color presets
- create initialized `ThreeAssistant.init()` JavaScript snippets

## Example prompts
- Generate widget embed code with `/avatars/selfie-girl.glb`, ocean background, and left alignment
- List all available assistant avatars and background presets via the MCP tools
- Build an iframe assistant embed that supports speech and text modes

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51091
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16062
- [mcp-server-chart](https://affpapa.org/en/nevibecode/mcp/mcp-server-chart.md) — MCP server · ★ 4402
- [Dembrandt](https://affpapa.org/en/nevibecode/mcp/dembrandt.md) — MCP server · ★ 3821
- [RevoGrid DataGrid MCP Pro](https://affpapa.org/en/nevibecode/mcp/revogrid-datagrid-mcp-pro.md) — MCP server · ★ 3450

From the same set: [nirholas/three.ws](https://affpapa.org/en/nevibecode/by/nirholas/three.ws.md) — 43 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md