> ## Documentation index
> Fetch the complete documentation index at: [llms.txt](../llms.txt)
> Use this file to discover all available pages before exploring further.

# Datasets and charts tools

Seven tools to read the datasets and charts a run builds: page through rows, download CSV, compare versions, and get charts as specs or SVG.

None of these use credits.

### `list_datasets`

List the datasets in a project.

| Input | Type | Notes |
| --- | --- | --- |
| `project_id` (required) | string | Project UUID |

### `get_dataset`

Get a dataset with its rows a page at a time. Use `total_rows`, `row_offset`, and `row_limit` to page through.

| Input | Type | Notes |
| --- | --- | --- |
| `project_id` (required) | string | Project UUID |
| `dataset_id` (required) | string | Dataset UUID |
| `row_limit` | integer | 1 to 2,000, default 50 |
| `row_offset` | integer | Default 0 |
| `version` | integer | A past version number. Omit for the latest. |
| `include_csv` | boolean | Default false. True adds the same rows as CSV text. |

### `list_dataset_versions`

List a dataset’s versions. Sleuth saves a new version when a dataset changes, for example after monitoring finds an update.

| Input | Type | Notes |
| --- | --- | --- |
| `project_id` (required) | string | Project UUID |
| `dataset_id` (required) | string | Dataset UUID |

### `download_dataset_csv`

Download the whole dataset as CSV text. Large datasets make large results, so use `get_dataset` when a sample will do.

| Input | Type | Notes |
| --- | --- | --- |
| `project_id` (required) | string | Project UUID |
| `dataset_id` (required) | string | Dataset UUID |
| `version` | integer | A past version number. Omit for the latest. |

### `list_artifacts`

List the charts and other artifacts in a project.

| Input | Type | Notes |
| --- | --- | --- |
| `project_id` (required) | string | Project UUID |

### `get_artifact`

Get an artifact in full. Its `artifact` field is the chart spec.

| Input | Type | Notes |
| --- | --- | --- |
| `project_id` (required) | string | Project UUID |
| `artifact_id` (required) | string | Artifact UUID |

### `get_artifact_svg`

Get an artifact rendered as SVG. Returns a 422 error for artifacts that aren’t visual.

| Input | Type | Notes |
| --- | --- | --- |
| `project_id` (required) | string | Project UUID |
| `artifact_id` (required) | string | Artifact UUID |

## Related

- [Projects and runs tools](tools-projects.md): Nine tools to create projects, ask research questions, follow runs, approve plans, and read Sleuth’s answers.
- [Outputs and exports](outputs.md): What Sleuth hands back, and how to get each one out of Sleuth.
- [Errors and limits](mcp-errors.md): Every limit an agent can hit on the Sleuth MCP server, and what to do about each error.

*Updated November 9, 2026.*
