ClickHouse (Vector Search) MCP Server
Manage vector embeddings and SQL via ClickHouse — list databases, execute SQL, and perform high-speed vector searches directly from any AI agent.
Ask AI about this MCP Server
Vinkius supports streamable HTTP and SSE.

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
What is the ClickHouse MCP Server?
The ClickHouse MCP Server gives AI agents like Claude, ChatGPT, and Cursor direct access to ClickHouse via 7 tools. Manage vector embeddings and SQL via ClickHouse — list databases, execute SQL, and perform high-speed vector searches directly from any AI agent. Powered by the Vinkius - no API keys, no infrastructure, connect in under 2 minutes.
Built-in capabilities (7)
Tools for your AI Agents to operate ClickHouse
Ask your AI agent "List all databases in my ClickHouse cluster" and get the answer without opening a single dashboard. With 7 tools connected to real ClickHouse data, your agents reason over live information, cross-reference it with other MCP servers, and deliver insights you would spend hours assembling manually.
Works with Claude, ChatGPT, Cursor, and any MCP-compatible client. Powered by the Vinkius - your credentials never touch the AI model, every request is auditable. Connect in under two minutes.
Why teams choose Vinkius
One subscription gives you access to thousands of MCP servers - and you can deploy your own to the Vinkius Edge. Your AI agents only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure and security, zero maintenance.
Build your own MCP Server with our secure development framework →Vinkius works with every AI agent you already use
…and any MCP-compatible client


















ClickHouse (Vector Search) MCP Server capabilities
7 toolsPerform structural extraction of properties driving active column schemas
Provision a highly-available SQL execution pushing arbitrary arbitrary DML/DDL or SELECTs
Extracts explicitly attached internal structural states pulling cluster health
g. HNSW support). Identify precise active cluster limits spanning the execution runtime
Identify bounded logical arrays managing top-level ClickHouse schemas
Retrieve the exact structural matching verifying table limits inside a database
Identify explicit mathematical distance traces routing Vector Embeddings
What the ClickHouse (Vector Search) MCP Server unlocks
Connect your ClickHouse cluster to any AI agent and take full control of your analytical and vector data through natural conversation.
What you can do
- Schema Management — List databases and tables, and inspect deep column schemas including specialized Array(Float32) vector types
- SQL Execution — Push arbitrary DML, DDL, or SELECT queries to your cluster to manage data and generate real-time reports
- Vector Search — Identify mathematical distance traces using cosineDistance or L2Distance metrics for high-dimensional semantic search
- Cluster Monitoring — Extract internal structural states, row counts, and compression ratios to audit cluster health
- Capability Auditing — Check instance versions and binary limits to identify exact capability branches like HNSW support
How it works
1. Subscribe to this server
2. Enter your ClickHouse URL (Cloud or self-hosted), Username, and Password
3. Start querying your analytical data from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Data Analysts — generate complex analytical reports and execute SQL queries using natural language
- AI Developers — test and debug vector similarity searches and semantic matching without writing boilerplate code
- Database Administrators — monitor table statistics, compression ratios, and cluster versions across environments
- Product Teams — quickly verify analytical data and vector distributions during the prototyping phase
Frequently asked questions about the ClickHouse (Vector Search) MCP Server
Can my agent perform high-speed vector similarity searches?
Yes. Provide the database, table, and the vector embedding array in JSON format. The agent uses ClickHouse's native distance functions (cosine or L2) to return the closest matches, leveraging ClickHouse's industry-leading OLAP performance.
Can I execute arbitrary SQL commands directly through the agent?
Absolutely. The 'execute_sql' tool allows you to push any valid ClickHouse SQL (DML, DDL, or SELECT) to your cluster. This is perfect for managing tables, updating records, or generating custom analytical reports on the fly.
How do I check if my ClickHouse instance supports HNSW indices?
Ask your agent to get the version details. The agent checks your ClickHouse build and identifies exactly which capability branches are active, confirming if advanced vector features like HNSW support are available in your runtime environment.
More in this category
You might also like
Connect ClickHouse (Vector Search) with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Give your AI agents the power of ClickHouse MCP Server
Production-grade ClickHouse (Vector Search) MCP Server. Verified, monitored, and maintained by Vinkius. Ready for your AI agents — connect and start using immediately.






