MCP // GODOT 4

Godot MCP for fire, smoke and explosion effects

Connect your agent to Spatial Compiler's hosted MCP server, and it can add fire, smoke, explosion and dust effects to your Godot 4 project. Ask for the effect in plain words. Your agent compiles it into a folder in the project and writes a ready scene with a shader that lights the smoke from your sun.

  • Godot 4 Available
  • Unity Manual setup
  • Unreal Engine Manual setup
  • Roblox Studio Manual setup
  • three.js Available

A draft compile is from $0.05, and new accounts start with $5 of usage.

FIRE_WHIRLFINAL
First frame of the fire_whirl bake
Fire whirl, 4.4 x 7.1 m, compiled with Spatial Compiler. Spec →

01 // CONNECT

Add the hosted server to your MCP client

MCP is the protocol your agent uses to call tools. Add Spatial Compiler's hosted server to the MCP client your agent runs in. The config holds no key, because you sign in once in your browser.

mcp.json · hosted server
{
  "mcpServers": {
    "spatial-compiler": {
      "type": "http",
      "url": "https://spatialcompiler.dev/mcp"
    }
  }
}

If you would rather use a key, the local server (npx -y @applied-manifold/spatial-compiler) reads your API key from SPATIAL_API_KEY and sends every call to the same hosted API. Both are in early access. See Install via MCP.

02 // HOW TO

Get an effect into a Godot 4 scene

  1. Add the hosted server to your MCP client and finish the browser sign-in.
  2. Ask for a looping smoke plume that responds to the scene light. Name a folder such as res://fx/smoke_plume/. For a 60 fps sequence on 2048 px sheets, ask the agent to check the hosted schema for export.output_fps and export.sheet_px first.
  3. Your agent copies the nearest example, checks it, compiles a draft and looks at preview_strip.png before it compiles at final quality.
  4. Your agent calls wire, which installs flipbook_6way.gdshader and pyro_sheet.gd, sets the texture import settings and writes a .tscn scene.
  5. Open the scene or instance it in your level. It plays on its own.
MCP calls
bake {"spec": "<name>.pyro.toml", "out": "<dir>", "quality": "final"}
wire {"bake_dir": "<dir>", "scene": "<path>.tscn"}

The scene is a quad sized in meters with its origin on the ground, so it stands where you drop it. Set autoplay = false to drive time_s from your code, or ask for set: ["node=particles"] to get a GPUParticles3D that plays many copies. See Bake and wire.

03 // REAL OUTPUT

Two loops from the examples

The fire whirl is a 2 s loop about 7 m tall. The smoke plume is a 4 s loop that leans with the wind.

SMOKE_PLUMEFINAL
First frame of the smoke_plume bake
Smoke plume, 7.0 x 10.8 m, compiled with Spatial Compiler. Spec →

04 // IN THE SCENE

What the shader does in your level

The sprite sheets hold the smoke lit from six directions (six-way lighting), so the shader relights it from your scene's sun, a DirectionalLight3D, and from the ambient light. Turn the sun and the shaded side of the plume turns with it.

The flame is added as HDR light, so WorldEnvironment glow can bloom it. Where the quad meets the floor or a wall, the effect fades out (depth fade), so you see no hard cut line.

The hosted server works with any MCP client, so it runs next to the editor tools your agent already uses for scenes and scripts, and your agent calls Spatial Compiler when it needs an effect.

06 // FAQ

Godot MCP questions

All questions →

README.GODOT_MCP
Which MCP server should I use for Godot effects?

Use the hosted Spatial Compiler MCP server for fire, smoke, explosion and dust effects. It compiles flipbook sheets and writes a Godot scene.

How do I install the Godot effects MCP server?

Add the hosted Spatial Compiler MCP URL to your MCP client and sign in through your browser. Your agent then calls wire to copy the shader.

Does the hosted MCP server work with Godot?

Yes. Your agent writes a Godot scene with a shader that lights the smoke from your DirectionalLight3D sun and ambient light.

Is the Godot effects MCP server free to use?

Connecting and running estimates are free and new accounts start with $5 of usage. Draft compile start at $0.05 and final compile start at $0.10.

Can the MCP server create Godot scenes and particle nodes?

Yes, for effects. Calling wire writes a scene with a quad or a GPUParticles3D node when your agent passes the particles option.

Compile your first effect

You pay per compile and see the price before it runs. New accounts start with $5 of usage.

All effects, guides and explainers →