| title | thv-registry-api serve | ||
|---|---|---|---|
| hide_title | true | ||
| description | Reference for ToolHive Registry API CLI command `thv-registry-api serve` | ||
| last_update |
|
||
| slug | thv-registry-api_serve | ||
| mdx |
|
Start the registry API server
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]
--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")
--debug Enable debug mode
- thv-registry-api - ToolHive Registry API server