Marble WorldLabs MCP Server

An MCP (Model Context Protocol) server that provides Claude with direct access to the WorldLabs Marble API for generating 3D worlds from text, images, video, and multi-image inputs.

Features

• Text-to-World — Generate 3D worlds from text descriptions

• Image-to-World — Generate from a single image (URL, base64, or uploaded file)

• Video-to-World — Generate from video

• Multi-Image-to-World — Generate from multiple images with azimuth positioning

• Media Asset Management — Upload local files and manage media assets

• Operation Polling — Check generation status with manual or automatic polling

• World Management — List, filter, and retrieve generated worlds

• Full Model Support — marble-1.1-plus, marble-1.1, marble-1.0, marble-1.0-draft

Related MCP server: Blender MCP

Setup

1. Install dependencies

npm install

2. Configure your API key

Create a .env file in the project root (or use an existing one):

WLT_API_KEY=your_api_key_here

You can also use WORLDLABS_API_KEY as the variable name.

3. Build

npm run build

4. Add to Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "marble-worldlabs": {
      "command": "node",
      "args": ["c:\\path_to_project\\marble_worldlabs\\dist\\index.js"],
      "env": {
        "WLT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or if you prefer to use the .env file instead of inline env vars:

{
  "mcpServers": {
    "marble-worldlabs": {
      "command": "node",
      "args": ["c:\\path_to_project\\marble_worldlabs\\dist\\index.js"]
    }
  }
}

5. Add to Claude Code (optional)

claude mcp add marble-worldlabs node "E:\SolSync\Projects\code stuff\marble_worldlabs\dist\index.js"

Available Tools

Typical Workflow

1. Generate — Use any generate_world_from_* tool to start world creation

2. Wait — Use wait_for_operation to auto-poll, or get_operation_status to check manually

3. View — Open the returned world_marble_url in a browser, or use get_world for asset URLs

4. Download — Use the asset URLs (splats, mesh, panorama) for your projects

Models

Notes

• World generation typically takes ~5 minutes

• The API uses credits — check pricing

• Generated worlds can be viewed at https://marble.worldlabs.ai/world/{world_id}

• Asset URLs include Gaussian splats (SPZ format), collider meshes (GLB), and panorama images