worldlabs-mcp
[](https://github.com/sandraschi/fastmcp) [](https://github.com/astral-sh/ruff) [](https://biomejs.dev/) [](https://github.com/casey/just) [](docs/COMPETITION.md)
# worldlabs-mcp (v0.5.0)
**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.
## Table of Contents
- 🚀 **[Setup & Quick Start](docs/SETUP.md)** — install, API key, launch
- 💎 **[Features & Tools](docs/FEATURES.md)** — 21 MCP tools, generation modes, spatial voice agent, export pipelines, Marble Community Gallery (browse/search public worlds + prompt mining)
- 🏆 **[Marble Adventure](docs/COMPETITION.md)** — Godot 4.4 agent-built gallery; 5+3 Marble portals with hub life (plants, lamps, beacon); launch from the webapp Apps page; [itch draft](https://sandraschi.itch.io/marble-adventure) · [MCD](https://github.com/sandraschi/mcp-central-docs/blob/main/docs/games/MARBLE_ADVENTURE.md)
- 🏗️ **[Architecture](docs/ARCHITECTURE.md)** — system design, ports, data flow
- 🎯 **[Prompt Engineering Guide](docs/PROMPT_GUIDE.md)** — artist styles, landmarks, materials, categories
- 🥽 **[VR & WebXR](docs/WEBXR.md)** — Quest, Pico 4, Vive streaming
- 🎙️ **[Spatial Voice & TTS](docs/TTS.md)** — edge-tts narration, audio spatialization
- ⚡ **[Spark 2.0 Renderer](docs/SPARK_V2.md)** — LoD splat tree, `.RAD` streaming, virtual paging
- 🎮 **[DCC Export](docs/EXPORT_GUIDE.md)** — Blender, Unity3D, Resonite pipelines
- 🌐 **[World Modeling](docs/WORLD_MODELING.md)** — spatial intelligence landscape
## Quickest Start
```powershell
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](https://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](https://github.com/sandraschi). Not affiliated with World Labs.
TDQS
Scored across 21 tools
Most tools are clearly separated by resource/action (generate vs list vs delete; text vs image vs video). The only overlaps are the card/JSON pairs (show_worlds_card/list_worlds, show_world_card/get_world) and get_operation/wait_for_world, but their descriptions explicitly call out when to use each, so misselection is unlikely.
Names are predominantly lowercase snake_case with a verb_noun structure, such as generate_world_from_text, list_worlds, and delete_world. A few exceptions like gallery_explore (noun_verb) and worldlabs_help (noun-only) keep it from being perfectly consistent.
21 tools is on the heavy side for a world-generation server. Several generation input variants plus duplicate card/JSON equivalents and auxiliary tools (help, local LLM refine) inflate the surface, though most tools serve a distinct real use case.
The core workflow is well covered: upload, generate from multiple media types, poll operations, list/get/delete worlds, and browse the gallery. Minor gaps exist—no operation cancellation and no removal/stop for placed scene objects (TV, avatar, audio)—but these are not blocking for the primary generation lifecycle.