MCP for Blender
Menu World Labs Marble

Integrations

World Labs Marble Integration: Gaussian Splat Worlds in MCP for Blender

Generate a whole explorable world from a text prompt, an image or a 360° panorama with World Labs Marble, and import it into Blender as Gaussian splats. Use it with Premium Pro and up or your own World Labs API key.

World Labs Marble generates a whole explorable world from a text prompt, an image or a 360° panorama. MCP for Blender imports it as Gaussian splats: a photoreal capture of the place that you can look around and set objects in.

"Use World Labs to generate a warm, rustic cabin living room with a glowing stone fireplace, cozy leather sofa, wooden beams, and large windows overlooking a snowy forest."

Each world arrives in your scene as:

  • Gaussian splats of the whole environment, parented to an empty named after the world.
  • A hidden collision mesh, a rough mesh of the ground and walls your assistant uses to place objects on surfaces. It's shown as wireframe and never renders.
  • The panorama as the world background, so reflections and the sky match the place.

The world is in metres with the ground at z=0, so objects you add from other sources line up with it.

World Labs needs Blender 5.3 or newer, which imports and renders Gaussian splats. On older versions the World Labs option in the sidebar is greyed out.

You can run World Labs two ways:

  • With MCP for Blender Premium: no World Labs account or API key. Every world uses Marble 1.1 and counts as one high-quality generation, so it needs the Pro, Studio or Max plan.
  • With your own World Labs API key: choose Marble 1.1 Plus or Marble 1.1, and pay World Labs directly.

Setup

With Premium

  1. Subscribe to the Pro, Studio or Max plan at mcp-for-blender.com/premium.

  2. Make sure the addon is up to date: run uvx mcp-for-blender@latest update, then restart your MCP client and Blender. World Labs needs the latest addon.

  3. Activate your license key in Edit → Preferences → Add-ons → MCP for Blender under 3D Generation. See Activate your license key.

  4. Activating turns World Labs on in the current scene. In other scenes, press N in the 3D viewport, open the MCP for Blender tab and tick World Labs under Gaussian Worlds. The sidebar shows Runs through Premium.

Each world comes out of your monthly high-quality allowance.

With your own API key

  1. Get an API key from platform.worldlabs.ai/api-keys. API credits are separate from Marble app credits.

  2. In Blender, press N in the 3D viewport and open the MCP for Blender tab.

  3. Tick World Labs under Gaussian Worlds, choose a Model (Marble 1.1 Plus or Marble 1.1), and paste your key.

You can also set the key with the BLENDERMCP_WORLDLABS_API_KEY environment variable in the environment Blender is launched from. See Configuration.

Generation Workflow

Your AI generates worlds with generate_gaussian_world, which submits the job, waits for it, and imports the result. A world takes about 5 minutes, longer than one call waits, so the tool returns a job handle and the AI calls it again to keep waiting. Asking for the same world again while it's still generating resumes that generation instead of paying for a new one.

generate_gaussian_world(prompt="sunlit Mediterranean courtyard with a fountain")

Your assistant only generates a world when you ask for one, or for a ready-made environment to set things in. For ordinary scene building it models the ground and rooms in Blender or uses library assets, and it uses generate_3d for single objects.

Parameters

Parameter Description
prompt A description of the place, in English, such as "sunlit Mediterranean courtyard with a fountain".
image Instead of a prompt: an absolute image path or an http(s) URL of the place. A 360° equirectangular panorama works too. On your own key, also a folder of up to 4 photos of one place, in name order going around it (the first is the front).
name Name of the world's parent object. Defaults to one made from the prompt.
resolution How many splats to import: 100k, 500k (default) or full_res (about 2 million, sharper but slow in the viewport).
job A handle from an earlier call, to keep waiting for that world.

Models

Model Premium Your own key
Marble 1.1 Every world, one high-quality generation Available
Marble 1.1 Plus Not available Default, larger worlds

Best For

Use World Labs when you want a whole place rather than a single object: a backdrop to stage products or characters in, or a photoreal environment to explore.

Instant environments

A courtyard, forest, street or interior from one prompt, ready to set objects in.

Places from photos

Turn a photo or a 360° panorama of a real place into a world you can move the camera through.

Limitations

  • Needs Blender 5.3 or newer.
  • Splats are a capture, not editable meshes. You can move, scale and light around the world, but not model or retexture its surfaces. Use the hidden collision mesh for placing objects.
  • Through Premium, a world takes one prompt or one image. A folder of photos needs your own key.
  • Images attached in the chat can't be passed to Blender. Give your assistant a file path or URL instead.
  • Each world uses a high-quality generation (Premium) or World Labs API credits (your own key), so ask for worlds deliberately.

Example Prompts

  • "Generate a Gaussian splat world of a misty pine forest at dawn with World Labs"
  • "Use World Labs to turn /Users/me/Desktop/courtyard.jpg into a world, then put a bench by the fountain"
  • "Make a World Labs world of a neon-lit Tokyo alley and place my car model in it"