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.
three.ws with Google ADK
A Google Agent Development Kit agent that
calls the free three.ws MCP server through MCPToolset. Zero three.ws
credentials: the server is https://three.ws/api/mcp-studio, the free studio
surface (no account, no key).
Run it
cd examples/google-adk
npm install
# 1. Prove the MCP wiring end to end: list the tool catalog, then run a real
# tool call (rig a known public GLB) against the live server. No model key.
npm run check
# 2. The full thing: an LlmAgent conversation that picks the tool itself.
# Needs a Gemini credential (see below).
GOOGLE_API_KEY=... node index.mjs "rig this GLB: https://three.ws/avatars/cesium-man.glb"
| Variable | Default | Purpose |
|---|---|---|
GOOGLE_API_KEY |
none | A Gemini API key from aistudio.google.com/apikey. Required for a full conversation. |
GOOGLE_GENAI_USE_VERTEXAI |
unset | Set to true to use Vertex AI instead, with GOOGLE_CLOUD_PROJECT/GOOGLE_CLOUD_LOCATION and gcloud auth application-default login. |
THREE_WS_MCP_URL |
https://three.ws/api/mcp-studio |
Point at a local server while developing. |
How it works
import { LlmAgent, MCPToolset } from '@google/adk';
const toolset = new MCPToolset({
type: 'StreamableHTTPConnectionParams',
url: 'https://three.ws/api/mcp-studio',
});
const agent = new LlmAgent({
model: 'gemini-flash-latest',
name: 'three_ws_agent',
instruction: 'You help the user generate and rig 3D models with the three.ws studio tools.',
tools: [toolset],
});
MCPToolset.getTools() discovers the full free studio catalog (forge_free,
forge_avatar, rig_mesh, look_at_model, search_catalog, and more) and
wraps each as an ADK MCPTool. The model picks the right tool from the
instruction and the user's prompt; ADK handles the tools/call round trip
over MCPSessionManager.
Beyond the free lane
The full three.ws MCP server (/api/mcp) also exposes paid, x402-gated tools
(text_to_animation and others). Point connection_params.url at it and add
an x402 client to transportOptions.requestInit to pay for those calls; the
free studio server above never needs one.
See also
- docs/google-adk.md: the three.ws-side integration doc.
- docs/mcp.md: the full MCP server reference.
- examples/grok-remote-mcp: the same free server, driven by Grok over xAI's Responses API instead of ADK.