# entity.align

> Talos next · Since next

Move an entity so points on it land on matching points elsewhere (a modelled part onto a scan): world-space pairs, 3+; rigid, or with one uniform scale.

Answers the RMS residual; apply false only measures. ground: true drops it onto what is below instead (a road's surface or the terrain if the scene has one, even with no editor); tilt: true also turns it to the slope.

| | |
|---|---|
| Title | Align an entity onto matching points |
| Mode | `editor` |
| Token cost | about 246 tokens (listed only when its toolset is enabled) |
| Toolset | `assets` |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `apply` | `boolean` | no | `true` |  | `false` writes nothing and reports what would change. |
| `entity` | `string` | yes |  |  |  |
| `ground` | `boolean` | no |  |  |  |
| `part` | `number[][]` | no |  |  | Points on the entity, world space |
| `scan` | `number[][]` | no |  |  | The matching points, same order |
| `similarity` | `boolean` | no | `false` |  |  |
| `tilt` | `boolean` | no |  |  |  |

## Example

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

```json
{
  "name": "entity.align",
  "arguments": {
    "entity": "<entity>"
  }
}
```