Worldlabs
FreeNot checkedFastMCP 3.2 server and webapp wrapping the World Labs Marble API — generate navigable 3D worlds from text, images, and video
About
FastMCP 3.2 server and webapp wrapping the World Labs Marble API — generate navigable 3D worlds from text, images, and video
README
FastMCP Version Ruff Linted with Biome Built with Just Marble Adventure
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,
.RADstreaming, 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.
Installing Worldlabs
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/sandraschi/worldlabs-mcpFAQ
Is Worldlabs MCP free?
Yes, Worldlabs MCP is free — one-click install via Unyly at no cost.
Does Worldlabs need an API key?
No, Worldlabs runs without API keys or environment variables.
Is Worldlabs hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Worldlabs in Claude Desktop, Claude Code or Cursor?
Open Worldlabs on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
ARA
Generate images, video and audio from any AI agent — one connector.
by ARAOmni Video
An MCP server that transforms LLM-enabled IDEs into professional video editors by pre-processing footage into text proxies, generating motion graphics via HTML/
by buildwithtazaYouTube
Transcripts, channel stats, search
by YouTubeEverArt
AI image generation using various models.
by modelcontextprotocolgpu-bridge/mcp-server
GPU inference API for LLMs, image and video generation, TTS, Whisper, embeddings, reranking and OCR, paid per use via x402 or an API key.
by gpu-bridgemerterbak/Grok-MCP
Access xAI's Grok API with agentic tool calling, image generation, vision and file support.
by merterbakSureScaleAI/openai-gpt-image-mcp
Image generation and editing with OpenAI's GPT image models.
by SureScaleAIYangLiangwei/PersonalizationMCP
Aggregate personal data from Steam, YouTube, Bilibili, Spotify, Reddit and other gaming, music, video and social platforms, with OAuth2 and token management.
by YangLiangweiAceDataCloud/MCPFlux
Flux image generation and editing from Black Forest Labs via the Ace Data Cloud API.
by AceDataCloudAceDataCloud/MCPNanoBanana
Nano Banana image generation and editing, including virtual try-on and product placement in realistic scenes.
by AceDataCloudCompare Worldlabs with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All media MCPs
