three.ws Avatars MCP Server

An MCP server that drops a live, rotatable 3D avatar into any chat - interactive in the conversation, embeddable anywhere. Free, no API key. Its 3 documented tools cluster into render, avatar, read & search.

People connecting AI & ML tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 37 MCP servers published from nirholas/three.ws. Stars and repository activity are shared across all of them. See all 37 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · VERIFIED 2026-08-25

Apache-2.0 · JavaScript servers · how we verify → /methodology

01 · Install three.ws Avatars

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add nirholas-three.ws-packages-threews-avata -- npx -y @three-ws/avatar-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "nirholas-three.ws-packages-threews-avata": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package @three-ws/avatar-mcp - the @three-ws scope differs from the repo owner (nirholas); confirm it's the project's official package

registry namespace io.github.nirholas is GitHub-verified and matches the repo owner

03 · What three.ws Avatars can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 3 documented tools across render, avatar, read & search, including render_avatar, avatar_embed_code, get_avatar.

The 3 tools it gives your agent

Extracted from the project's README - what three.ws Avatars lets an agent do.

render_avatar: - id · handle · model
avatar_embed_code: - id · handle · model
get_avatar: - id · handle

04 · Who maintains three.ws Avatars

three.ws Avatars is maintained by nirholas. We track 66 MCP servers from nirholas - 65 actively maintained, 7,658 combined GitHub stars, oldest repo from Feb 2024. Full record: all servers from nirholas.

05 · Facts

repository: github.com/nirholas/three.ws
website: https://three.ws/
category: AI & ML - actively maintained as of 2026-08-25.
registry: io.github.nirholas/threews-avatar (active, first published 2026-06-02 · 4 versions)
packages: npm:@three-ws/avatar-mcp

06 · three.ws Avatars FAQ

Is three.ws Avatars still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24. We re-verify nightly.

What can three.ws Avatars do?

An agent gets 3 documented tools across render, avatar, read & search, including render_avatar, avatar_embed_code, get_avatar.

How do I install three.ws Avatars?

Run `npx -y @three-ws/avatar-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does three.ws Avatars run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to three.ws Avatars

Alternatives to three.ws Avatars

Maintained AI & ML servers if three.ws Avatars isn't the fit.

Pairs well with

Servers that cover what three.ws Avatars doesn't - only shown when the pairing reason fits the companion.

More AI & ML MCP servers · three.ws Tutor · three.ws Vanity · three.ws Vision · x402 Wallet · As A Judge

More JavaScript MCP servers · Nitrosend · see all