·  HAYBAGAEA  ·  TERRAIN GENERATION  ·  MCP PROTOCOL  · 

TERRAIN AT THE SPEED OF THOUGHT.

Connect Claude, Cursor, or Cline to Gaea's build engine. One sentence summons a full terrain graph — mountains, erosion, rivers — cooked and exported to Unreal Engine.

BEGIN GENERATION VIEW ON GITHUB
0 MCP Tools
0+ Node Types
<1s Update Time
MIT License
SCROLL
LIVE TERRAIN SESSION

Watch It Build

Nodes appear in Gaea's graph in real-time as Claude adds them. No export, no import — Gaea auto-reloads on every change.

HEADLESS PIPELINE

Fast Iteration

No Gaea window needed. Describe a terrain, get a heightmap on disk in seconds. Ideal for pipelines.

35+ NODE CATALOG

Conversation-Driven

Open, add, connect, remove, tweak, cook — all from natural language. The AI handles graph topology.

CROSS-PLATFORM

Works Everywhere

Claude Desktop, Claude Code, Cursor, Cline. One installer. Cross-platform. Done in under a minute.

Terrain Renders — What Gaea Generates

Mountains, canyons, dunes, volcanos — Gaea produces it all from a single text prompt.

Gaea 1
Alpine Range
Gaea 2
Desert Dunes
Gaea 3
Snow Peaks
Gaea 4
Canyon Walls
Gaea 5
Rocky Ridge
Gaea 6
Aerial Valley
Gaea 7
Alpine Lake
Gaea 8
Volcanic Field
Gaea 9
Erosion Flow
Gaea 10
Mountain Pass
Gaea 1
Alpine Range
Gaea 2
Desert Dunes
Gaea 3
Snow Peaks
Gaea 4
Canyon Walls
Gaea 5
Rocky Ridge
Gaea 6
Aerial Valley
Gaea 7
Alpine Lake
Gaea 8
Volcanic Field
Gaea 9
Erosion Flow
Gaea 10
Mountain Pass
Gaea 11
Deep Valley
Gaea 12
Canyon Aerial
Gaea 13
Tundra Plain
Gaea 14
River Cut
Gaea 15
Blizzard Ridge
Gaea 16
Forest Slope
Gaea 17
Sediment Layer
Gaea 18
Thermal Shaper
Gaea 19
Heightmap Export
Gaea 20
Landscape Cook
Gaea 11
Deep Valley
Gaea 12
Canyon Aerial
Gaea 13
Tundra Plain
Gaea 14
River Cut
Gaea 15
Blizzard Ridge
Gaea 16
Forest Slope
Gaea 17
Sediment Layer
Gaea 18
Thermal Shaper
Gaea 19
Heightmap Export
Gaea 20
Landscape Cook
Elemental Architecture

TECTONIC TRANSLATION

HaybaGaea sits between your AI assistant and Gaea. It speaks MCP to Claude and writes .terrain files that Gaea auto-reloads — no proprietary protocol reverse-engineering required.

AI Client
Claude · Cursor · Cline
any MCP-compatible tool
stdio MCP
Node.js Server
HaybaGaea
11 MCP tools
.terrain files
Terrain Engine
Gaea 2.x
auto-reloads
heightmap
Game Engine
Unreal Engine 5
.r32 / .png import
// 01

You type a prompt

In Claude Desktop: "Build me a snowy mountain range with heavy erosion and deep valleys." No JSON, no node names to memorize.

// 02

Claude plans the graph

Claude calls list_node_types() to see available nodes, then decides which to add and how to wire them — Mountain → Erosion → FractalTerraces → Autolevel.

// 03

HaybaGaea writes the file

Each add_node() call writes to the .terrain JSON on disk. Gaea's file watcher detects the change and reloads the graph in real-time.

// 04

Cook and export

cook_graph() runs headlessly, waits for the build, and returns the heightmap path. Import directly into Unreal Engine as a Landscape.

Live Session Mode

Interactive Graph Building

Gaea opens alongside Claude Desktop. Every node appears instantly. Tweak parameters mid-conversation. Edit manually in Gaea and Claude picks up your changes automatically.

open_session add_node connect_nodes remove_node set_parameter cook_graph close_session
Headless Batch Mode

Silent Pipeline Export

Gaea never opens. One call generates the graph, runs the build silently, and returns a heightmap path. Ideal for rapid iteration, automation, and CI pipelines.

create_terrain list_node_types
Initialization

FIRST SUMMONING

1

Download HaybaGaea

Clone the repo or download the ZIP from GitHub.

bash
git clone https://github.com/zajalist/gaea_mcp
cd gaea_mcp

Requires Gaea 2.0+ and Node.js 20+

2

Run the interactive installer

Auto-detects your OS, Gaea installation, and installed MCP clients, then patches the right config file.

Windows
macOS
Linux
powershell
# Option A: Node.js installer (recommended)
node installer/index.js

