· 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
<1 s 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.

Alpine Range
Desert Dunes
Snow Peaks
Canyon Walls
Rocky Ridge
Aerial Valley
Alpine Lake
Volcanic Field
Erosion Flow
Mountain Pass
Alpine Range
Desert Dunes
Snow Peaks
Canyon Walls
Rocky Ridge
Aerial Valley
Alpine Lake
Volcanic Field
Erosion Flow
Mountain Pass
Deep Valley
Canyon Aerial
Tundra Plain
River Cut
Blizzard Ridge
Forest Slope
Sediment Layer
Thermal Shaper
Heightmap Export
Landscape Cook
Deep Valley
Canyon Aerial
Tundra Plain
River Cut
Blizzard Ridge
Forest Slope
Sediment Layer
Thermal Shaper
Heightmap Export
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