Schema | mcp-clickhouse

mcp-clickhouse

Describes the environment variables required to run the server.

Name	Required	Description	Default
`CLICKHOUSE_URL`	Yes	The URL of the ClickHouse server, e.g. http://clickhouse:8123
`CLICKHOUSE_MODE`	No	Access mode: read-only, read-write, or admin	read-only
`CLICKHOUSE_USER`	Yes	The username for the ClickHouse connection
`CLICKHOUSE_DRY_RUN`	No	When true, write/destructive statements are validated and logged but not executed	false
`CLICKHOUSE_MAX_ROWS`	No	Hard cap on the number of rows returned to the model	1000
`CLICKHOUSE_PASSWORD`	Yes	The password for the ClickHouse connection
`CLICKHOUSE_AUDIT_LOG`	No	Emits a JSON audit line to stderr for each guarded operation	true
`CLICKHOUSE_ALLOW_DELETE`	No	Whether destructive SQL statements (DROP, TRUNCATE, DELETE) are allowed	false
`CLICKHOUSE_DATABASE_ALLOWLIST`	No	Comma-separated list of databases that the server is allowed to operate on
`CLICKHOUSE_PROTECTED_DATABASES`	No	Comma-separated list of databases that are read-only and can never be mutated	system,information_schema

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Features and capabilities supported by this server

Protocol revision2025-11-25

Capability	Details
`tools`	{ "listChanged": true }

Functions exposed to the LLM to take actions

Name	Description
list_databasesA	List databases and their engines.
list_tablesA	List tables in a database with engine, row count, and size.
describe_tableB	Column names, types, defaults, and comments for a table.
show_create_tableA	Return the full CREATE TABLE statement (schema, engine, settings) for a table.
table_statsB	Part count, row count, on-disk size, and time range from system.parts.
running_queriesA	Currently executing queries from system.processes (id, user, elapsed, memory).
server_metricsB	Non-zero metrics from system.metrics (connections, merges, memory, etc.).
cluster_infoA	Cluster topology from system.clusters (shards, replicas, hosts).
queryA	Run a SELECT/SHOW/DESCRIBE query and return rows. Non-read statements are refused here — use `execute` (read-write mode) for those. Results are capped at CLICKHOUSE_MAX_ROWS.

Interactive templates invoked by user choice

Name	Description
No prompts

Contextual data attached and managed by the client

Name	Description
No resources

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dockndevai/mcp-clickhouse'

If you have feedback or need assistance with the MCP directory API, please join our Discord server