entity.add

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	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

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

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