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.

2.5 KB
Raw Blame

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