# entity.add

> Talos next · Since next

[editor or disk] A new entity in the scene, as one undo step.

Components are the contract's, each with its "type" (shapes: argus://contract/scene).

| | |
|---|---|
| Title | Add an entity |
| Mode |  |
| Token cost | about 255 tokens (in the default list, paid on every call) |
| Toolset | core |

## 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. |
| `children` | `object[]` | no |  |  | Added under it in the same step (a vehicle's wheels): {name, position\|transform, components} |
| `components` | `object[]` | no |  |  |  |
| `id` | `string` | no |  |  | The entity id; made from the name when absent |
| `name` | `string` | yes |  |  | The label; need not be unique |
| `parent` | `string` | no |  |  |  |
| `position` | `number[]` | no |  |  |  |
| `save` | `boolean` | no |  |  | `true` saves the scene afterwards. |
| `scene` | `string` | no |  |  | The scene file to act on. The open scene when absent. |
| `tags` | `string[]` | no |  |  |  |
| `transform` | `object` | no |  |  | position, rotation (quaternion), scale; beats position |

## Example

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

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