Skip to main content

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, or mcpservers) (default "text")
      --group string        Filter workloads 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