{
 "categories": [
  "database",
  "developer-tools"
 ],
 "deployment": "hybrid",
 "evidence": [
  {
   "date": "2026-09-06",
   "fact": "homepage",
   "note": "ClickHouse presents the product as an open-source columnar database and a hosted ClickHouse Cloud service on AWS, GCP, and Azure, with a free Cloud trial and a local download path.",
   "source": "https://clickhouse.com/",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "deployment",
   "note": "The homepage documents ClickHouse Cloud, self-managed open-source ClickHouse, and ClickHouse Local, covering hosted and on-machine deployments.",
   "source": "https://clickhouse.com/",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "license",
   "note": "Open-source ClickHouse is described as always free. ClickHouse Cloud is a paid hosted service that starts at $50/month, with a free cloud trial.",
   "source": "https://clickhouse.com/",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.api.exists",
   "note": "ClickHouse documents an HTTP interface that lets any language use ClickHouse in the form of a REST API, including SQL query and INSERT over HTTP.",
   "source": "https://clickhouse.com/docs/concepts/features/interfaces/http",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.api.kinds[0]",
   "note": "The vendor describes the HTTP interface as a REST API on port 8123, with HTTPS on 8443 when enabled.",
   "source": "https://clickhouse.com/docs/concepts/features/interfaces/http",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.api.auth[0]",
   "note": "The HTTP interface documents HTTP Basic Authentication, shown as curl with user:password@host.",
   "source": "https://clickhouse.com/docs/concepts/features/interfaces/http",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.api.auth[1]",
   "note": "The HTTP interface documents X-ClickHouse-User and X-ClickHouse-Key request headers as an authentication method.",
   "source": "https://clickhouse.com/docs/concepts/features/interfaces/http",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.api.auth[2]",
   "note": "ClickHouse documents JWT authentication via an HTTP Authorization Bearer header, including a Cloud built-in JWT authenticator.",
   "source": "https://clickhouse.com/docs/concepts/features/security/external-authenticators/jwt",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.api.coverage",
   "note": "HTTP covers SQL query and INSERT. GET is read-only. The vendor states the HTTP interface is more limited than the native interface. The Cloud API is a separate organization and service management plane, not every console feature.",
   "source": "https://clickhouse.com/docs/concepts/features/interfaces/http",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.sdk.exists",
   "note": "ClickHouse documents official language clients, including JavaScript, Python, Go, and Java, plus further official and third-party clients.",
   "source": "https://clickhouse.com/docs/integrations/language-clients",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.sdk.languages[0]",
   "note": "The language-clients index documents an official JavaScript client for Node.js, browser, Cloudflare Workers, and Deno.",
   "source": "https://clickhouse.com/docs/integrations/language-clients",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.sdk.languages[1]",
   "note": "The language-clients index documents an official Python driver with synchronous and async APIs.",
   "source": "https://clickhouse.com/docs/integrations/language-clients",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.sdk.languages[2]",
   "note": "The language-clients index documents an official Go driver with Native and HTTP support.",
   "source": "https://clickhouse.com/docs/integrations/language-clients",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.sdk.languages[3]",
   "note": "The language-clients index documents an official Java client plus JDBC and R2DBC drivers.",
   "source": "https://clickhouse.com/docs/integrations/language-clients",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.mcp.first_party",
   "note": "ClickHouse documents a first-party MCP server that connects compatible AI assistants to ClickHouse databases and publishes client setup guides.",
   "source": "https://clickhouse.com/docs/guides/use-cases/ai-ml/MCP",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.cli.exists",
   "note": "ClickHouse documents clickhouse-client as the native command-line client with interactive and batch modes, including --query for non-interactive SQL.",
   "source": "https://clickhouse.com/docs/interfaces/client",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.extensibility.scripting[0]",
   "note": "The HTTP interface executes ClickHouse SQL, including SELECT and INSERT.",
   "source": "https://clickhouse.com/docs/concepts/features/interfaces/http",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.data_access.export[0]",
   "note": "ClickHouse documents CSV as an output format for SELECT results.",
   "source": "https://clickhouse.com/docs/interfaces/formats",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.data_access.export[1]",
   "note": "ClickHouse documents JSON as an output format for SELECT results.",
   "source": "https://clickhouse.com/docs/interfaces/formats",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.data_access.export[2]",
   "note": "ClickHouse documents Parquet as an output format for SELECT results.",
   "source": "https://clickhouse.com/docs/interfaces/formats",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.data_access.import[0]",
   "note": "ClickHouse documents CSV as an input format for INSERT and file-backed reads.",
   "source": "https://clickhouse.com/docs/interfaces/formats",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.data_access.import[1]",
   "note": "ClickHouse documents JSON as an input format for INSERT and file-backed reads.",
   "source": "https://clickhouse.com/docs/interfaces/formats",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.data_access.import[2]",
   "note": "ClickHouse documents Parquet as an input format for INSERT and file-backed reads.",
   "source": "https://clickhouse.com/docs/interfaces/formats",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "modalities.agent_docs.llms_txt",
   "note": "Opened https://clickhouse.com/docs/llms.txt. It is a first-party documentation index for agents, with links into Database, Solutions, and Integrations docs.",
   "source": "https://clickhouse.com/docs/llms.txt",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "verdict.scores.api",
   "note": "HTTP SQL is documented, read/write, and paired with official clients. Coverage is the SQL and insert surface rather than the native protocol or every Cloud console action, which keeps the path at production-grade rather than unusual completeness. The Cloud OpenAPI management API is additional admin coverage with a 10-request-per-10-second key limit.",
   "source": "https://clickhouse.com/docs/concepts/features/interfaces/http",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "verdict.scores.mcp",
   "note": "Official Cloud remote MCP is hosted at https://mcp.clickhouse.cloud/mcp with OAuth 2.0 and 13 read-only tools. The open-source ClickHouse/mcp-clickhouse server adds run_query with writes off by default. Per-service enablement and Cloud read-only tools keep coverage official and useful rather than complete.",
   "source": "https://clickhouse.com/docs/cloud/features/ai-ml/remote-mcp",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "verdict.scores.cli",
   "note": "clickhousectl is an official CLI for local and Cloud work, including clickhousectl local client --query and cloud service query with JSONEachRow. clickhouse-client remains the native batch SQL client. clickhousectl requirements list macOS and Linux; Windows is not claimed on that page.",
   "source": "https://clickhouse.com/docs/interfaces/cli",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "freshness.watch[0].url",
   "note": "Opened and verified as ClickHouse's current MCP integrations hub, pointing at the official MCP server and client setup guides.",
   "source": "https://clickhouse.com/docs/guides/use-cases/ai-ml/MCP",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "freshness.watch[1].url",
   "note": "Opened and verified as ClickHouse Cloud's remote MCP page, including https://mcp.clickhouse.cloud/mcp, OAuth 2.0, per-service enablement, and the 13 read-only tools.",
   "source": "https://clickhouse.com/docs/cloud/features/ai-ml/remote-mcp",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "freshness.watch[2].url",
   "note": "Opened the ClickHouse/mcp-clickhouse repository. The README documents run_query, list_databases, and list_tables, with writes off unless CLICKHOUSE_ALLOW_WRITE_ACCESS is enabled.",
   "source": "https://github.com/ClickHouse/mcp-clickhouse",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "freshness.watch[3].url",
   "note": "Opened and verified as ClickHouse's current HTTP interface documentation, including REST framing, ports, SQL query, INSERT, and authentication methods.",
   "source": "https://clickhouse.com/docs/concepts/features/interfaces/http",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "freshness.watch[4].url",
   "note": "Opened and verified as ClickHouse Cloud API key documentation, including HTTP Basic with Key ID and Key secret against https://api.clickhouse.cloud/v1.",
   "source": "https://clickhouse.com/docs/cloud/manage/openapi",
   "tier": "declared"
  },
  {
   "date": "2026-09-06",
   "fact": "freshness.watch[5].url",
   "note": "Opened and verified as the ClickHouse Cloud API overview. It is an OpenAPI REST management plane for organizations and services, with a per-key limit of 10 requests over a 10-second window.",
   "source": "https://clickhouse.com/docs/cloud/manage/cloud-api",
   "tier": "declared"
  }
 ],
 "freshness": {
  "last_verified": "2026-09-06",
  "volatility": "high",
  "watch": [
   {
    "type": "mcp",
    "url": "https://clickhouse.com/docs/guides/use-cases/ai-ml/MCP"
   },
   {
    "type": "mcp",
    "url": "https://clickhouse.com/docs/cloud/features/ai-ml/remote-mcp"
   },
   {
    "type": "repo",
    "url": "https://github.com/ClickHouse/mcp-clickhouse"
   },
   {
    "type": "docs",
    "url": "https://clickhouse.com/docs/concepts/features/interfaces/http"
   },
   {
    "type": "docs",
    "url": "https://clickhouse.com/docs/cloud/manage/openapi"
   },
   {
    "type": "docs",
    "url": "https://clickhouse.com/docs/cloud/manage/cloud-api"
   }
  ]
 },
 "homepage": "https://clickhouse.com/",
 "id": "clickhouse",
 "license": "freemium",
 "modalities": {
  "agent_docs": {
   "llms_txt": true
  },
  "api": {
   "auth": [
    "basic",
    "clickhouse-headers",
    "jwt"
   ],
   "coverage": "partial",
   "docs": "https://clickhouse.com/docs/concepts/features/interfaces/http",
   "exists": true,
   "kinds": [
    "rest"
   ]
  },
  "cli": {
   "exists": true
  },
  "computer_use": {
   "issues": [],
   "viability": "unknown"
  },
  "data_access": {
   "export": [
    "csv",
    "json",
    "parquet"
   ],
   "import": [
    "csv",
    "json",
    "parquet"
   ]
  },
  "extensibility": {
   "scripting": [
    "sql"
   ],
   "webhooks": "unknown"
  },
  "integrations": {
   "make": "unknown",
   "n8n": "unknown",
   "power_automate": "unknown",
   "zapier": "unknown"
  },
  "mcp": {
   "first_party": true,
   "third_party": [],
   "verdict": "official"
  },
  "rpa": {
   "drivability": "unknown",
   "notes": "No repeatable UI probe was run. ClickHouse HTTP SQL, the Cloud management API, clickhouse-client, clickhousectl, and first-party MCP cover query and cluster work without browser control.\n",
   "ui_stack": [
    "web-dom"
   ],
   "vendor_support": []
  },
  "sdk": {
   "exists": true,
   "languages": [
    "javascript",
    "python",
    "go",
    "java"
   ],
   "official": true
  }
 },
 "name": "ClickHouse",
 "platforms": [
  "linux",
  "macos",
  "windows",
  "web"
 ],
 "related": {
  "alternatives": [
   "snowflake",
   "google-bigquery",
   "elasticsearch"
  ],
  "our_products": []
 },
 "schema_version": 1,
 "score_version": 1,
 "status": "active",
 "vendor": "ClickHouse",
 "verdict": {
  "best_path": "api",
  "scores": {
   "api": 8,
   "cli": 8,
   "computer_use": null,
   "integrations": null,
   "mcp": 8,
   "overall": 8,
   "rpa": null
  },
  "summary": "ClickHouse is automatable today through its HTTP interface, which the vendor documents as a REST API, and through first-party MCP. The HTTP interface listens on port 8123 (HTTPS 8443) and runs SQL. GET requests are read-only; INSERT and other writes require POST. Documented HTTP authentication methods are HTTP Basic, user and password URL parameters, and the X-ClickHouse-User and X-ClickHouse-Key headers. ClickHouse also documents JWT Bearer tokens on the HTTP interface, including a Cloud built-in JWT authenticator used by SQL Console and clickhouse-client --login. Default HTTP output is TabSeparated; FORMAT selects JSON, CSV, Parquet, and other documented formats. The ClickHouse Cloud API at https://api.clickhouse.cloud/v1 is a separate OpenAPI REST management plane authenticated with HTTP Basic using Key ID and Key secret. It creates and manages organizations and services. It is not the SQL query contract. Each Cloud API key is limited to 10 requests in a 10-second window. Official language clients include JavaScript, Python, Go, and Java. Official CLIs are clickhouse-client, with interactive and batch --query modes over the native protocol, and clickhousectl, which runs local and Cloud queries and can emit JSON. First-party MCP exists in two forms. ClickHouse/mcp-clickhouse is the official open-source server with run_query, list_databases, and list_tables; writes are off unless CLICKHOUSE_ALLOW_WRITE_ACCESS is enabled. ClickHouse Cloud documents a managed remote MCP server at https://mcp.clickhouse.cloud/mcp. It must be enabled per service, authenticates with OAuth 2.0, and exposes 13 read-only tools spanning SELECT, schema, services, backups, ClickPipes, and billing. Zapier, Make, Power Automate, and n8n listings were not opened. Computer-use viability is unassessed. API, MCP, and CLI all score 8; API is the best path because Cloud remote MCP is read-only and off until enabled per service, and the open-source MCP runs as a local process.\n"
 }
}