# Traces

> MCP tools for the Traces module. See the [Traces module docs](/docs/modules/traces) for permissions and data model.

# Traces

MCP tools for the Traces module. See the [Traces module docs](/docs/modules/traces) for permissions and data model.

### `list-traces`

List traces

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `project_id` | `string` | no | Project public ID to filter by |
| `limit` | `number` | no | Maximum number of results to return |
| `offset` | `number` | no | Number of results to skip |

### `get-trace`

Get a trace

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `trace_id` | `string` | yes | Public ID of the trace |

### `get-trace-tree`

Get trace tree

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `trace_id` | `string` | yes | Public ID of any trace in the tree (root or child) |
| `include` | `string` | no | Comma-separated list of related resources to embed on each node. Supported value: `generations` — attaches all generations that belong to each trace node (including sub-agent generations linked via `initiator_generation_id`). |

### `purge-trace-content`

Purge trace content

#### Arguments

| Argument | Type | Required | Description |
| -------- | ---- | -------- | ----------- |
| `trace_id` | `string` | yes | Public ID of the trace |