3D AI Agent Avatar

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

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

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

{
  "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 Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

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

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.

• animation
• avatar
• gltf
• llm
• mcp
• webgl
• 3d-generation
• ai-agents
• digital-human
• generative-ai