# settlement.generate

> Talos next · Since next

[editor or disk] A settlement from a recipe (inline or a .settlement.json): network.grow, parcels.subdivide, dress in turn under <id>-net/-plots/-dress.

Same id regenerates.

| | |
|---|---|
| Title | Settlement |
| Mode |  |
| Token cost | about 112 tokens (listed only when its toolset is enabled) |
| Toolset | `buildings` |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `id` |  | yes |  |  |  |
| `instance` |  | no |  |  |  |
| `kit` |  | no |  |  |  |
| `recipe` | `object` | no |  |  |  |
| `recipePath` | `string` | no |  |  |  |
| `save` |  | no |  |  | `true` saves the scene afterwards. |
| `scene` |  | no |  |  | The scene file to act on. The open scene when absent. |

## Example

An MCP `tools/call` with the required arguments (placeholders in angle brackets).

```json
{
  "name": "settlement.generate",
  "arguments": {
    "id": null
  }
}
```