Skip to content
MCP server

3D AI Agent Avatar

Inspect and optimize GLB models, then give an avatar a Solana wallet and a voice

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
Version
1.2.3
Listing updated
2 days ago

About 3D AI Agent Avatar

3D AI Agent Avatar is a free MCP server for design and media. It runs locally on your machine and is started by your AI client.

Two toolkits share one server. The 3D side works on any GLB or glTF file with no avatar: inspect it, validate it against the Khronos spec, optimize it and render a thumbnail or viewer link. The README's example shows the pipeline reports honest before and after sizes, including a negative saving when a model is already compressed.

The agent side spawns a textured avatar, dresses it, gives it a voice through OpenAI text-to-speech and a Solana wallet, and runs pump.fun operations such as Jupiter swaps and Jito-bundled launches. Four tools sign and broadcast real transactions: wallet_send, pump_buy, pump_launch and pump_collect_fees. They are flagged destructive and sit behind a REQUIRE_CONFIRM gate and spend caps, so set your client to ask before running them.

The 3D tools and pump_snapshot need no environment variables; voice, generation and signing need keys such as OpenAI and Replicate. All 24 tools are free of per-call charges.

Install

Run in a terminal

claude mcp add 3d-ai-agent-avatar --env HELIUS_API_KEY='<HELIUS_API_KEY>' --env NVIDIA_API_KEY='<NVIDIA_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env REPLICATE_API_TOKEN='<REPLICATE_API_TOKEN>' --env SOLANA_SECRET_KEY='<SOLANA_SECRET_KEY>' -- npx -y @three-ws/avatar-agent

Add to claude_desktop_config.json

{
  "mcpServers": {
    "3d-ai-agent-avatar": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "HELIUS_API_KEY": "<HELIUS_API_KEY>",
        "NVIDIA_API_KEY": "<NVIDIA_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "REPLICATE_API_TOKEN": "<REPLICATE_API_TOKEN>",
        "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "3d-ai-agent-avatar": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "HELIUS_API_KEY": "<HELIUS_API_KEY>",
        "NVIDIA_API_KEY": "<NVIDIA_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "REPLICATE_API_TOKEN": "<REPLICATE_API_TOKEN>",
        "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "3d-ai-agent-avatar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "HELIUS_API_KEY": "<HELIUS_API_KEY>",
        "NVIDIA_API_KEY": "<NVIDIA_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "REPLICATE_API_TOKEN": "<REPLICATE_API_TOKEN>",
        "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "3d-ai-agent-avatar": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "HELIUS_API_KEY": "<HELIUS_API_KEY>",
        "NVIDIA_API_KEY": "<NVIDIA_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "REPLICATE_API_TOKEN": "<REPLICATE_API_TOKEN>",
        "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "3d-ai-agent-avatar": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "HELIUS_API_KEY": "<HELIUS_API_KEY>",
        "NVIDIA_API_KEY": "<NVIDIA_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "REPLICATE_API_TOKEN": "<REPLICATE_API_TOKEN>",
        "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
      }
    }
  }
}

Configuration

  • SOLANA_RPC_URLSolana mainnet RPC endpoint. Defaults to https://api.mainnet-beta.solana.com — bring your own (Helius / Quicknode / Triton) for production traffic.
  • ETH_RPC_URLEthereum mainnet RPC for ENS resolution. Optional — falls back to ethers' default public providers.
  • HELIUS_API_KEYOptional Helius API key — enables exact supply + DAS data in pump_snapshot.
  • NVIDIA_API_KEYNVIDIA NIM key (nvapi-…) — leads the speak tool's TTS provider chain with the free Magpie TTS lane.
  • OPENAI_API_KEYOpenAI TTS — the speak tool's paid backstop when the free NVIDIA lane is unavailable.
  • REPLICATE_API_TOKENRequired for the generate_avatar tool (Replicate text/image-to-3D).
  • REPLICATE_TEXT_TO_AVATAR_MODELReplicate version hash pinned for text-to-3D — recommended: latest tencent/hunyuan-3d-3.1.
  • SOLANA_SECRET_KEYOptional default base58 Solana secret for wallet_send / pump_buy. Per-call secret args override this. Treat like cash.
  • THREE_MINTOptional pump.fun mint address for $three so tools accept target="three" as shorthand.
  • MAX_SOL_PER_TXPer-transaction spend cap in SOL for the execution tools (wallet_send, pump_buy, pump_launch, pump_collect_fees).
  • REQUIRE_CONFIRMWhen on (default), execution tools refuse until re-issued with confirm:true. Set 0/false to disable the gate.

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

inspect_glb
Inspect a GLB or glTF model.
validate_glb
Validate against the Khronos spec.
optimize_glb
Optimize a model, for example with Draco.
thumbnail_glb
Render a thumbnail.
viewer_url
Create a viewer link.
pump_snapshot
Snapshot of a pump.fun token.
spawn_avatar
Spawn an avatar.
dress_avatar
Dress an avatar.
wallet_create
Create a Solana wallet, optionally with a vanity prefix.
speak
Make the avatar speak.
wallet_send
Send funds; executes a real transaction.
pump_buy
Buy on pump.fun; executes a real transaction.
pump_launch
Launch a token; executes a real transaction.
pump_collect_fees
Collect creator fees; executes a real transaction.

What it does

GLB inspection
Count triangles, validate against the Khronos spec and optimize with Draco.
Thumbnails and viewer links
Render a preview or share a viewer URL for any model.
Avatar spawning
Spawn and dress a textured GLB avatar.
Voice
Text-to-speech through OpenAI.
Solana wallet and pump.fun
Create wallets, swap, buy, launch and collect fees.
Spend safeguards
Execution tools are flagged destructive with a confirm gate and spend caps.

Good for

  • Check a GLB for validation errors and size
  • Compress a model with Draco and compare sizes
  • Create a talking 3D avatar with its own wallet
  • Pull a pump.fun snapshot of a token
  • Launch or buy a token with confirmation on every transaction

Pricing

Free

No per-call charge; on-chain actions use real funds

Prices change. Check three.ws before you buy.

3D AI Agent Avatar FAQ

Do the tools cost money to call?

No, all 24 tools are free MCP tools with no per-call charge, though on-chain actions move real funds.

Which tools move funds?

wallet_send, pump_buy, pump_launch and pump_collect_fees.

What works without keys?

The five 3D tools and pump_snapshot.

Is there a read-only avatar viewer?

Yes, the sibling package @three-ws/avatar-mcp.

Is 3D AI Agent Avatar free?

Yes. 3D AI Agent Avatar is free to use.

How do I add 3D AI Agent Avatar to Claude Code?

Run this command in your terminal: claude mcp add 3d-ai-agent-avatar --env HELIUS_API_KEY='<HELIUS_API_KEY>' --env NVIDIA_API_KEY='<NVIDIA_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env REPLICATE_API_TOKEN='<REPLICATE_API_TOKEN>' --env SOLANA_SECRET_KEY='<SOLANA_SECRET_KEY>' -- npx -y @three-ws/avatar-agent

What are the best alternatives to 3D AI Agent Avatar?

The closest alternatives to 3D AI Agent Avatar are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to 3D AI Agent Avatar

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory