3D AI Agent Avatar
Inspect and optimize GLB models, then give an avatar a Solana wallet and a voice
- 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-agentAdd 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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory