# 3D AI Agent Avatar

> 3D AI Agent Avatar is a free MCP server for design and media. Inspect and optimize GLB models, then give an avatar a Solana wallet and a voice. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://three.ws
- **Repository:** https://github.com/nirholas/three.ws/tree/HEAD/packages/avatar-agent-mcp
- **MCP Registry name:** io.github.nirholas/3D-AI-Agent-Avatar
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/3d-ai-agent-avatar
