---
title: Digital Twins
slug: litmus-mcp-server/digital-twins
docTags: 
createdAt: 2026-05-11T21:49:16.017Z
---

# Digital Twins

Create, inspect, and configure Digital Twin models and instances on Litmus Edge.

| Tool                           | Description                                                              |
| ------------------------------ | ------------------------------------------------------------------------ |
| `list_digital_twin_models`     | List all Digital Twin models with ID, name, description, and version.    |
| `create_digital_twin_model`    | Create a new Digital Twin model.                                         |
| `list_digital_twin_instances`  | List all Digital Twin instances or filter by model ID.                   |
| `create_digital_twin_instance` | Create a new Digital Twin instance from an existing model.               |
| `list_static_attributes`       | List static attributes (fixed key-value pairs) for a model or instance.  |
| `list_dynamic_attributes`      | List dynamic attributes (real-time data points) for a model or instance. |
| `list_transformations`         | List data transformation rules configured for a Digital Twin model.      |
| `get_digital_twin_hierarchy`   | Get the hierarchy configuration for a Digital Twin model.                |
| `save_digital_twin_hierarchy`  | Save a new hierarchy configuration to a Digital Twin model.              |

## When to use which

- **Modeling phase:** `list_digital_twin_models`, `create_digital_twin_model`, plus the attribute and transformation listers to inspect what an existing model exposes.
- **Instantiation:** `list_digital_twin_instances`, `create_digital_twin_instance` once the model is defined.
- **Hierarchy editing:** `get_digital_twin_hierarchy` -> modify -> `save_digital_twin_hierarchy`.

## Requirements

- `EDGE_URL`, `EDGE_API_CLIENT_ID`, `EDGE_API_CLIENT_SECRET`.

## Related

- [docs.litmus.io: Digital Twins](https://docs.litmus.io/litmusedge/product-features/digital-twins)
- `litmus://docs/edge/digitaltwins` MCP resource - feeds the model the up-to-date Digital Twins guide.