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.