simonw/llm-mcp-client

Access tools from MCP servers as LLM tools

About llm-mcp-client

Access tools from MCP servers as LLM tools

Install this plugin in the same environment as LLM.

This plugin registers a toolbox called MCP which connects to an MCP server, discovers the tools it exposes and makes them available as LLM tools.

Pass the URL of an MCP server to the toolbox:

The --td option shows details of the tool calls as they execute.

You can save an MCP to a named LLM template like this:

Now you can query it without specifying the full tool definition like this:

By default the client negotiates the protocol automatically. You can force a specific mode with the mode= argument:

If you are using tools from more than one server and their names might clash, give each server a prefix:

Tool results containing MCP image or audio content are returned to the model as LLM attachments. An MCP error result raises llmmcpclient.MCPToolError, which LLM passes back to the model as an error message.

To set up this plugin locally, first checkout the code. Then run the tests with uv:

To run LLM with your in-development plugin:

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/simonw--llm-mcp-client.html)

Related MCP servers