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

# Read Variable (AI Tool)

> Retrieve a value from a named variable that was previously stored. Returns the stored value or indicates if the variable doesn't exist.

# Read Variable (AI Tool)

Retrieve a value from a named variable that was previously stored. Returns the stored value or indicates if the variable doesn't exist.

## Properties

| Property   | Value                 |
| ---------- | --------------------- |
| **Type**   | ai-read-variable-tool |
| **Family** | AI                    |
| **Group**  | Tools                 |

## Parameters

| Name            | Label            | Type   | Description                                                                    | Required |
| --------------- | ---------------- | ------ | ------------------------------------------------------------------------------ | -------- |
| toolName        | Tool Name        | String | Name the AI will use to call this tool                                         | Yes      |
| toolDescription | Tool Description | String | Description to help the AI understand when to use this tool                    | Yes      |
| variableName    | Variable Name    | String | The name of the variable to read (e.g., 'user\_preference', 'search\_results') | No       |

## Outputs

| Name         | Label        | Type    | Description                             |
| ------------ | ------------ | ------- | --------------------------------------- |
| variableName | variableName | string  | Name of the variable that was read      |
| value        | value        | any     | The retrieved value (null if not found) |
| exists       | exists       | boolean | Whether the variable exists             |