ToolChat
PydanticAI LLM chat with MCP server tools
rectalogic
README
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]
Recommended Servers
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Apple MCP Server
Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
@kazuph/mcp-gmail-gas
Model Context Protocol server for Gmail integration. This allows Claude Desktop (or any MCP client) to interact with your Gmail account through Google Apps Script.
MCP Server Trello
Facilitates interaction with Trello boards via the Trello API, offering features like rate limiting, type safety, input validation, and error handling for seamless management of cards, lists, and board activities.
Linear MCP Server
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.
Composio MCP Server
A server implementation that provides MCP-compatible access to Composio applications like Gmail and Linear, allowing interaction through a structured interface for language models.
Folderr
A Model Context Protocol (MCP) server that provides tools to interact with Folderr's API, specifically for managing and communicating with Folderr Assistants.
mcp-google
A specialized Model Context Protocol (MCP) server that integrates Google services (Gmail, Calendar, etc.) into your AI workflows. This server enables seamless access to Google services through MCP, allowing AI agents to interact with Gmail, Google Calendar, and other Google services.
MCP-JIRA-Python Server
A Python-based server allowing seamless integration with JIRA for managing and interacting with projects through custom APIs.
Email Sending MCP
Send emails directly from Cursor with this email sending MCP server