toolchat
PydanticAI LLM chat with MCP server tools
Documentation
ToolChat
Chat with LLMs using MCP servers.
Configure MCP tool servers in a YAML file and provide path to `--tool-servers`,
enable specific tools with `--enable-tool-server`.
See sample-tools.yml for format.
If the model is multimodal you can also include images, documents etc. in your prompt.
See the `/help` command for details.
Example
Use AWS documentation tool with Gemini Pro 2.5 to search AWS docs:
$ uv run toolchat --model google-gla:gemini-2.5-pro-exp-03-25 --tool-servers sample-tools.yml --enable-tool-server awslabs.aws-documentation-mcp-server
ToolChat - Ctrl-D or /quit to quit
Enter /multi to enter and exit multiline mode, /help for more commands
> look up documentation on S3 bucket naming rule. cite your sources
Okay, I can help with that. I will search for the S3 bucket naming rules
documentation and provide a summary along with the source URL._`Tool search_documentation {'search_phrase': 'S3 bucket naming rules', 'limit':
1}`_
Okay, I found a relevant document. I will now read the content to summarize the
S3 bucket naming rules._`Tool read_documentation {'url':
'https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html'}`_
Okay, here is a summary of the naming rules for Amazon S3 general purpose
buckets, based on the official AWS documentation:
S3 General Purpose Bucket Naming Rules:
• Length: Must be between 3 and 63 characters long.
• Characters: Can only contain lowercase letters (a-z), numbers (0-9), periods
(.), and hyphens (-).
• Start/End: Must begin and end with a letter or number.
...[elided]Frequently asked questions
What is toolchat?
toolchat is PydanticAI LLM chat with MCP server tools
How do I install toolchat?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is toolchat open source?
Yes — it is hosted on GitHub at https://github.com/rectalogic/toolchat.
Related MCP tools
🙌 OpenHands: Code Less, Make More for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.
Universal memory layer for AI Agents; Announcing OpenMemory MCP - local and secure memory management. Python-based implementation.
基于大模型搭建的聊天机器人,同时支持 微信公众号、企业微信应用、飞书、钉钉 等接入,可选择ChatGPT/Claude/DeepSeek/文心一言/讯飞星火/通义千问/ Gemini/GLM-4/Kimi/LinkAI,能处理文本、语音和图片,访问操作系统和互联网,支持基于自有知识库进行定制企业智能客服。
An LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to
🚀 The fast, Pythonic way to build MCP servers and clients Trusted by 19900+ developers. Trusted by 19900+ developers. Trusted by 19900+ developers.
🔥 MaxKB is an open-source platform for building enterprise-grade agents. MaxKB 是强大易用的开源企业级智能体平台。 for the Model Context Protocol. Enhance AI assistants with po
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP