# road.sample

> Talos next · Since next

Points ON a road's surface from its file, no Play: each [s, offset] (metres along, metres right) gives WORLD position, normal, bankDeg, strip and a rotation standing a prop flush on it, facing along the road.

Use it for props on banked or sloped road, not the centre line's height.

| | |
|---|---|
| Title | Points on a road's surface |
| Mode | `disk` |
| Token cost | about 169 tokens (listed only when its toolset is enabled) |
| Toolset | `measure` |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `agent` | `string` | no |  |  | The name of the agent making the call, when several agents share one connection: each named agent is its own actor and plays its own game. Leave it out when there is one agent. |
| `points` | `number[][]` | yes |  |  | [s, offset] pairs, at most 400 |
| `road` | `string` | yes |  |  | The road entity |

## Example

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

```json
{
  "name": "road.sample",
  "arguments": {
    "points": [],
    "road": "<road>"
  }
}
```