Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

3.4 KB
Raw Blame
{
	"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
	"name": "io.github.nirholas/3D-AI-Agent-Avatar",
	"title": "3D AI Agent Avatar",
	"description": "3D AI Agent Avatar — render any GLB, give it a Solana wallet, a voice, and pump.fun powers.",
	"websiteUrl": "https://three.ws",
	"icons": [
		{
			"src": "https://three.ws/three-ws-mcp-icon.svg",
			"mimeType": "image/svg+xml",
			"sizes": [
				"any"
			]
		}
	],
	"repository": {
		"url": "https://github.com/nirholas/three.ws",
		"source": "github",
		"subfolder": "packages/avatar-agent-mcp"
	},
	"version": "1.2.3",
	"packages": [
		{
			"registryType": "npm",
			"identifier": "@three-ws/avatar-agent",
			"version": "1.2.3",
			"runtimeHint": "npx",
			"transport": {
				"type": "stdio"
			},
			"environmentVariables": [
				{
					"name": "SOLANA_RPC_URL",
					"description": "Solana mainnet RPC endpoint. Defaults to https://api.mainnet-beta.solana.com — bring your own (Helius / Quicknode / Triton) for production traffic.",
					"format": "string",
					"isRequired": false,
					"default": "https://api.mainnet-beta.solana.com"
				},
				{
					"name": "ETH_RPC_URL",
					"description": "Ethereum mainnet RPC for ENS resolution. Optional — falls back to ethers' default public providers.",
					"format": "string",
					"isRequired": false
				},
				{
					"name": "HELIUS_API_KEY",
					"description": "Optional Helius API key — enables exact supply + DAS data in pump_snapshot.",
					"format": "string",
					"isRequired": false,
					"isSecret": true
				},
				{
					"name": "NVIDIA_API_KEY",
					"description": "NVIDIA NIM key (nvapi-…) — leads the speak tool's TTS provider chain with the free Magpie TTS lane.",
					"format": "string",
					"isRequired": false,
					"isSecret": true
				},
				{
					"name": "OPENAI_API_KEY",
					"description": "OpenAI TTS — the speak tool's paid backstop when the free NVIDIA lane is unavailable.",
					"format": "string",
					"isRequired": false,
					"isSecret": true
				},
				{
					"name": "REPLICATE_API_TOKEN",
					"description": "Required for the generate_avatar tool (Replicate text/image-to-3D).",
					"format": "string",
					"isRequired": false,
					"isSecret": true
				},
				{
					"name": "REPLICATE_TEXT_TO_AVATAR_MODEL",
					"description": "Replicate version hash pinned for text-to-3D — recommended: latest tencent/hunyuan-3d-3.1.",
					"format": "string",
					"isRequired": false
				},
				{
					"name": "SOLANA_SECRET_KEY",
					"description": "Optional default base58 Solana secret for wallet_send / pump_buy. Per-call secret args override this. Treat like cash.",
					"format": "string",
					"isRequired": false,
					"isSecret": true
				},
				{
					"name": "THREE_MINT",
					"description": "Optional pump.fun mint address for $three so tools accept target=\"three\" as shorthand.",
					"format": "string",
					"isRequired": false
				},
				{
					"name": "MAX_SOL_PER_TX",
					"description": "Per-transaction spend cap in SOL for the execution tools (wallet_send, pump_buy, pump_launch, pump_collect_fees).",
					"format": "number",
					"isRequired": false,
					"default": "0.5"
				},
				{
					"name": "REQUIRE_CONFIRM",
					"description": "When on (default), execution tools refuse until re-issued with confirm:true. Set 0/false to disable the gate.",
					"format": "boolean",
					"isRequired": false,
					"default": "true"
				}
			]
		}
	]
}