Tools on MCP Toolbox for Databases

clickhouse-execute-sql

Mon, 01 Jan 0001 00:00:00 +0000

About

A clickhouse-execute-sql tool executes a SQL statement against a ClickHouse database.

clickhouse-execute-sql takes one input parameter sql and runs the SQL statement against the specified source. This tool includes query logging capabilities for monitoring and debugging purposes.

Note: This tool is intended for developer assistant workflows with human-in-the-loop and shouldn’t be used for production agents.

Compatible Sources

This tool can be used with the following database sources:

Source Name
ClickHouse Source

Parameters

parameter	type	required	description
sql	string	true	The SQL statement to execute against the database

Example

kind: tool
name: execute_sql_tool
type: clickhouse-execute-sql
source: my-clickhouse-instance
description: Use this tool to execute SQL statements against ClickHouse.

Reference

field	type	required	description
type	string	true	Must be “clickhouse-execute-sql”.
source	string	true	Name of the ClickHouse source to execute SQL against.
description	string	true	Description of the tool that is passed to the LLM.

clickhouse-sql

Mon, 01 Jan 0001 00:00:00 +0000

About

A clickhouse-sql tool executes SQL queries as prepared statements against a ClickHouse database.

This tool supports both template parameters (for SQL statement customization) and regular parameters (for prepared statement values), providing flexible query execution capabilities.

Compatible Sources

This tool can be used with the following database sources:

Source Name
ClickHouse Source

Example

kind: tool
name: my_analytics_query
type: clickhouse-sql
source: my-clickhouse-instance
description: Get user analytics for a specific date range
statement: |
 SELECT 
 user_id,
 count(*) as event_count,
 max(timestamp) as last_event
 FROM events 
 WHERE date >= ? AND date <= ?
 GROUP BY user_id
 ORDER BY event_count DESC
 LIMIT ?
parameters:
 - name: start_date
 description: Start date for the query (YYYY-MM-DD format)
 - name: end_date 
 description: End date for the query (YYYY-MM-DD format)
 - name: limit
 description: Maximum number of results to return

Template Parameters Example

kind: tool
name: flexible_table_query
type: clickhouse-sql
source: my-clickhouse-instance
description: Query any table with flexible columns
statement: |
 SELECT {{columns}}
 FROM {{table_name}}
 WHERE created_date >= ?
 LIMIT ?
templateParameters:
 - name: columns
 description: Comma-separated list of columns to select
 - name: table_name
 description: Name of the table to query
parameters:
 - name: start_date
 description: Start date filter
 - name: limit
 description: Maximum number of results

Reference

field	type	required	description
type	string	true	Must be “clickhouse-sql”.
source	string	true	Name of the ClickHouse source to execute SQL against.
description	string	true	Description of the tool that is passed to the LLM.
statement	string	true	The SQL statement template to execute.
parameters	array of Parameter	false	Parameters for prepared statement values.
templateParameters	array of Parameter	false	Parameters for SQL statement template customization.

clickhouse-list-databases

Mon, 01 Jan 0001 00:00:00 +0000

About

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

This tool can be used with the following database sources:

Source Name
ClickHouse Source

Example

kind: tool
name: list_clickhouse_databases
type: clickhouse-list-databases
source: my-clickhouse-instance
description: List all available databases in the ClickHouse instance

Output Format

The tool returns an array of objects, where each object contains:

clickhouse-list-tables

Mon, 01 Jan 0001 00:00:00 +0000

About

A clickhouse-list-tables tool lists all available tables in a specified ClickHouse database.

This tool executes the SHOW TABLES FROM <database> command and returns a list of all tables in the specified database that are accessible to the configured user, making it useful for schema exploration and table discovery tasks.

Compatible Sources

This tool can be used with the following database sources:

Source Name
ClickHouse Source

Parameters

parameter	type	required	description
database	string	true	The database to list tables from.

Example

kind: tool
name: list_clickhouse_tables
type: clickhouse-list-tables
source: my-clickhouse-instance
description: List all tables in a specific ClickHouse database

Output Format

The tool returns an array of objects, where each object contains: