# terrain.sample

> Talos next · Since next

Height, normal, slope, layer and channels at points, in metres.

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

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `points` | `number[][]` | yes |  |  | [x, z], to 256 |
| `terrain` | `string` | no |  |  | The `.terrain.json` file to act on. The project's only terrain when absent. |

## Example

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

```json
{
  "name": "terrain.sample",
  "arguments": {
    "points": []
  }
}
```