3D AI Agent Avatar MCP Server - install & status [2026]

01 · Install 3D AI Agent Avatar

before you install - you'll need

Set OPENAI_API_KEY, REPLICATE_API_TOKEN before connecting. SOLANA_RPC_URL is optional or environment-specific per the README.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

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-agent - 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 3D AI Agent Avatar can do

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

What you can build

With this server connected, an agent can create an avatar session from a preset or custom GLB URL. Returns a sessionId, and generate a Solana keypair. Optional vanity grinder (vanityPrefix: "three"). Secret is returned once.

Capability map

Tools grouped from the project's README - what 3D AI Agent Avatar lets an agent do.

Pump

5 tools - e.g. Live market snapshot: USD price (Jupiter), 24h volume + DEX (Dexscreener), pump.fun metadata, top-holder distribution. Pass target: "three" for $THREE when THRE; Jupiter swap, direct or Jito-bundled…

pump_snapshot · pump_buy · pump_launch · pump_collect_fees · pump.fun

read & search

3 tools - e.g. Builds a three.ws/viewer?... URL + paste-ready iframe for any GLB or avatar session (background, auto-rotate, camera preset or explicit orbit, AR mode, dimensio; Catalog of default GLB avatars (default…

viewer_url · list_avatars · list_animations

Wallet

3 tools - e.g. Generates a Solana keypair. Optional vanity grinder (vanityPrefix: "three"). Secret is returned once.; Reads SOL + all SPL token balances (incl. Token-2022).; Sends SOL on mainnet. Execution.

wallet_create · wallet_balance · wallet_send

Inspect

1 tool - e.g. Mesh / material / texture / animation / skin breakdown, bounding box, vertex and triangle counts. @gltf-transform/core.

inspect_glb

Validate

1 tool - e.g. Runs Khronos's official gltf-validator; returns errors, warnings, infos, hints with JSON pointers.

validate_glb

Optimize

1 tool - e.g. Dedup → prune → weld → optional Draco. Returns the rewritten bytes inline with before/after sizes and a signed savedBytes (negative when re-encoding an already-

optimize_glb

Thumbnail

1 tool - e.g. Renders any GLB to a PNG via three.ws's hosted three-light rig + auto-framing camera. Returns base64 PNG inline.

thumbnail_glb

Spawn

1 tool - e.g. Creates an avatar session from a preset or custom GLB URL. Returns a sessionId.

spawn_avatar

04 · Who maintains 3D AI Agent Avatar

3D AI Agent Avatar 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/3D-AI-Agent-Avatar (active, first published 2026-05-22 · 3 versions)
packages: npm:@three-ws/avatar-agent

06 · 3D AI Agent Avatar FAQ

Is 3D AI Agent Avatar still maintained?

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

What can 3D AI Agent Avatar do?

With this server connected, an agent can create an avatar session from a preset or custom GLB URL. Returns a sessionId, and generate a Solana keypair. Optional vanity grinder (vanityPrefix: "three"). Secret is returned once.

How do I install 3D AI Agent Avatar?

Run `npx -y @three-ws/avatar-agent`. The README documents 3 environment variables (SOLANA_RPC_URL, OPENAI_API_KEY, REPLICATE_API_TOKEN) to set first. Set OPENAI_API_KEY, REPLICATE_API_TOKEN before connecting. SOLANA_RPC_URL is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does 3D AI Agent Avatar 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 3D AI Agent Avatar

Alternatives to 3D AI Agent Avatar

Maintained AI & ML servers if 3D AI Agent Avatar isn't the fit.

Pairs well with

Servers that cover what 3D AI Agent Avatar doesn't - only shown when the pairing reason fits the companion.

More AI & ML MCP servers · three.ws Billing · three.ws Brain · three.ws Coin Clash · three.ws Concierge · three.ws Copy Trading