# 3D AI Agent Avatar (MCP server)

> 3D AI Agent Avatar is an MCP server that turns any GLB into a 3D AI agent — inspect/validate/optimize models, then give one a Solana wallet, a voice, and pump.fun powers. It has 226 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @three-ws/avatar-agent.

An MCP server that turns any GLB into a 3D AI agent — inspect/validate/optimize models, then give one a Solana wallet, a voice, and pump.fun powers.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/nirholas/three.ws |
| GitHub stars | 226 |
| License | Apache-2.0 |
| Language | JavaScript |
| Transport | stdio |
| Packages | npm: @three-ws/avatar-agent |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Finance |
| Latest release | v1.5.2 (Sep 30, 2026) |
| Last commit | Oct 7, 2026 |
| MCP registry name | io.github.nirholas/3D-AI-Agent-Avatar |

## Install

### Claude Desktop (claude_desktop_config.json)

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env HELIUS_API_KEY=your-value --env NVIDIA_API_KEY=your-value --env OPENAI_API_KEY=your-value --env REPLICATE_API_TOKEN=your-value --env SOLANA_SECRET_KEY=your-value --transport stdio 3d-ai-agent-avatar -- npx -y @three-ws/avatar-agent
```

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

```json
{
  "mcpServers": {
    "3d-ai-agent-avatar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "HELIUS_API_KEY": "your-value",
        "NVIDIA_API_KEY": "your-value",
        "OPENAI_API_KEY": "your-value",
        "REPLICATE_API_TOKEN": "your-value",
        "SOLANA_SECRET_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "helius_api_key",
      "description": "HELIUS_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "nvidia_api_key",
      "description": "NVIDIA_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "openai_api_key",
      "description": "OPENAI_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "replicate_api_token",
      "description": "REPLICATE_API_TOKEN",
      "password": true
    },
    {
      "type": "promptString",
      "id": "solana_secret_key",
      "description": "SOLANA_SECRET_KEY",
      "password": true
    }
  ],
  "servers": {
    "3d-ai-agent-avatar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "HELIUS_API_KEY": "${input:helius_api_key}",
        "NVIDIA_API_KEY": "${input:nvidia_api_key}",
        "OPENAI_API_KEY": "${input:openai_api_key}",
        "REPLICATE_API_TOKEN": "${input:replicate_api_token}",
        "SOLANA_SECRET_KEY": "${input:solana_secret_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `SOLANA_RPC_URL`: Solana mainnet RPC endpoint. Defaults to https://api.mainnet-beta.solana.com — bring your own (Helius / Quicknode / Triton) for production traffic.
- `ETH_RPC_URL`: Ethereum mainnet RPC for ENS resolution. Optional — falls back to ethers' default public providers.
- `HELIUS_API_KEY` (secret): Optional Helius API key — enables exact supply + DAS data in pump_snapshot.
- `NVIDIA_API_KEY` (secret): NVIDIA NIM key (nvapi-…) — leads the speak tool's TTS provider chain with the free Magpie TTS lane.
- `OPENAI_API_KEY` (secret): OpenAI TTS — the speak tool's paid backstop when the free NVIDIA lane is unavailable.
- `REPLICATE_API_TOKEN` (secret): Required for the generate_avatar tool (Replicate text/image-to-3D).
- `REPLICATE_TEXT_TO_AVATAR_MODEL`: Replicate version hash pinned for text-to-3D — recommended: latest tencent/hunyuan-3d-3.1.
- `SOLANA_SECRET_KEY` (secret): Optional default base58 Solana secret for walletsend / pumpbuy. Per-call secret args override this. Treat like cash.
- `THREE_MINT`: Optional pump.fun mint address for $three so tools accept target="three" as shorthand.
- `MAX_SOL_PER_TX`: Per-transaction spend cap in SOL for the execution tools (walletsend, pumpbuy, pumplaunch, pumpcollect_fees).
- `REQUIRE_CONFIRM`: When on (default), execution tools refuse until re-issued with confirm:true. Set 0/false to disable the gate.

## Tools

- `inspect_glb`: Mesh / material / texture / animation / skin breakdown, bounding box, vertex and triangle counts. @gltf-transform/core.
- `validate_glb`: Runs Khronos's official gltf-validator; returns errors, warnings, infos, hints with JSON pointers.
- `optimize_glb`: Dedup → prune → weld → optional Draco. Returns the rewritten bytes inline with before/after sizes and a signed…
- `thumbnail_glb`: Renders any GLB to a PNG via three.ws's hosted three-light rig + auto-framing camera. Returns base64 PNG inline.
- `viewer_url`: Builds a three.ws/viewer?... URL + paste-ready iframe for any GLB or avatar session (background, auto-rotate, camera…
- `list_avatars`: Catalog of default GLB avatars (default, cz), accessories, and pose presets.
- `list_animations`: Live fetch of three.ws's pose presets (T-pose, wave, thinker, jump, dance, warrior2, …) grouped by category.
- `spawn_avatar`: Creates an avatar session from a preset or custom GLB URL. Returns a sessionId.
- `dress_avatar`: Applies accessories + a pose to a session.
- `render_avatar`: Renders a posed avatar to a PNG — pose preset + camera orbit (theta/phi/radius) + ARKit-52 facial expression.
- `generate_avatar`: Text/image-to-3D via Replicate (Hunyuan-3D). New session preloaded with the generated GLB.
- `speak`: Synthesizes speech in the avatar's voice — free NVIDIA Magpie TTS lane first (NVIDIAAPIKEY), OpenAI TTS backstop…
- `wallet_create`: Generates a Solana keypair. Optional vanity grinder (vanityPrefix: "three"). Secret is returned once.
- `wallet_balance`: Reads SOL + all SPL token balances (incl. Token-2022).
- `wallet_send`: Sends SOL on mainnet. Execution.
- `pump.fun`
- `pump_snapshot`: Live market snapshot: USD price (Jupiter), 24h volume + DEX (Dexscreener), pump.fun metadata, top-holder distribution.
- `pump_buy`: Jupiter swap, direct or Jito-bundled (funder→buyer transfer + swap atomic). Accepts any runtime mint. Execution.
- `pump_launch`: Atomic launch via Jito bundle: separate funder + creator wallets, both txs in the same block.
- `pump_collect_fees`: Atomic collect: collectCoinCreatorFee + drain to a safe wallet in one tx inside a Jito bundle — resistant to a leaked…
- `ens_sns_resolve`: Resolves .eth (ENS) and .sol (SNS) names to addresses, with reverse + favorite-domain lookups.

## Similar MCP servers

- [CCXT](https://appsgit.com/mcp-servers/ccxt): Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets. (44,271 stars, MIT, official)
- [Finance Toolkit](https://appsgit.com/mcp-servers/finance-toolkit): 200+ transparent financial metrics calculated from raw statements, not third-party endpoints. (5,402 stars, MIT, needs API key)
- [Tradingview MCP](https://appsgit.com/mcp-servers/tradingview-mcp): Real-time market data, screeners, technical analysis & backtesting for stocks, crypto and forex. (4,948 stars, MIT)
- [EdgarTools](https://appsgit.com/mcp-servers/edgartools): Open-source SEC EDGAR toolkit — 13 tools, 7 prompts, every filing type. (2,776 stars, MIT)
- [AI](https://appsgit.com/mcp-servers/ai): MCP server integrating with Stripe - tools for customers, products, payments, and more. (1,859 stars, MIT, official)
- [Tradememory Protocol](https://appsgit.com/mcp-servers/tradememory-protocol): Tamper-evident decision audit trail and outcome-weighted memory for AI trading agents. (1,425 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/3d-ai-agent-avatar
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.