# Settings

> Read, change and reset chart settings.

Source: https://kcq.nebutra.com/docs/agent/tools/settings


<Callout>
  Generated from the pinned chart source (

  [`1aa5e22`](https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/foundation/agent/chartToolRegistry.ts)

  ). Descriptions are the exact text the model receives.
</Callout>

settings_get [#settings_get]

<ToolMeta label="Get chart settings" safety="read-only" safetyLabel="Read-only" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/settings/settingsCommands.ts#L141" sourceLabel="Source" />

Read the current chart preferences (theme, grid, axes, time zone, tooltip, renderer, cache limit, colors) and the schema of writable keys with their allowed values.

**Parameters**

This tool takes no input.

<ToolSchema name="settings_get" label="JSON Schema" />

settings_update [#settings_update]

<ToolMeta label="Update chart settings" safety="destructive" safetyLabel="Modifies the chart" mode="Runs in order" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/settings/settingsCommands.ts#L173" sourceLabel="Source" />

Apply one or more chart preferences immediately, e.g. \{"values":\{"theme":"light","showGridLines":false}}. Call settings\_get first for allowed keys and values. The same action backs the settings dialog, so the user sees the change at once.

**Parameters**

| Name                | Type                | Required | Constraints | Description |
| ------------------- | ------------------- | -------- | ----------- | ----------- |
| <code>values</code> | <code>record</code> | Yes      | —           |             |

**Minimal input** · Required fields only; placeholders are derived from the schema.

```json
{
  "values": {}
}
```

<ToolSchema name="settings_update" label="JSON Schema" />

settings_reset [#settings_reset]

<ToolMeta label="Reset chart settings" safety="destructive" safetyLabel="Modifies the chart" mode="Runs in order" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/settings/settingsCommands.ts#L187" sourceLabel="Source" />

Restore chart preferences to their defaults. Pass "keys" to reset only those settings; omit it to reset everything. Returns the previous values.

**Parameters**

| Name              | Type                   | Required | Constraints                                              | Description |
| ----------------- | ---------------------- | -------- | -------------------------------------------------------- | ----------- |
| <code>keys</code> | <code>string\[]</code> | —        | min items <code>1</code>; item min length <code>1</code> |             |

**Minimal input** · Required fields only; placeholders are derived from the schema.

```json
{}
```

<ToolSchema name="settings_reset" label="JSON Schema" />