mcpField
T
ToolChat

ToolChat

Local
github.com/rectalogicAI & Agents0Updated 82w ago
Repository

About ToolChat

ToolChat is a command-line chat client for using LLMs with MCP servers. It configures tool servers through YAML, lets users enable selected servers, and can include images or documents when the model supports multimodal input.

Key features

  1. 01Chat with LLMs using MCP tools
  2. 02Configure tool servers in YAML
  3. 03Enable selected tool servers
  4. 04Include images and documents for multimodal models
  5. 05Use built-in help and chat commands

Use cases

  1. 01Search documentation through an MCP server
  2. 02Ask an LLM to summarize retrieved documents
  3. 03Provide images or documents in a chat prompt

MCP support

Connects to MCP tool servers configured in YAML and makes enabled server tools available during LLM chats.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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]

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.