---
title: thv-registry-api serve
hide_title: true
description: Reference for ToolHive Registry API CLI command `thv-registry-api serve`
last_update:
  author: autogenerated
slug: thv-registry-api_serve
mdx:
  format: md
---

## thv-registry-api serve

Start the registry API server

### Synopsis

Start the registry API server to serve MCP registry data.

The server requires a configuration file (--config) that specifies:
- Registry name and data sources (Git, API, File, Managed, or Kubernetes)
- Sync policy and filtering rules (per registry)
- Authentication configuration
- All other operational settings

Database configuration is required. Migrations run automatically on startup.

See examples/ directory for sample configurations.

```
thv-registry-api serve [flags]
```

### Options

```
      --address string            Address to listen on (default ":8080")
      --auth-mode string          Override auth mode from config (anonymous or oauth)
      --config string             Path to configuration file (YAML format, required)
  -h, --help                      help for serve
      --internal-address string   Address to listen on for internal endpoints (health, readiness, version) (default ":8081")
```

### Options inherited from parent commands

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

### SEE ALSO

* [thv-registry-api](thv-registry-api.md)	 - ToolHive Registry API server

