---
title: thv vmcp init
hide_title: true
description: Reference for ToolHive CLI command `thv vmcp init`
last_update:
  author: autogenerated
slug: thv_vmcp_init
mdx:
  format: md
---

## thv vmcp init

Generate a starter vMCP configuration file

### Synopsis

Discover running workloads in a ToolHive group and generate a starter
vMCP YAML configuration file pre-populated with one backend entry per
accessible workload.

The generated file can be reviewed and customized, then passed to
'thv vmcp validate --config' to check it and 'thv vmcp serve --config'
to start the aggregated server.

If neither --output nor --config is provided, the generated YAML is written to stdout.

```
thv vmcp init [flags]
```

### Options

```
  -c, --config string   Output file path for the generated config; alias for --output
  -g, --group string    ToolHive group name to discover workloads from (required)
  -h, --help            help for init
  -o, --output string   Output file path for the generated config (default: stdout)
```

### Options inherited from parent commands

```
      --debug   Enable debug mode
```

### SEE ALSO

* [thv vmcp](thv_vmcp.md)	 - Run and manage a Virtual MCP Server locally

