thv_list.md

title	thv list
hide_title	true
description	Reference for ToolHive CLI command `thv list`
last_update	author autogenerated
slug	thv_list
mdx	format md

thv list

List running MCP servers

Synopsis

List all MCP servers managed by ToolHive, including their status and configuration.

Examples:

List running MCP servers

thv list

List all MCP servers (including stopped)

thv list --all

List servers in JSON format

thv list --format json

List servers in a specific group

thv list --group production

List servers with specific labels

thv list --label env=dev --label team=backend

thv list [flags]

Options

  -a, --all                 Show all workloads (default shows just running)
      --format string       Output format (json, text, mcpservers) (default "text")
      --group string        Filter by group
  -h, --help                help for list
  -l, --label stringArray   Filter workloads by labels (format: key=value)

Options inherited from parent commands

      --debug   Enable debug mode

SEE ALSO

• thv - ToolHive (thv) is a lightweight, secure, and fast manager for MCP servers