# terrain.preview

> Talos next · Since next

A PNG and legend of the terrain; upTo an op id; grid draws coordinates.

| | |
|---|---|
| Title | Look at the terrain |
| Mode | `disk` |
| Token cost | about 170 tokens (listed only when its toolset is enabled) |
| Toolset | `terrain` |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `grid` |  | no |  |  | true, or spacing, m |
| `image` | `boolean` | no |  |  | `false` leaves the picture out of the answer. |
| `region` | `number[]` | no |  |  | `[minX, minZ, maxX, maxZ]` in metres. |
| `sizePx` | `integer` | no |  |  | To 1024 |
| `terrain` | `string` | no |  |  | The `.terrain.json` file to act on. The project's only terrain when absent. |
| `upTo` | `string` | no |  |  | Stop at this op id. |
| `view` | `string` | no |  |  | hillshade, height, slope, material, mask:<name>, lit:<sunAz>,<alt>, overview, contours, slopeClasses, flow, curvature, reach:x,z, section:x0,z0,x1,z1, elevation:north\|east\|south\|west |

## Example

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

```json
{
  "name": "terrain.preview",
  "arguments": {}
}
```