MCP Server

3D AI Agent Avatar MCP Server

Name: 3D AI Agent Avatar MCP Server
Author: io.github.nirholas

io.github.nirholas/3D-AI-Agent-Avatar

Repository Registry

What is the 3D AI Agent Avatar MCP server?

3D AI Agent Avatar — render any GLB, give it a Solana wallet, a voice, and pump.fun powers.

How to install 3D AI Agent Avatar

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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 wallet_send / pump_buy. 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 (wallet_send, pump_buy, pump_launch, pump_collect_fees).
REQUIRE_CONFIRM
When on (default), execution tools refuse until re-issued with confirm:true. Set 0/false to disable the gate.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "3D-AI-Agent-Avatar": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "ETH_RPC_URL": "<YOUR_ETH_RPC_URL>",
        "HELIUS_API_KEY": "<YOUR_HELIUS_API_KEY>",
        "NVIDIA_API_KEY": "<YOUR_NVIDIA_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "REPLICATE_API_TOKEN": "<YOUR_REPLICATE_API_TOKEN>",
        "REPLICATE_TEXT_TO_AVATAR_MODEL": "<YOUR_REPLICATE_TEXT_TO_AVATAR_MODEL>",
        "SOLANA_SECRET_KEY": "<YOUR_SOLANA_SECRET_KEY>",
        "THREE_MINT": "<YOUR_THREE_MINT>",
        "MAX_SOL_PER_TX": "<YOUR_MAX_SOL_PER_TX>",
        "REQUIRE_CONFIRM": "<YOUR_REQUIRE_CONFIRM>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "3D-AI-Agent-Avatar": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "ETH_RPC_URL": "<YOUR_ETH_RPC_URL>",
        "HELIUS_API_KEY": "<YOUR_HELIUS_API_KEY>",
        "NVIDIA_API_KEY": "<YOUR_NVIDIA_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "REPLICATE_API_TOKEN": "<YOUR_REPLICATE_API_TOKEN>",
        "REPLICATE_TEXT_TO_AVATAR_MODEL": "<YOUR_REPLICATE_TEXT_TO_AVATAR_MODEL>",
        "SOLANA_SECRET_KEY": "<YOUR_SOLANA_SECRET_KEY>",
        "THREE_MINT": "<YOUR_THREE_MINT>",
        "MAX_SOL_PER_TX": "<YOUR_MAX_SOL_PER_TX>",
        "REQUIRE_CONFIRM": "<YOUR_REQUIRE_CONFIRM>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "3D-AI-Agent-Avatar": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "ETH_RPC_URL": "<YOUR_ETH_RPC_URL>",
        "HELIUS_API_KEY": "<YOUR_HELIUS_API_KEY>",
        "NVIDIA_API_KEY": "<YOUR_NVIDIA_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "REPLICATE_API_TOKEN": "<YOUR_REPLICATE_API_TOKEN>",
        "REPLICATE_TEXT_TO_AVATAR_MODEL": "<YOUR_REPLICATE_TEXT_TO_AVATAR_MODEL>",
        "SOLANA_SECRET_KEY": "<YOUR_SOLANA_SECRET_KEY>",
        "THREE_MINT": "<YOUR_THREE_MINT>",
        "MAX_SOL_PER_TX": "<YOUR_MAX_SOL_PER_TX>",
        "REQUIRE_CONFIRM": "<YOUR_REQUIRE_CONFIRM>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "3D-AI-Agent-Avatar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "ETH_RPC_URL": "<YOUR_ETH_RPC_URL>",
        "HELIUS_API_KEY": "<YOUR_HELIUS_API_KEY>",
        "NVIDIA_API_KEY": "<YOUR_NVIDIA_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "REPLICATE_API_TOKEN": "<YOUR_REPLICATE_API_TOKEN>",
        "REPLICATE_TEXT_TO_AVATAR_MODEL": "<YOUR_REPLICATE_TEXT_TO_AVATAR_MODEL>",
        "SOLANA_SECRET_KEY": "<YOUR_SOLANA_SECRET_KEY>",
        "THREE_MINT": "<YOUR_THREE_MINT>",
        "MAX_SOL_PER_TX": "<YOUR_MAX_SOL_PER_TX>",
        "REQUIRE_CONFIRM": "<YOUR_REQUIRE_CONFIRM>"
      }
    }
  }
}

Claude Code

claude mcp add 3D-AI-Agent-Avatar --env SOLANA_RPC_URL=<YOUR_SOLANA_RPC_URL> --env ETH_RPC_URL=<YOUR_ETH_RPC_URL> --env HELIUS_API_KEY=<YOUR_HELIUS_API_KEY> --env NVIDIA_API_KEY=<YOUR_NVIDIA_API_KEY> --env OPENAI_API_KEY=<YOUR_OPENAI_API_KEY> --env REPLICATE_API_TOKEN=<YOUR_REPLICATE_API_TOKEN> --env REPLICATE_TEXT_TO_AVATAR_MODEL=<YOUR_REPLICATE_TEXT_TO_AVATAR_MODEL> --env SOLANA_SECRET_KEY=<YOUR_SOLANA_SECRET_KEY> --env THREE_MINT=<YOUR_THREE_MINT> --env MAX_SOL_PER_TX=<YOUR_MAX_SOL_PER_TX> --env REQUIRE_CONFIRM=<YOUR_REQUIRE_CONFIRM> -- npx -y @three-ws/avatar-agent

Related MCP servers

three.ws 3D Agent Tools

MCP tools from three.ws: free + paid text-to-3D, rigging, agent reputation, market intel.

View repository →

UCAI

UCAI — The ABI-to-MCP Server Generator. Convert any smart contract ABI into an AI-ready MCP server.

View repository →

three.ws Activity

Trending agents and coins, the $THREE holder leaderboard, and the site-wide activity ticker.

View repository →

three.ws AgenC

Browse the AgenC on-chain task marketplace, query the agent registry, and link identities.

View repository →

Agent Sniper

Self-custodial pump.fun sniper: arm strategies, snipe, manage positions. Simulate by default.

View repository →

three.ws Agent Payments

Governed x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key.

View repository →