Skip to main content

Using the ToolHive CLI

Introduction​

The ToolHive CLI (thv) gives you a fast, repeatable way to run and manage MCP servers from the terminal. Use it when you want to script server setup, control permissions precisely, work in development environments, or automate ToolHive workflows in shell scripts and CI.

Within the ToolHive platform, the CLI gives you direct access to the same local runtime, built-in registry, and client-configuration workflows that power the UI. If you want a terminal-first way to run ToolHive locally or embed it in automation, start here.

The CLI can also connect your local workflows and AI clients to the broader ToolHive platform. You can use it with MCP servers or gateways managed by the Kubernetes Operator, and point local workflows at a ToolHive Registry Server.

Using ToolHive UI?

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.

Where to start​

  • New to ToolHive CLI? Follow the Quickstart to install thv and run your first MCP server in minutes.
  • Already installed? Jump to Run MCP servers to start managing servers from the command line.
  • Want to browse the default catalog? See Use the registry.
  • Managing agent skills? See Manage agent skills to install and publish reusable skills.
  • Building or automating? See advanced workflows for auth, CI/CD, container builds, and more.

Contents​