3D AI Agent Avatar — Claude Code MCP server setup
Validates and compresses GLB assets while enabling 3D agent avatars with Solana wallets and OpenAI speech.
claude mcp add 3d-ai-agent-avatar -e HELIUS_API_KEY=<HELIUS_API_KEY> -e NVIDIA_API_KEY=<NVIDIA_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e REPLICATE_API_TOKEN=<REPLICATE_API_TOKEN> -e SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -- npx -y @three-ws/avatar-agentWhat 3D AI Agent Avatar does
This MCP server combines a 3D asset processing pipeline with runtime logic for digital avatars. On the graphics side, it inspects geometry, executes official Khronos validation via gltf-validator, and shrinks GLB models using @gltf-transform/core. It prunes unused attributes, applies Draco compression, and renders snapshot images.
Beyond raw 3D processing, the server configures conversational characters. Avatars speak through OpenAI TTS, hold Solana keypairs, and trigger trades on pump.fun. Basic geometry inspection runs without external credentials. Blockchain transactions move real tokens and require dedicated RPC endpoints with funded keys.
What it helps with
- validate GLB files against the Khronos specification
- compress 3D meshes using Draco and deduplication
- render PNG thumbnails from GLB scenes
- connect a Solana wallet to an animated 3D avatar
Example prompts for the agent
- Validate
character.glbagainst the Khronos spec and output the triangle count. - Run Draco compression on
mesh.glband display the saved byte size. - Generate a Solana wallet for the avatar and trigger an OpenAI TTS voice clip.
How to install 3D AI Agent Avatar
Platform CLI
claude mcp add 3d-ai-agent-avatar -e HELIUS_API_KEY=<HELIUS_API_KEY> -e NVIDIA_API_KEY=<NVIDIA_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e REPLICATE_API_TOKEN=<REPLICATE_API_TOKEN> -e SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -- npx -y @three-ws/avatar-agentReplace <…> with your own values. 6 more environment variables are in the server README
Platform CLI
codex mcp add avatar-agent-mcp --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env ETH_RPC_URL=<ETH_RPC_URL> --env HELIUS_API_KEY=<HELIUS_API_KEY> --env NVIDIA_API_KEY=<NVIDIA_API_KEY> --env OPENAI_API_KEY=<OPENAI_API_KEY> -- npx -y @three-ws/avatar-agentReplace <…> with your own values. 6 more environment variables are in the server README
Config file
{
"mcpServers": {
"avatar-agent-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/avatar-agent"
],
"env": {
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"ETH_RPC_URL": "<ETH_RPC_URL>",
"HELIUS_API_KEY": "<HELIUS_API_KEY>",
"NVIDIA_API_KEY": "<NVIDIA_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Replace <…> with your own values. 6 more environment variables are in the server README
Config file
{
"servers": {
"avatar-agent-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/avatar-agent"
],
"env": {
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"ETH_RPC_URL": "<ETH_RPC_URL>",
"HELIUS_API_KEY": "<HELIUS_API_KEY>",
"NVIDIA_API_KEY": "<NVIDIA_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Replace <…> with your own values. 6 more environment variables are in the server README
Platform CLI
gemini mcp add -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -e ETH_RPC_URL=<ETH_RPC_URL> -e HELIUS_API_KEY=<HELIUS_API_KEY> -e NVIDIA_API_KEY=<NVIDIA_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> avatar-agent-mcp npx -y @three-ws/avatar-agentReplace <…> with your own values. 6 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about 3D AI Agent Avatar
How do I install 3D AI Agent Avatar in Claude Code?
Run `claude mcp add 3d-ai-agent-avatar -e HELIUS_API_KEY=<HELIUS_API_KEY> -e NVIDIA_API_KEY=<NVIDIA_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e REPLICATE_API_TOKEN=<REPLICATE_API_TOKEN> -e SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -- npx -y @three-ws/avatar-agent` in your terminal. Replace the placeholder values with your real API credentials.
What does 3D AI Agent Avatar do?
It handles 3D model validation and Draco optimization while letting agents speak through OpenAI TTS and interact with Solana smart contracts.
Do I need API keys to inspect GLB files?
No keys are needed for inspection, validation, optimization, or thumbnail rendering. External credentials are only required for speech synthesis and blockchain actions.
