Using the ToolHive CLI
Introduction
The ToolHive CLI (thv) is a command-line tool that allows you to deploy and
manage MCP servers on your local machine or in development environments. It
provides quick deployment of MCP servers and supports advanced features like
custom permissions, network access filtering, and telemetry.
It's designed for developers who prefer working in a terminal or need to integrate MCP server management into scripts or automation workflows.
ToolHive UI includes and manages the CLI automatically. You don't need to install the CLI separately. See CLI conflict resolution if you have both installed.
Contents
📄️ Quickstart
A step-by-step guide to installing the ToolHive CLI and running your first MCP server.
📄️ Install ToolHive
How to install, upgrade, and manage the ToolHive CLI.
📄️ Explore the registry
How to use the built-in registry to find MCP servers.
🗃️ Run MCP servers
How to run MCP servers with the ToolHive CLI
📄️ Client configuration
How to configure AI agent clients to work with ToolHive MCP servers.
🗃️ Permissions and security
How to configure filesystem and network access for MCP servers
🗃️ Advanced workflows
Build, test, secure, and automate
🗃️ Command reference
Detailed reference for ToolHive CLI commands