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 who work with avatar and want it reachable from 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-09-18 · VERIFIED 2026-09-18

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

Latest releases

v1.0.0 · 2026-08-28

!three.ws · three.ws is an Android app. Install it and the platform opens full-screen, with no browser chrome around it, and every signature is routed to the wallet on your phone. · Install · 1. Open…

04 · Who maintains three.ws Avatars

three.ws Avatars is maintained by nirholas. We track 66 MCP servers from nirholas - 65 actively maintained, 7,838 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-09-18.
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-09-18, its last commit was 2026-09-18. 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