docs/en/integrations/clickhouse/tools/clickhouse-list-databases.md
A clickhouse-list-databases tool lists all available databases in a ClickHouse
instance.
This tool executes the SHOW DATABASES command and returns a list of all
databases accessible to the configured user, making it useful for database
discovery and exploration tasks.
{{< compatible-sources >}}
kind: tool
name: list_clickhouse_databases
type: clickhouse-list-databases
source: my-clickhouse-instance
description: List all available databases in the ClickHouse instance
The tool returns an array of objects, where each object contains:
name: The name of the databaseExample response:
[
{"name": "default"},
{"name": "system"},
{"name": "analytics"},
{"name": "user_data"}
]
| field | type | required | description |
|---|---|---|---|
| type | string | true | Must be "clickhouse-list-databases". |
| source | string | true | Name of the ClickHouse source to list databases from. |
| description | string | true | Description of the tool that is passed to the LLM. |
| authRequired | array of string | false | Authentication services required to use this tool. |
| parameters | array of Parameter | false | Parameters for the tool (typically not used). |