3D AI Agent Avatar
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 282 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @three-ws/avatar-agent.
github.com/nirholas/three.ws (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
Install 3D AI Agent Avatar
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"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
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-agentCursor
{
"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
{
"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).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
SOLANA_RPC_URL | No | Solana mainnet RPC endpoint. Defaults to https://api.mainnet-beta.solana.com — bring your own (Helius / Quicknode / Triton) for production traffic. |
ETH_RPC_URL | No | Ethereum mainnet RPC for ENS resolution. Optional — falls back to ethers' default public providers. |
HELIUS_API_KEYsecret | No | Optional Helius API key — enables exact supply + DAS data in pump_snapshot. |
NVIDIA_API_KEYsecret | No | NVIDIA NIM key (nvapi-…) — leads the speak tool's TTS provider chain with the free Magpie TTS lane. |
OPENAI_API_KEYsecret | No | OpenAI TTS — the speak tool's paid backstop when the free NVIDIA lane is unavailable. |
REPLICATE_API_TOKENsecret | No | Required for the generate_avatar tool (Replicate text/image-to-3D). |
REPLICATE_TEXT_TO_AVATAR_MODEL | No | Replicate version hash pinned for text-to-3D — recommended: latest tencent/hunyuan-3d-3.1. |
SOLANA_SECRET_KEYsecret | No | Optional default base58 Solana secret for walletsend / pumpbuy. Per-call secret args override this. Treat like cash. |
THREE_MINT | No | Optional pump.fun mint address for $three so tools accept target="three" as shorthand. |
MAX_SOL_PER_TX | No | Per-transaction spend cap in SOL for the execution tools (walletsend, pumpbuy, pumplaunch, pumpcollect_fees). |
REQUIRE_CONFIRM | No | When on (default), execution tools refuse until re-issued with confirm:true. Set 0/false to disable the gate. |
Tools (25)
Parsed from the Tools section of the README; check the repository for the current list.
inspect_glbMesh / material / texture / animation / skin breakdown, bounding box, vertex and triangle counts. @gltf-transform/core.
validate_glbRuns Khronos's official gltf-validator; returns errors, warnings, infos, hints with JSON pointers.
optimize_glbDedup → prune → weld → optional Draco. Returns the rewritten bytes inline with before/after sizes and a signed…
thumbnail_glbRenders any GLB to a PNG via three.ws's hosted three-light rig + auto-framing camera. Returns base64 PNG inline.
viewer_urlBuilds a three.ws/viewer?... URL + paste-ready iframe for any GLB or avatar session (background, auto-rotate, camera…
list_avatarsCatalog of default GLB avatars (default, cz), accessories, and pose presets.
list_animationsLive fetch of three.ws's pose presets (T-pose, wave, thinker, jump, dance, warrior2, …) grouped by category.
spawn_avatarCreates an avatar session from a preset or custom GLB URL. Returns a sessionId.
dress_avatarApplies accessories + a pose to a session.
render_avatarRenders a posed avatar to a PNG — pose preset + camera orbit (theta/phi/radius) + ARKit-52 facial expression.
generate_avatarText/image-to-3D via Replicate (Hunyuan-3D). New session preloaded with the generated GLB.
speakSynthesizes speech in the avatar's voice — free NVIDIA Magpie TTS lane first (NVIDIAAPIKEY), OpenAI TTS backstop…
wallet_createGenerates a Solana keypair. Optional vanity grinder (vanityPrefix: "three"). Secret is returned once.
wallet_balanceReads SOL + all SPL token balances (incl. Token-2022).
wallet_send_previewPreviews a walletsend: sender, recipient, amount, network fee, balance before and after, and any rule that would…
wallet_sendSends SOL on mainnet. Execution.
pump.funpump_snapshotLive market snapshot: USD price (Jupiter), 24h volume + DEX (Dexscreener), pump.fun metadata, top-holder distribution.
pump_buy_quoteQuotes a pumpbuy for the exact amount and slippage: SOL spent, expected and minimum tokens, price impact, route and…
pump_buyJupiter swap, direct or Jito-bundled (funder→buyer transfer + swap atomic). Accepts any runtime mint. Execution.
pump_launch_previewPreviews a pumplaunch: funder and creator addresses, rent, dev buy, bundle tip, the funder's total and any rule that…
pump_launchAtomic launch via Jito bundle: separate funder + creator wallets, both txs in the same block.
pump_collect_previewPreviews pumpcollectfees: the live fee vault balance, rent kept behind, the exact SOL that would reach the…
pump_collect_feesAtomic collect: collectCoinCreatorFee + drain to a safe wallet in one tx inside a Jito bundle — resistant to a leaked…
ens_sns_resolveResolves .eth (ENS) and .sol (SNS) names to addresses, with reverse + favorite-domain lookups.
About 3D AI Agent Avatar
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.
- avatar
- ai-agents
- mcp-server
- solana
- text-to-3d
- threejs
- x402
- claude-code-plugin
Similar MCP servers
More finance MCP servers
Actual Budget MCP Server
s-stefanov/actual-mcp
MCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants.
Active · last commit Oct 26, 2026
FinanceTypeScriptBanco Do Brasil
codespar/mcp-dev-latam
MCP server for Banco do Brasil — Pix, Cobrança (boleto), Conta-Corrente, Arrecadação (OAuth2 + mTLS).
Maintained · last commit Sep 27, 2026
FinanceTypeScriptBankMCP™
noskillish/bankmcp
Read-only MCP server for your own bank accounts via Enable Banking.
Too new to judge · created Sep 7, 2026
FinanceTypeScriptUniswap Universal Router Decoder
Elnaril/uniswap-universal-router-decoder
Decode and encode Uniswap Universal Router calldata (V2, V3, V4).
Active · last commit Nov 9, 2026
FinancePythonQanat
fidetolabs/qanat
A data platform for investment research. Ingests financial data sources and computes point-in-time financial metrics for valuation and screening.
Too new to judge · created Sep 5, 2026
FinancePythonAkshare One MCP
zwldarren/akshare-one-mcp
MCP server that provides access to Chinese stock market data using akshare-one.
Active · last commit Oct 23, 2026
FinancePython
How do I install the 3D AI Agent Avatar MCP server?
Add the command npx -y @three-ws/avatar-agent to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is 3D AI Agent Avatar free?
The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (HELIUS_API_KEY, NVIDIA_API_KEY, OPENAI_API_KEY, REPLICATE_API_TOKEN and SOLANA_SECRET_KEY) for the service it connects to, which may require a paid account.
Is 3D AI Agent Avatar actively maintained?
The most recent commit was on Nov 15, 2026. The latest release is v2026.11.09, published Nov 9, 2026. appsgit only lists MCP servers with a commit in the last six months.