# Engine.add
URL: https://lsd.tools/docs/api-engine-add
Updated: 2026-07-17

## Parameters

| name | type | default | description |
|---|---|---|---|
| `entity` | `Entity` | — | the entity to add to the project |

## Example

```python
from lsdtools import Engine, Entity

engine = Engine("survey.lsd")
engine.add(Entity("sales")).add(Entity("report"))
```

## Notes

`add` returns the **engine** (not the entity), so calls chain — `engine.add(a).add(b)` stays typed
as `Engine`. To fetch an entity back by name later, use [`get`](/docs/api-engine-get).

## See also

**API:** [get](/docs/api-engine-get) · [run](/docs/api-engine-run) · [save](/docs/api-engine-save) · [Engine](/docs/api-engine)

**Guides:** [Your first tool](/docs/ex-hello-tool)