---
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](thv.md)	 - ToolHive (thv) is a lightweight, secure, and fast manager for MCP servers

