Skip to content
appsgit

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.

github.com/nirholas/three.ws (opens in a new tab)

Install three.ws Assistant Widget

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "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-mcp

Cursor

.cursor/mcp.json
{
  "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

.vscode/mcp.json
{
  "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.

NameRequiredDescription
THREE_WS_BASENoOrigin 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_widget

    read-only

  • list_assistant_options

    read-only

  • avatar

    avatar id, /avatars/.glb path, or GLB URL

  • agent

    a three.ws agent id (alternative to avatar)

  • background

    transparent \

  • mode

    chat \

  • greeting

    string (≤ 200)

  • context

    string (≤ 500), what the assistant should know about the site

  • accent

    #hex

  • position

    right \

  • voice

    boolean, start with voice on/off

  • badge

    boolean, 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

FAQ

three.ws Assistant Widget FAQ

Still curious? Email info@appsgit.com.

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.