worldlabs-mcp (v0.5.1)
MCP gateway to World Labs Marble + Spark 2.0. Generate navigable 3D worlds from text, images, panoramas, multi-view sets, or video; view them with a streaming Gaussian-splat renderer; and ground a voice agent in scene coordinates.
Install (Claude Desktop, Windows)
irm https://github.com/sandraschi/worldlabs-mcp/releases/latest/download/install.ps1 | iex
Claude-only one-liner: downloads the released worldlabs-mcp.mcpb bundle and
registers it in Claude Desktop. For every other client (Cursor, Antigravity,
OpenCode, Claude Code), add the stdio server manually with uvx:
{
"mcpServers": {
"worldlabs-mcp": {
"command": "uvx",
"args": ["--from", "git+https://github.com/sandraschi/worldlabs-mcp", "worldlabs-mcp"],
"env": { "WORLDLABS_API_KEY": "<your-key>" }
}
}
}
Table of Contents
- 🚀 Setup & Quick Start — install, API key, launch
- 💎 Features & Tools — 21 MCP tools, generation modes, spatial voice agent, export pipelines, Marble Community Gallery (browse/search public worlds + prompt mining)
- 🏆 Marble Adventure — Godot 4.4 agent-built gallery; 5+3 Marble portals with hub life (plants, lamps, beacon); launch from the webapp Apps page; itch draft · MCD
- 🏗️ Architecture — system design, ports, data flow
- 🎯 Prompt Engineering Guide — artist styles, landmarks, materials, categories
- 🥽 VR & WebXR — Quest, Pico 4, Vive streaming
- 🎙️ Spatial Voice & TTS — edge-tts narration, audio spatialization
- ⚡ Spark 2.0 Renderer — LoD splat tree,
.RAD streaming, virtual paging
- 🎮 DCC Export — Blender, Unity3D, Resonite pipelines
- 🌐 World Modeling — spatial intelligence landscape
Quickest Start
git clone https://github.com/sandraschi/worldlabs-mcp
cd worldlabs-mcp
just bootstrap
just serve
Opens the web dashboard at http://localhost:10864. Get your API key at platform.worldlabs.ai/api-keys.
Ports
| Port | Service |
|---|
| 10864 | Frontend (Vite webapp — dashboard, library, Marble Gallery, Reality Hub) |
| 10865 | Backend bridge (FastAPI REST /api/* + MCP HTTP + SSE narration) |
| 32400 | Plex server (optional; Cinema Worlds — PLEX_TOKEN in .env) |
Stack: FastMCP 3.4+ (Python) · FastAPI · Vite + React + Tailwind · Tauri 2.0 NSIS native build (native/).
MIT License • Maintained by sandraschi. Not affiliated with World Labs.
