# `PhiaUiDesign.Mcp.BatchGet`
[🔗](https://github.com/charlenopires/PhiaUI/blob/v0.1.17/lib/phiaui_design/mcp/batch_get.ex#L1)

Pattern-based search and batch retrieval of nodes from the scene graph.

Supports searching by type, name (regex), component name, and specific
node IDs. Results are returned with configurable depth for child expansion.

# `execute`

```elixir
@spec execute(reference(), map()) :: {:ok, [map()]}
```

Execute a batch_get query against the scene.

## Query params

- `patterns` — list of pattern maps: `%{"type" => ..., "name" => ..., "component" => ...}`
- `node_ids` — list of specific node IDs to read
- `parent_id` — scope search to a subtree
- `read_depth` — how deep to expand match children (default 1; `0` = node only)
- `search_depth` — how deep to search for matches (default unlimited)

Returns `{:ok, results}` where results is a list of serialized node maps.

---

*Consult [api-reference.md](api-reference.md) for complete listing*