> ## Documentation Index
> Fetch the complete documentation index at: https://code.dcycle.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Elastic Data Tools

> MCP tools for querying custom elastic datasets

# Elastic Data Tools

Query custom elastic datasets — user-defined data structures with flexible schemas for tracking any type of sustainability data.

## `list_datasets`

List all elastic datasets for the organization.

**Parameters:**

| Parameter         | Type   | Required | Description                                 |
| ----------------- | ------ | -------- | ------------------------------------------- |
| `organization_id` | string | No       | Organization UUID (uses default if not set) |

**Example prompt:** "List our custom datasets"

***

## `get_dataset`

Get an elastic dataset by ID with its field definitions and schema.

**Parameters:**

| Parameter         | Type   | Required | Description                                 |
| ----------------- | ------ | -------- | ------------------------------------------- |
| `dataset_id`      | string | **Yes**  | UUID of the dataset                         |
| `organization_id` | string | No       | Organization UUID (uses default if not set) |

**Example prompt:** "Show the schema for dataset ds-123"

***

## `query_dataset`

Query records from an elastic dataset with pagination.

**Parameters:**

| Parameter         | Type    | Required | Description                                 |
| ----------------- | ------- | -------- | ------------------------------------------- |
| `dataset_id`      | string  | **Yes**  | UUID of the dataset                         |
| `organization_id` | string  | No       | Organization UUID (uses default if not set) |
| `page`            | integer | No       | Page number (default: 1)                    |
| `size`            | integer | No       | Results per page (default: 50)              |

**Example prompt:** "Show records from our energy tracking dataset"

## Workflow

1. Call `list_datasets` to discover available datasets
2. Use `get_dataset` to understand the schema and fields
3. Use `query_dataset` to retrieve records

## Example Prompts

* "What custom datasets do we have?"
* "Show me the fields in our water consumption dataset"
* "Query the first 20 records from dataset ds-123"