thv_list.md

June 17, 2026 · View on GitHub

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 running and auth_retrying)
      --check-upgrades      Check each workload for available upgrades against its source registry (performs a registry lookup)
      --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