# Option B: PowerShell (legacy)
# Right-click install.ps1 → "Run with PowerShell"
  • Detects your Gaea installation
  • Shows all available MCP clients (Claude Desktop, Cursor, Continue.dev, etc.)
  • Asks which one to configure
  • Asks for heightmap output folder
  • Builds the server and patches your config
bash
bash install.sh

Note: Gaea is Windows-only. On macOS, you'll use headless mode.

  • Detects installed MCP clients
  • Asks for output folder
  • Patches your MCP client's config
bash
bash install.sh

Note: Gaea is Windows-only. On Linux, headless mode only.

  • Detects installed MCP clients (VS Code extensions, Continue.dev, etc.)
  • Configures them for GaeaMCP
  • Sets up output directory
3

Restart Claude Desktop and prompt

Restart Claude Desktop. HaybaGaea is now available as a set of tools. Start with:

prompt
"Build me a snowy mountain range with heavy erosion"

# Or open a live session:
"Open a new terrain session and add a mountain node"
Manual Setup

Prefer to configure manually? Here's the full config.

swarmhost.config.json

json
{
  "execPath": "C:\\...\\Gaea.Swarm.exe",
  "port": 0,
  "outputDir": "C:\\Users\\You\\Desktop\\gaea_output",
  "gaeaExePath": "C:\\...\\Gaea.exe"
}

claude_desktop_config.json

json
{
  "mcpServers": {
    "gaea-mcp": {
      "command": "node",
      "args": ["...\\dist\\index.js"]
    }
  }
}
The Node Catalog

ELEMENTAL ITERATION

Session Tools — live Gaea window
open_session
path?
Open an existing .terrain or create a blank one. Launches Gaea.exe. Call this first.
add_node
type, id, params?, position?
Add a node to the live graph. Gaea auto-reloads instantly.
connect_nodes
from_id, from_port, to_id, to_port
Wire two nodes together by port name.
remove_node
id
Remove a node and clear all its connections.
set_parameter
nodeId, param, value
Change a single parameter value. Sub-second update.
cook_graph
nodes?
Build the current session and export heightmap.
get_graph_state
—
Inspect all nodes, connections, and cook status.
get_parameters
nodeId
List editable parameters for a specific node.
close_session
—
Stop Gaea and clear saved session state.
Batch Tools — headless, no Gaea window
create_terrain
prompt?, template?, graph?, outputDir?, resolution?
Full pipeline: generate graph → build → return heightmap path. Three modes: template, graph, or catalog.
list_node_types
category?
Full node catalog with categories, parameters, and port names.
35+ Node Types
Primitives (10)
Mountain · MountainSide · Ridge · Perlin · MultiFractal · Voronoi · Range · Crater · Rugged · RadialGradient
Base terrain generators with full enum support
Erosion (3)
Erosion2 · EasyErosion · ThermalShaper
Hydraulic & thermal erosion with validated enums
Filters (12)
FractalTerraces · Roughen · Height · Slope · Adjust · Autolevel · Deflate · Fold · Curvature · Clamp · Blur · Invert
Shape modifiers; Autolevel normalizes height
Transform (2)
Combine · Transform
Blend modes (24 enums) and spatial transforms
Weather (4)
Snow · Snowfield · Glacier · Weathering
Snow & ice effects with validated enums
Data & Color (6)
SatMap · SuperColor · ColorErosion · TextureBase · GroundTexture · FlowMap
Coloring, texturing, and data extraction
Advanced (3)
Debris · Scree · Sandstone
Procedural debris and sediment deposition
What You Can Build

SCULPTING THE VOID

// 01

Build from scratch

Describe a terrain in natural language. Claude opens Gaea, adds nodes one by one, and you watch the graph assemble in real-time.

"Build me a snowy mountain range with heavy erosion and deep valleys"
// 02

Iterate on existing projects

Open any existing .terrain file. Claude reads the current graph and modifies nodes without touching anything you didn't ask about.

"Open my canyon project and add more rock surface detail to the walls"
// 03

Live parameter tweaking

Change erosion strength, seed, scale — one sentence. The file updates atomically and Gaea reloads in under a second.

"Make the erosion less aggressive" → set_parameter updates in <1s
// 04

Pick up your manual edits

Edit nodes manually inside Gaea and save. gaea_mcp detects the file change automatically. Ask Claude to continue seamlessly.

"Now erode what I just set up"
// 05

Quick headless batch

No session needed. Describe a terrain, get a heightmap on disk. Gaea never opens. Ideal for pipelines and automation.

"Generate a desert heightmap at 4096 and save to my desktop"
// 06

Use terrain templates

Four built-in presets — desert, mountains, tropical, volcanic — with tweakable parameters for quick results.

"Use the volcanic template, seed 42, extra erosion"
The Genesis

SUMMON YOUR TERRAIN.
TERRAIN AT THE SPEED OF THOUGHT. FREE. OPEN SOURCE. MIT.

Connect your AI to Gaea's build engine today. Free, open source, MIT licensed.

BEGIN GENERATION VIEW ON GITHUB