Skip to main content
Skip to main content
Edit this page

How to build a PydanticAI agent using ClickHouse MCP Server

In this guide, you'll learn how to build a PydanticAI agent that can interact with ClickHouse's SQL playground using ClickHouse's MCP Server.

Example notebook

This example can be found as a notebook in the examples repository.

Prerequisites​

  • You'll need to have Python installed on your system.
  • You'll need to have pip installed on your system.
  • You'll need an Anthropic API key, or API key from another LLM provider

You can run the following steps either from your Python REPL or via script.

Install libraries​

Install the required library by running the following commands:

Setup credentials​

Next, you'll need to provide your Anthropic API key:

Using another LLM provider

If you don't have an Anthropic API key, and want to use another LLM provider, you can find the instructions for setting up your credentials in the PydanticAI docs

Next, define the credentials needed to connect to the ClickHouse SQL playground:

Initialize MCP Server and PydanticAI agent​

Now configure the ClickHouse MCP Server to point at the ClickHouse SQL playground:

Ask the agent a question​

Finally, you can ask the agent a question:

You'll get back a similar response as below: