{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_74fat84hrt2e","handle":"clickhouse-mcp-agent","url":"https://wellknown.network/agents/clickhouse-mcp-agent","links":{"self":"https://wellknown.network/agents/clickhouse-mcp-agent/record.json","html":"https://wellknown.network/agents/clickhouse-mcp-agent","markdown":"https://wellknown.network/agents/clickhouse-mcp-agent/record.md","api":"https://wellknown.network/api/v1/agents/clickhouse-mcp-agent","status":"https://wellknown.network/api/v1/agents/clickhouse-mcp-agent/status","claim":"https://wellknown.network/agents/clickhouse-mcp-agent/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/clickhouse-mcp-agent/claim.json","badge":"https://wellknown.network/agents/clickhouse-mcp-agent/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/clickhouse-mcp-agent/history","tools":"https://wellknown.network/api/v1/agents/clickhouse-mcp-agent/tools"},"ard":{"identifier":"urn:air::server:clickhouse-mcp-agent","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"clickhouse-mcp-agent","summary":"AI agent for ClickHouse database analysis via MCP","description":"# ClickHouse MCP Agent\n\n[![PyPI](https://img.shields.io/pypi/v/clickhouse-mcp-agent)](https://pypi.org/project/clickhouse-mcp-agent/)\n[![pydantic-ai-slim](https://img.shields.io/badge/pydantic--ai--slim-1.96.1-blue)](https://pypi.org/project/pydantic-ai-slim/)\n[![mcp-clickhouse](https://img.shields.io/badge/mcp--clickhouse-0.4.0-blue)](https://pypi.org/project/mcp-clickhouse/)\n\nAI agent for ClickHouse database analysis via MCP (Model Context Protocol).\n\nA single MCP server (`mcp-clickhouse`) driven by a single agent instance. You can scope what the agent discovers per call with allow-lists (`allowed_tables`, `allowed_databases`). See [Security](#security) for what they do and do not restrict.\n\n## Features\n\n- Query ClickHouse databases using natural language with AI models\n- Structured output: `analysis`, `confidence`, `sql_used`\n- Easy connection management (predefined or custom)\n- Conversational context with message-history pruning/summarization\n- No CLI or external .env required — configure at runtime\n- Per-call discovery scoping via allow-lists (`allowed_tables`, `allowed_databases`)\n- Read-only queries by default (enforced by `mcp-clickhouse`)\n- Streamable results via `run_stream()`\n- Persistent MCP server mode via `async with ClickHouseAgent()`\n- Parallel queries via `run_batch()`\n- Lifecycle reset via `reset()`\n- Query result cache via `enable_cache=True`\n- Typed exception hierarchy for reliable error handling\n- Optional `structlog` integration (`pip install \".[logging]\"`)\n\n### Supported Providers\n\n| Provider | Key env var | Notes |\n|---|---|---|\n| Google Gemini | `GOOGLE_API_KEY` | Default |\n| OpenAI | `OPENAI_API_KEY` | |\n| Anthropic | `ANTHROPIC_API_KEY` | |\n| Grok (xAI) | `XAI_API_KEY` | Model prefix `xai:` (e.g. `xai:grok-4`) |\n| Groq | `GROQ_API_KEY` | Fast open models (e.g. `groq:llama-3.3-70b-versatile`), free tier |\n| Mistral | `MISTRAL_API_KEY` | |\n| Cohere | `CO_API_KEY` | |\n\n## Local Development (Docker)\n\nThe fastest way to get started — no cloud …","publisher":null,"homepage":"https://github.com/AranNomante/clickhousemcp","repository":"https://github.com/AranNomante/clickhousemcp","version":"0.12.1","license":"MIT","protocols":["mcp"],"tags":["clickhouse","mcp","ai","database","analysis"],"pricing":null,"endpoints":[{"url":"pypi:clickhouse-mcp-agent","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"clickhouse-mcp-agent","registry":"pypi","observedAt":"2026-11-09T01:27:43.690Z","publishedAt":"2026-10-28T22:31:33.468451Z","latestVersion":"0.12.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"clickhouse-mcp-agent","url":"https://pypi.org/project/clickhouse-mcp-agent/","firstSeenAt":"2026-09-09T11:31:00.010Z","fetchedAt":"2026-11-09T01:27:05.573Z","normalizedAt":"2026-11-09T01:27:05.573Z"}]},"firstSeenAt":"2026-09-09T11:31:00.010Z","updatedAt":"2026-11-09T01:27:43.690Z"}